pps_decoder_parse_pps_str()

Updated: April 19, 2023

Parse a string of PPS-formatted data

Synopsis:

#include <sys/pps.h>
            
pps_decoder_error_t pps_decoder_parse_pps_str(
                                    pps_decoder_t *decoder, 
                                    char *str);

Arguments:

decoder
A pointer to the PPS decoder structure.
str
A pointer to a null-terminated string containing PPS data.

Library:

libpps

Description:

The function pps_decoder_parse_pps_str() parses a string of PPS-formatted data into the decoder's internal data structures.

This function modifies the buffer that is passed in the str argument; the internal decoder structure makes use of pointers into this buffer. Consequently, the contents of the buffer must remain valid and unchanged until the results of parsing are no longer needed.

This function supports a number of PPS attribute encodings including the null encoding, c for C strings, b for Booleans, n for numbers, and json for JSON. The str argument must contain a null-terminated string.

Returns:

PPS_DECODER_OK
Success.
>=1
An error occurred. See pps_decoder_error_t.

Classification:

QNX Neutrino

Safety:  
Interrupt handler No
Signal handler No
Thread Yes