Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > E

EvmEventNameMatch(3)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

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 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 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 successful. 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 pattern 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).

Event Management

EVM(5).

EVM Events

EvmEvent(5).

EVM Programmer's Guide.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.