pps_Object_read()

Stream data from the PPS object.

Synopsis:

#include <hnm/pps.h>
 
int pps_Object_read(pps_Object *pps_object, char **buffer)

Arguments:

pps_object

A pointer to the structure that represents the PPS object to read data from. This object must be open for the read function to complete successfully.

buffer

An output argument that provides a pointer to the buffer that was created to hold data read from the PPS object. The ownership of the memory referenced by this argument is transferred to the calling context responsible for deleting it.

Library:

libhnm

Description:

Use the pps_Object_read() function to stream data from the PPS object one line at a time. You must call this function consecutively as many times as required to read complete PPS messages that may span more than one line.

Returns:

The number of bytes read from the PPS object.