matcheditor(3i) [debian man page]

MatchEditor(3I) 					    InterViews Reference Manual 					   MatchEditor(3I)

NAME

       MatchEditor - StringEditor with pattern matching

SYNOPSIS

       #include <InterViews/matcheditor.h>

DESCRIPTION

       MatchEditor  is	a StringEditor subclass that checks the validity of its contents against a specified pattern.  It is suitable for entering
       strings that must conform to a particular format such as a number or a file name.  The matching pattern is specified according to the rules
       of  scanf(3).   For  example, a pattern of "%3d" will match a 3-digit integer, a pattern of "%[ab]" will match a string containing only a's
       and b's, and a pattern of "(%f, %f)" will match the string "(12.0, 5E23)".

PUBLIC OPERATIONS

       MatchEditor(ButtonState*, const char* sample, const char* done)
	      Create a new MatchEditor object.	The ButtonState, sample string, and termination string are passed to the StringEditor constructor.

       void Match(const char* pattern, boolean keystroke = true)
	      Specify the pattern to match against.  When MatchEditor performs matching, it will highlight any trailing part of  the  edit  string
	      that  does  not  conform to pattern.  The user can then correct the string.  If keystroke is true, matching will occur on every key-
	      stroke; otherwise matching will only occur on the completion of the edit.  The initial pattern matches any string, and  the  initial
	      value of keystroke is true.

RESTRICTIONS

       MatchEditor  uses  sscanf  internally to check the pattern match.  Different versions of sscanf have different scanning capabilities; check
       with your local version to see what patterns you can use.

SEE ALSO

       StringEditor(3I)

InterViews							    7 Dec 1989							   MatchEditor(3I)

EvmEventNameMatch(3)					     Library Functions Manual					      EvmEventNameMatch(3)

NAME

       EvmEventNameMatch(), EvmEventNameMatchStr() - match EVM event name

SYNOPSIS

   Library
       EVM Support Library

   Parameters
       pattern	     The  event name pattern sought.  The pattern may be any valid event name string.  It may include wildcard characters in place
		     of any component.

       event	     The event containing the event name to be compared against the pattern.

       match	     The result of the match. This operand is set to if the name matches the pattern, and to if it does not.

       candidate     A character string to be matched against the pattern

DESCRIPTION

       Because special matching rules apply when deciding whether a candidate event name matches a known name, the  EVM  name  matching  functions
       should  be  used  for matching purposes, rather than the C string comparison functions The EVM functions match an event name against a sup-
       plied pattern, ignoring any trailing appended components in the candidate name, and correctly matching wildcard characters.

       The function takes an event and an event name pattern as input, and returns an indication of  whether  the  event  contains  a  name  which
       matches the pattern in the match output argument.  The pattern may be any valid event name string, and may also include wildcard characters
       in place of any component.  A wildcard in the pattern matches zero or more name components.  A matches  exactly	one  component.   A  match
       occurs if the event name matches all components indicated by the pattern, even if the name has additional trailing elements.

       The function performs the same check as but takes a character string as the candidate event name, instead of extracting the candidate event
       name from a supplied event.

       Both functions set the match output argument to if the name matches the pattern, and to if it does not.

RETURN VALUE

       The operation completed without error.  The comparison was successful.  The value of the match operand indicates whether the  name  matches
       the pattern.

       One of the arguments to the function is invalid.
	      The supplied pattern contains invalid characters.

       The supplied event does not contain a name.

ERRORS

       The value of is not set.

SEE ALSO

   Routines
       memccpy(3C), strcat(3C).

   Event Management
       EVM(5).

   EVM Events
       EvmEvent(5).

															      EvmEventNameMatch(3)