sf_parser_list
==============

Synopsis
--------

*#include <sfparse.h>*

.. function:: 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 :macro:`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:
    
    :macro:`SF_ERR_EOF`
        All values in the list have read.
    :macro:`SF_ERR_PARSE_ERROR`
        It encountered fatal error while parsing field value.