|  |  |  | Redland RDF Application Framework Manual |  | 
|---|---|---|---|---|
typedef librdf_parser; typedef librdf_parser_factory; int librdf_parser_enumerate (librdf_world *world, unsigned int counter, const char **name, const char **label); void librdf_parser_register_factory (librdf_world *world, const char *name, const char *label, const char *mime_type, unsigned char *uri_string, void (*factory) (librdf_parser_factory*)); librdf_parser* librdf_new_parser (librdf_world *world, const char *name, const char *mime_type, librdf_uri *type_uri); librdf_parser* librdf_new_parser_from_factory (librdf_world *world, librdf_parser_factory *factory); void librdf_free_parser (librdf_parser *parser); librdf_stream* librdf_parser_parse_as_stream (librdf_parser *parser, librdf_uri *uri, librdf_uri *base_uri); int librdf_parser_parse_into_model (librdf_parser *parser, librdf_uri *uri, librdf_uri *base_uri, librdf_model *model); librdf_stream* librdf_parser_parse_string_as_stream (librdf_parser *parser, unsigned char *string, librdf_uri *base_uri); int librdf_parser_parse_string_into_model (librdf_parser *parser, unsigned char *string, librdf_uri *base_uri, librdf_model *model); void librdf_parser_set_error (librdf_parser *parser, void *user_data, void (*error_fn) (void *user_data, const char *msg, ...)); void librdf_parser_set_warning (librdf_parser *parser, void *user_data, void (*warning_fn) (void *user_data, const char *msg, ...)); librdf_stream* librdf_parser_parse_counted_string_as_stream (librdf_parser *parser, unsigned char *string, size_t length, librdf_uri *base_uri); int librdf_parser_parse_counted_string_into_model (librdf_parser *parser, unsigned char *string, size_t length, librdf_uri *base_uri, librdf_model *model); #define LIBRDF_PARSER_FEATURE_ERROR_COUNT #define LIBRDF_PARSER_FEATURE_WARNING_COUNT librdf_node* librdf_parser_get_feature (librdf_parser *parser, librdf_uri *feature); int librdf_parser_set_feature (librdf_parser *parser, librdf_uri *feature, librdf_node *value); char* librdf_parser_get_accept_header (librdf_parser *parser);
Provides classes to create parsers and parse syntaxes from URIs or a string into RDF graphs (librdf_model) or sequences of triples (librdf_stream). Parser features can be set, which are passed down to Raptor and errors and warnings that are returned can be retrieved by callbacks.
typedef struct librdf_parser_factory_s librdf_parser_factory;
Redland parser factory class.
int librdf_parser_enumerate (librdf_world *world, unsigned int counter, const char **name, const char **label);
Get information on parsers.
| world: | redland world object | 
| counter: | index into the list of parsers | 
| name: | pointer to store the name of the parser (or NULL) | 
| label: | pointer to store syntax readable label (or NULL) | 
| Returns : | non 0 on failure of if counter is out of range | 
void librdf_parser_register_factory (librdf_world *world, const char *name, const char *label, const char *mime_type, unsigned char *uri_string, void (*factory) (librdf_parser_factory*));
Register a parser factory .
| world: | redland world object | 
| name: | the name of the parser | 
| label: | the label of the parser (optional) | 
| mime_type: | MIME type of the syntax (optional) | 
| uri_string: | URI of the syntax (optional) | 
| factory: | function to be called to register the factor parameters | 
librdf_parser* librdf_new_parser (librdf_world *world, const char *name, const char *mime_type, librdf_uri *type_uri);
Constructor - create a new librdf_parser object.
If all fields are NULL, this means any parser supporting MIME Type "application/rdf+xml"
| world: | redland world object | 
| name: | the parser factory name | 
| mime_type: | the MIME type of the syntax (NULL if not used) | 
| type_uri: | URI of syntax (NULL if not used) | 
| Returns : | new librdf_parser object or NULL | 
librdf_parser* librdf_new_parser_from_factory (librdf_world *world, librdf_parser_factory *factory);
Constructor - create a new librdf_parser object.
| world: | redland world object | 
| factory: | the parser factory to use to create this parser | 
| Returns : | new librdf_parser object or NULL | 
void librdf_free_parser (librdf_parser *parser);
Destructor - destroys a librdf_parser object.
| parser: | the parser | 
librdf_stream* librdf_parser_parse_as_stream (librdf_parser *parser, librdf_uri *uri, librdf_uri *base_uri);
Parse a URI to a librdf_stream of statements.
| parser: | the parser | 
| uri: | the URI to read | 
| base_uri: | the base URI to use or NULL | 
| Returns : | librdf_stream of statements or NULL | 
int librdf_parser_parse_into_model (librdf_parser *parser, librdf_uri *uri, librdf_uri *base_uri, librdf_model *model);
Parse a URI of content into an librdf_model.
| parser: | the parser | 
| uri: | the URI to read the content | 
| base_uri: | the base URI to use or NULL | 
| model: | the model to use | 
| Returns : | non 0 on failure | 
librdf_stream* librdf_parser_parse_string_as_stream (librdf_parser *parser, unsigned char *string, librdf_uri *base_uri);
Parse a string of content to a librdf_stream of statements.
| parser: | the parser | 
| string: | the string to parse | 
| base_uri: | the base URI to use or NULL | 
| Returns : | librdf_stream of statements or NULL | 
int         librdf_parser_parse_string_into_model
                                            (librdf_parser *parser,
                                             unsigned char *string,
                                             librdf_uri *base_uri,
                                             librdf_model *model);
