evmeventformat.3 (2010 09)

EvmEventFormat(3) EvmEventFormat(3)

Any token of the form @item_name

[%width] or @{item_name[%width]} is replaced by the value of the

corresponding data item from the supplied event, if it is present. item_name is the name of the item

stored in the event. If width is supplied, the value occupies a minimum of width character positions.

width is an integer number specifying the size of the value stored in item_name . The item_name is the

name of a standard event data item. The special string

@@ is replaced by the results of applying

EvmEventFormat()

to the event.

Refer to evmshow (1) and EvmEvent (5) for more information about formatting events for display.

EvmVarFormat()

retrieves a variable called var_name from the supplied event, and returns a format-

ted version of its value in buffer.

If translate is

EvmTRUE, I18N translation is applied as appropriate.

Notes

Floating point values are formatted using the

printf() %.8g

format speciﬁer.

RETURN VALUE

EvmERROR_NONE

The operation completed without error.

EvmERROR_INVALID_ARGUMENT

One of the arguments to the function is invalid.

EvmERROR_INVALID_VALUE

A value in a structure member is invalid.

EvmERROR_NO_MEMORY

An operation failed because an attempt to acquire heap memory

failed.

ERRORS

The value of

errno is not set.