sf_parser_list

Synopsis

#include <sfparse.h>

int sf_parser_list(sf_parser *sfp, sf_value *dest)

sf_parser_list() reads the next list item. If this function returns 0, it stores the item in dest if it is not NULL.

Caller can optionally read parameters attached to the item by calling sf_parser_param().

Caller should keep calling this function until it returns negative error code. If it returns SF_ERR_EOF, all values in the list have been read, and there is nothing left to read.

This function returns 0 if it succeeds, or one of the following negative error codes:

SF_ERR_EOF

All values in the list have read.

SF_ERR_PARSE_ERROR

It encountered fatal error while parsing field value.