Parse a string of content into an librdf_model.
| parser: | the parser | 
| string: | the content to parse | 
| base_uri: | the base URI to use or NULL | 
| model: | the model to use | 
| Returns : | non 0 on failure | 
void librdf_parser_set_error (librdf_parser *parser, void *user_data, void (*error_fn) (void *user_data, const char *msg, ...));
Deprecated: Does nothing
Set the parser error handling function.
| parser: | the parser | 
| user_data: | user data to pass to function | 
| error_fn: | pointer to the function | 
void librdf_parser_set_warning (librdf_parser *parser, void *user_data, void (*warning_fn) (void *user_data, const char *msg, ...));
Deprecated: Does nothing.
Set the parser warning handling function.
| parser: | the parser | 
| user_data: | user data to pass to function | 
| warning_fn: | pointer to the function | 
librdf_stream* librdf_parser_parse_counted_string_as_stream (librdf_parser *parser, unsigned char *string, size_t length, librdf_uri *base_uri);
Parse a counted string of content to a librdf_stream of statements.
| parser: | the parser | 
| string: | the string to parse | 
| length: | length of the string content (must be >0) | 
| base_uri: | the base URI to use or NULL | 
| Returns : | librdf_stream of statements or NULL | 
int         librdf_parser_parse_counted_string_into_model
                                            (librdf_parser *parser,
                                             unsigned char *string,
                                             size_t length,
                                             librdf_uri *base_uri,
                                             librdf_model *model);
Parse a counted string of content into an librdf_model.
| parser: | the parser | 
| string: | the content to parse | 
| length: | length of content (must be >0) | 
| base_uri: | the base URI to use or NULL | 
| model: | the model to use | 
| Returns : | non 0 on failure | 
#define LIBRDF_PARSER_FEATURE_ERROR_COUNT "http://feature.librdf.org/parser-error-count"
Parser feature URI string for getting the error count of the last parse.
#define LIBRDF_PARSER_FEATURE_WARNING_COUNT "http://feature.librdf.org/parser-warning-count"
Parser feature URI string for getting the warning count of the last parse.
librdf_node* librdf_parser_get_feature (librdf_parser *parser, librdf_uri *feature);
Get the value of a parser feature.
| parser: | librdf_parser object | 
| feature: | librdf_Uuri feature property | 
| Returns : | new librdf_node feature value or NULL if no such feature exists or the value is empty. | 
int librdf_parser_set_feature (librdf_parser *parser, librdf_uri *feature, librdf_node *value);
Set the value of a parser feature.
| parser: | librdf_parser object | 
| feature: | librdf_uri feature property | 
| value: | librdf_node feature property value | 
| Returns : | non 0 on failure (negative if no such feature) | 
char* librdf_parser_get_accept_header (librdf_parser *parser);
Get an HTTP Accept value for the parser.
The returned string must be freed by the caller such as with
raptor_free_memory().
| parser: | parser | 
| Returns : | a new Accept: header string or NULL on failure |