home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 339.lha / SerMod / Docs / MATCH.doc < prev    next >
Text File  |  1990-02-08  |  1KB  |  52 lines
  1.  
  2. NAME:        MATCH
  3.  
  4. SYNTAX:    MATCH <n> 'String'
  5.             MATCH <n>
  6.             MATCH CLEAR
  7.  
  8. DESCRIPTION:
  9.  
  10.      This command tells the serial module to watch for a pattern
  11.      coming in on the receive line. The pattern will be matched
  12.      exactly    as given by the 'String' argument. The 'String' argument
  13.      will be case sensitive, and if quotes are not used, the match
  14.      will be on an upper case representation of the string only.
  15.  
  16.      When a string is matched, a message will be sent to the
  17.      CTRL port. It will have the form:  MATCH <n>
  18.  
  19.      The MATCH, when used with a number only and no string, will clear
  20.      only that MATCH number.
  21.  
  22.      The CLEAR operand will clear all the patterns currently in
  23.      memory.
  24.  
  25. NOTES:
  26.  
  27.     It is possible to match on a string that spans more than one line
  28.     by including the <CR> or linefeed character in the string passed
  29.     as a pattern.
  30.  
  31.     In order for a script to be signalled when a match occurs, you
  32.     must have previously issued a 'SCAN ON' command. To disable the
  33.     matching, issue a SCAN OFF command.
  34.  
  35. EXAMPLE:
  36.  
  37.        MATCH 0 'Hello'
  38.        MATCH 1 'CONNECT' || '0a'x
  39.        MATCH 2  hello
  40.        MATCH 2
  41.        MATCH CLEAR
  42.  
  43.     In the above examples, the following strings will be matched:
  44.  
  45.       Hello
  46.       CONNECT<LF>  (the linefeed character was concatenated to the pattern)
  47.       HELLO        (the string was not quoted)
  48.       none...      the MATCH for 2 was cleared
  49.       none...      all matches were cleared
  50.  
  51. SEE ALSO:  SCAN, STATUS
  52.