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.
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 |