mme_metadata_extract_string()

Get the string format from the metadata handle

Synopsis:

#include <mme/metadata.h>

const char *mme_metadata_extract_string( const mme_metadata_hdl_t *metadata,
                                         const char *type,
                                         uint32_t flags );

Arguments:

metadata
The pointer to the handle with the metadata, returned by mme_ms_metadata_get().
type
The type of metadata to extract. See METADATA_*.
flags
For future use.

Library:

metadata

Description:

The function mme_metadata_extract_string() extracts metadata in character string format from the metadata handle mme_metadata_hdl_t.

Events

None delivered.

Blocking and validation

This function validates that the metadata handle isn't NULL. It doesn't block.

Returns:

Data in the character string, or NULL if no data is found (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

METADATA_*, mme_metadata_alloc(), mme_metadata_extract_data(), mme_metadata_extract_unsigned(), mme_metadata_hdl_t, mme_ms_metadata_done(), mme_ms_metadata_get()