volksdata/include/volksdata/codec/parser_nt.h

#ifndef _VOLK_NT_PARSER_H
#define _VOLK_NT_PARSER_H

#include "volksdata/codec.h"


/** @brief Parse a single term.
 *
 * @param[in] rep N-Triples representation as a character string.
 *
 * @param[out] term Term to be created from the string.
 *
 * @return VOLK_OK on success, VOLK_VALUE_ERR if the string is not valid
 *  N-Triples syntax for a IRI ref, Literal or BNode.
 */
VOLK_rc
VOLK_nt_parse_term (const char *rep, VOLK_Term **term);


/** @brief Parse a N-Triples document from a file handle.
 *
 * @param[in] stream N-Triples doc file handler.
 *
 * @param[out] gr Pointer to a graph handle to be created. The new graph will
 * have a random UUID URN.
 *
 * @param[out] ct If not NULL it is populated with the number of triples
 *  parsed. This may be more than the triples in the resulting graph.
 *
 * @param[out] err String handle to be populated with an error message.
 *
 * @return VOLK_OK on success, VOLK_VALUE_ERR if a parsing error was
 *  encountered. On error, `err` will contain the error message.
 */
VOLK_rc
VOLK_nt_parse_doc (
        FILE *fh, const char *sh, VOLK_Graph **gr, size_t *ct, char **err);

#endif