swirl Guide to OmniMark 5   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesOMX VariablesErrors
 
  Related Syntax   Related Concepts  
operator   matches    

Syntax

  string-expression matches pattern


Purpose

The matches operator provides a general way to test the contents of a string expression by matching it against an OmniMark pattern. When only one pattern is being tried, the most convenient way to do this is often by using matches.

The matches operator takes two operands: the string-expression being scanned and the pattern against which it is matched.

The pattern any** is used when the pattern can appear anywhere in the string; otherwise, the pattern must appear at the beginning of the string-expression for a match to succeed.

Parentheses must be used to enclose the pattern if it consists of more than one component.

If there is more than one pattern to scan, it is often easier and more efficient to use do scan.

Usage example:

  do when attribute codes matches any** (word-start "ok" word-end)
        ...
  done

    Related Syntax
   do scan
 
Related Concepts
   Pattern matching functions
 
----  

Top [ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ OMX ] [ OMX ] [ ERRORS ]

Generated: August 11, 2000 at 3:07:33 pm
If you have any comments about this section of the documentation, send email to docerrors@omnimark.com

Copyright © OmniMark Technologies Corporation, 1988-2000.