Manualshelf

evmeventnamematch.3 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages
12
e
EvmEventNameMatch(3) EvmEventNameMatch(3)
NAME
EvmEventNameMatch(), EvmEventNameMatchStr() - match EVM event name
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 );
Library
EVM Support Library (libevm.so).
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
EvmTRUE if the name matches the pattern,
and to EvmFALSE 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 (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 argu-
ment. 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
EvmEventNameMatchStr
function performs the same check as EvmEventNameMatch, 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
EvmTRUE if the name matches the pattern, and to
EvmFALSE if it does not.
RETURN VALUE
EvmERROR_NONE The operation completed without error. The comparison was suc-
cessful. The value of the match operand indicates whether the
name matches the pattern.
EvmERROR_INVALID_ARGUMENT One of the arguments to the function is invalid. The supplied pat-
tern contains invalid characters.
EvmERROR_NOT_PRESENT The supplied event does not contain a name.
ERRORS
The value of
errno is not set.
SEE ALSO
Routines
memccpy(3C), strcat(3C).
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (2 pages)