sf_parser_item
==============

Synopsis
--------

*#include <sfparse.h>*

.. function:: int sf_parser_item(sf_parser *sfp, sf_value *dest)

    
    `sf_parser_item` reads a single item.  If this function returns 0,
    it stores the item in *dest* if it is not NULL.
    
    This function is only used for the field value that consists of a
    single item.
    
    Caller can optionally read parameters attached to the item by
    calling `sf_parser_param`.
    
    Caller should call this function again to make sure that there is
    nothing left to read.  If this 2nd function call returns
    :macro:`SF_ERR_EOF`, all data have been processed successfully.
    
    This function returns 0 if it succeeds, or one of the following
    negative error codes:
    
    :macro:`SF_ERR_EOF`
        There is nothing left to read.
    :macro:`SF_ERR_PARSE_ERROR`
        It encountered fatal error while parsing field value.