pps_attrib_t

Updated: October 26, 2022

pps_attrib_t

typedef struct {
    char *obj_name;
    int  obj_index;
    char *attr_name;
    int  attr_index;
    char *encoding;
    char *value;
    int  flags;
    int  options;
    int  option_mask;
    int  quality;
    char *line;
    int  reserved[3];
} pps_attrib_t;

Description:

The pps_attrib_t data structure carries information about PPS objects and attributes obtained by running the ppsparse() function. It includes these members:

Member Type Description
obj_name char * A pointer to the name of the last PPS object encountered. ppsparse() sets this pointer only if it encounters a PPS object name. You should initialize this pointer before calling ppsparse().
obj_index int The index for obj_name in the objnames array. It's set to -1 if the index isn't found or objnames is NULL. You should initialize this value before calling ppsparse().
attr_name char * A pointer to the name of the attribute from the line of PPS data that ppsparse() just parsed. It's set to NULL if no attribute name was found.
attr_index int The index for attr_name in the attrnames array. It's set to -1 if the index isn't found or attrnames is NULL.
encoding char * A pointer to a string that indicates the encoding used for the PPS attribute. This value is relevant only if the ppsparse() return value is PPS_ATTRIBUTE.
value char * A pointer to the value of a PPS attribute. This value is relevant only if the ppsparse() return value is PPS_ATTRIBUTE.
flags int Flags indicating that parsing has found a PPS special character prefixed to a line or that the line is incomplete.
options int Indicates which nonnegated options are prefixed in square brackets to a line.
option_mask int A mask of the options (both negated and nonnegated) prefixed to a line.
quality int Not used.
line char * Pointer to the beginning of the line parsed by ppsparse(), for use in case of a parsing error.
reserved int array For internal use.