EvmEventNameMatch(3)					     Library Functions Manual					      EvmEventNameMatch(3)

NAME

       EvmEventNameMatch, EvmEventNameMatchStr - Match event name

LIBRARY

       EVM Support Library (libevm.so, libevm.a)

SYNOPSIS

       #include <evm/evm.h>

       EvmStatus_t EvmEventNameMatch(
	       const char *pattern,
	       EvmEvent_t event,
	       EvmBoolean_t *match);

       EvmStatus_t EvmEventNameMatchStr(
	       const char *pattern,
	       const char *candidate,
	       EvmBoolean_t *match);

OPERANDS

       The  event name pattern sought.	The pattern may be any valid event name string.  It may include wildcard characters in place of any compo-
       nent.  The event containing the event name to be compared against the pattern.  The result of the match.  This parameter is set to  EvmTRUE
       if the name matches the pattern, and to EvmFALSE if it does not.  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 (memcpm(), strcmp()) .   The  EVM  functions  match	an
       event  name  against  a	supplied pattern, ignoring any trailing appended components in the candidate name, and correctly matching wildcard
       characters.

       The EvmEventNameMatch 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  compo-
       nent.  A match occurs if the event name matches all components indicated by the pattern, even if the name has additional trailing elements.

       The  EvmEventNameMatchStr  function performs the same check as EvmEventNameMatch, but takes a character string as the candidate event name,
       rather than extracting it from a supplied event.

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

RETURN VALUES

       The comparison was successful.  The value of the match parameter indicates whether the name matches the pattern.  The supplied pattern con-
       tains invalid characters.  The supplied event does not contain a name.

ERRORS

       None

FILES

       None

SEE ALSO

       Routines: memccpy(3), strcat(3)

       Event Management: EVM(5)

       EVM Events: EvmEvent(5)

       Programmer's Guide delim off

															      EvmEventNameMatch(3)