pps_decoder_get_string()

Updated: May 06, 2022

Extract a string value from a node

Synopsis:

#include <sys/pps.h>
            
pps_decoder_error_t pps_decoder_get_string(
                                    pps_decoder_t *decoder, 
                                    const char *name, 
                                    const char **value);

Arguments:

decoder
A pointer to the PPS decoder structure.
name
The name of the property to extract the value from. Specify NULL to extract the data from the current node.
value
A pointer to a location where the function can store a pointer to the string. Note that the resulting string is a pointer into the original buffer.

Library:

libpps

Description:

The function pps_decoder_get_string() extracts a string value from the node having the specified name, or if the name argument is NULL, the current node. Following successful extraction, the decoder advances to the next node.

Returns:

PPS_DECODER_OK
Success.
PPS_DECODER_BAD_TYPE
There was a type mismatch.
PPS_DECODER_DELETED
The attribute was deleted.
PPS_DECODER_NOT_FOUND
The specified node doesn't exist.

Classification:

QNX Neutrino

Safety:  
Interrupt handler No
Signal handler No
Thread Yes