raptor2.h [include/raptor2/raptor2.h]

1	/ -- Mode: c; c-basic-offset: 2 --*
2	*
3	* raptor.h - Redland Parser Toolkit for RDF (Raptor) - public API
4	*
5	* Copyright (C) 2000-2013, David Beckett http://www.dajobe.org/
6	* Copyright (C) 2000-2005, University of Bristol, UK http://www.bristol.ac.uk/
7	*
8	* This package is Free Software and part of Redland http://librdf.org/
9	*
10	* It is licensed under the following three licenses as alternatives:
11	* 1. GNU Lesser General Public License (LGPL) V2.1 or any newer version
12	* 2. GNU General Public License (GPL) V2 or any newer version
13	* 3. Apache License, V2.0 or any newer version
14	*
15	* You may not use this file except in compliance with at least one of
16	* the above three licenses.
17	*
18	* See LICENSE.html or LICENSE.txt at the top of this package for the
19	* complete terms and further detail along with the license texts for
20	* the licenses in COPYING.LIB, COPYING and LICENSE-2.0.txt respectively.
21	*
22	*
23	*/
24
25
26
27	#ifndef RAPTOR_H
28	#define RAPTOR_H
29
30
31	#ifdef __cplusplus
32	extern "C" {
33	#endif
34
35	#include <stdio.h>
36
37	/ Required for va_list in raptor_vsnprintf /
38	#include <stdarg.h>
39
40
41	/**
42	* RAPTOR_V2_AVAILABLE
43	*
44	* Flag for marking raptor2 API availability.
45	*/
46	#define RAPTOR_V2_AVAILABLE 1
47
48
49	/**
50	* RAPTOR_VERSION:
51	*
52	* Raptor library version number
53	*
54	* Format: major * 10000 + minor * 100 + release
55	*/
56	#define RAPTOR_VERSION 20013
57
58	/**
59	* RAPTOR_VERSION_STRING:
60	*
61	* Raptor library version string
62	*/
63	#define RAPTOR_VERSION_STRING "2.0.13"
64
65	/**
66	* RAPTOR_VERSION_MAJOR:
67	*
68	* Raptor library major version
69	*/
70	#define RAPTOR_VERSION_MAJOR 2
71
72	/**
73	* RAPTOR_VERSION_MINOR:
74	*
75	* Raptor library minor version
76	*/
77	#define RAPTOR_VERSION_MINOR 0
78
79	/**
80	* RAPTOR_VERSION_RELEASE:
81	*
82	* Raptor library release
83	*/
84	#define RAPTOR_VERSION_RELEASE 13
85
86	/**
87	* RAPTOR_API:
88	*
89	* Macro for wrapping API function call declarations.
90	*
91	*/
92	#ifndef RAPTOR_API
93	# ifdef WIN32
94	# ifdef __GNUC__
95	# undef _declspec
96	# define _declspec(x) __declspec(x)
97	# endif
98	# ifdef RAPTOR_STATIC
99	# define RAPTOR_API
100	# else
101	# ifdef RAPTOR_INTERNAL
102	# define RAPTOR_API _declspec(dllexport)
103	# else
104	# define RAPTOR_API _declspec(dllimport)
105	# endif
106	# endif
107	# else
108	# define RAPTOR_API
109	# endif
110	#endif
111
112	/ Use gcc 3.1+ feature to allow marking of deprecated API calls.*
113	* This gives a warning during compiling.
114	*/
115	#if defined(__GNUC__) && (__GNUC__ > 3 \|\| (__GNUC__ == 3 && __GNUC_MINOR__ >= 1))
116	#define RAPTOR_DEPRECATED __attribute__((deprecated))
117	#define RAPTOR_NORETURN __attribute__((__noreturn__))
118	#else
119	#define RAPTOR_DEPRECATED
120	#define RAPTOR_NORETURN
121	#endif
122
123	/**
124	* RAPTOR_PRINTF_FORMAT:
125	* @string_index: ignore me
126	* @first_to_check_index: ignore me
127	*
128	* Internal macro
129	*/
130	#if defined(__GNUC__) && (__GNUC__ > 2 \|\| (__GNUC__ == 2 && __GNUC_MINOR__ >= 5))
131	#define RAPTOR_PRINTF_FORMAT(string_index, first_to_check_index) \
132	__attribute__((__format__(__printf__, string_index, first_to_check_index)))
133	#else
134	#define RAPTOR_PRINTF_FORMAT(string_index, first_to_check_index)
135	#endif
136
137	/**
138	* raptor_uri:
139	*
140	* Raptor URI Class.
141	*/
142	typedef struct raptor_uri_s raptor_uri;
143
144
145	/ Public statics /
146
147	/**
148	* raptor_short_copyright_string:
149	*
150	* Short copyright string (one line).
151	*/
152	RAPTOR_API
153	extern const char * const raptor_short_copyright_string;
154
155	/**
156	* raptor_copyright_string:
157	*
158	* Copyright string (multiple lines).
159	*/
160	RAPTOR_API
161	extern const char * const raptor_copyright_string;
162
163	/**
164	* raptor_version_string:
165	*
166	* Raptor version as a string.
167	*/
168	RAPTOR_API
169	extern const char * const raptor_version_string;
170
171	/**
172	* raptor_version_major:
173	*
174	* Raptor major version number.
175	*/
176	RAPTOR_API
177	extern const unsigned int raptor_version_major;
178
179	/**
180	* raptor_version_minor:
181	*
182	* Raptor minor version number.
183	*/
184	RAPTOR_API
185	extern const unsigned int raptor_version_minor;
186
187	/**
188	* raptor_version_release:
189	*
190	* Raptor release version number.
191	*/
192	RAPTOR_API
193	extern const unsigned int raptor_version_release;
194
195	/**
196	* raptor_version_decimal:
197	*
198	* Raptor version as a decimal number.
199	*
200	* Format: major * 10000 + minor * 100 + release
201	*/
202	RAPTOR_API
203	extern const unsigned int raptor_version_decimal;
204
205	/**
206	* raptor_license_string:
207	*
208	* Raptor license string.
209	*/
210	RAPTOR_API
211	extern const char * const raptor_license_string;
212
213	/**
214	* raptor_home_url_string:
215	*
216	* Raptor home page URL.
217	*/
218	RAPTOR_API
219	extern const char * const raptor_home_url_string;
220
221	/**
222	* raptor_xml_namespace_uri:
223	*
224	* XML Namespace (xml:) URI string.
225	*/
226	RAPTOR_API
227	extern const unsigned char * const raptor_xml_namespace_uri;
228
229
230	/**
231	* raptor_rdf_namespace_uri:
232	*
233	* RDF Namespace (rdf:) URI string.
234	*/
235	RAPTOR_API
236	extern const unsigned char * const raptor_rdf_namespace_uri;
237
238	/**
239	* raptor_rdf_namespace_uri_len:
240	*
241	* Length of #raptor_rdf_namespace_uri string
242	*/
243	RAPTOR_API
244	extern const unsigned int raptor_rdf_namespace_uri_len;
245
246	/**
247	* raptor_rdf_schema_namespace_uri:
248	*
249	* RDF Schema (rdfs:) Namespace URI string.
250	*/
251	RAPTOR_API
252	extern const unsigned char * const raptor_rdf_schema_namespace_uri;
253
254	/**
255	* raptor_xmlschema_datatypes_namespace_uri:
256	*
257	* XML Schema datatypes (xsd:) namespace URI string.
258	*/
259	RAPTOR_API
260	extern const unsigned char * const raptor_xmlschema_datatypes_namespace_uri;
261
262	/**
263	* raptor_owl_namespace_uri:
264	*
265	* OWL (owl:) Namespace URI string.
266	*/
267	RAPTOR_API
268	extern const unsigned char * const raptor_owl_namespace_uri;
269
270	/**
271	* raptor_xml_literal_datatype_uri_string:
272	*
273	* XML Literal datatype (rdf:XMLLiteral) URI string.
274	*/
275	RAPTOR_API
276	extern const unsigned char * const raptor_xml_literal_datatype_uri_string;
277
278	/**
279	* raptor_xml_literal_datatype_uri_string_len:
280	*
281	* Length of #raptor_xml_literal_datatype_uri_string
282	*/
283	RAPTOR_API
284	extern const unsigned int raptor_xml_literal_datatype_uri_string_len;
285
286
287	/ Public structure /
288	/**
289	* raptor_world:
290	*
291	* Raptor world class.
292	*/
293	typedef struct raptor_world_s raptor_world;
294	/**
295	* raptor_parser:
296	*
297	* Raptor Parser class
298	*/
299	typedef struct raptor_parser_s raptor_parser;
300	/**
301	* raptor_serializer:
302	*
303	* Raptor Serializer class
304	*/
305	typedef struct raptor_serializer_s raptor_serializer;
306
307	/**
308	* raptor_www:
309	*
310	* Raptor WWW class
311	*/
312	typedef struct raptor_www_s raptor_www;
313	/**
314	* raptor_iostream:
315	*
316	* Raptor I/O Stream class
317	*/
318	typedef struct raptor_iostream_s raptor_iostream;
319	/**
320	* raptor_xml_element:
321	*
322	* Raptor XML Element class
323	*/
324	typedef struct raptor_xml_element_s raptor_xml_element;
325	/**
326	* raptor_xml_writer:
327	*
328	* Raptor XML Writer class
329	*/
330	typedef struct raptor_xml_writer_s raptor_xml_writer;
331	/**
332	* raptor_qname:
333	*
334	* Raptor XML qname class
335	*/
336	typedef struct raptor_qname_s raptor_qname;
337	/**
338	* raptor_namespace:
339	*
340	* Raptor XML Namespace class
341	*/
342	typedef struct raptor_namespace_s raptor_namespace;
343	/**
344	* raptor_namespace_stack:
345	*
346	* Raptor XML Namespace Stack class
347	*/
348	typedef struct raptor_namespace_stack_s raptor_namespace_stack;
349
350	/**
351	* raptor_sax2:
352	*
353	* Raptor SAX2 class
354	*/
355	typedef struct raptor_sax2_s raptor_sax2;
356
357
358	/**
359	* raptor_type_q:
360	* @mime_type: MIME type string
361	* @mime_type_len: length of @mime_type
362	* @q: Q value 0-10 standing for decimal 0.0-1.0
363	*
364	* (MIME Type, Q) pair
365	*/
366	typedef struct {
367	const char* mime_type;
368	size_t mime_type_len;
369	unsigned char q;
370	} raptor_type_q;
371
372
373	/**
374	* raptor_syntax_bitflags:
375	* @RAPTOR_SYNTAX_NEED_BASE_URI: the syntax requires a base URI
376	*
377	* Bit flags for #raptor_syntax_description flags field
378	*/
379	typedef enum {
380	RAPTOR_SYNTAX_NEED_BASE_URI = `1`
381	} raptor_syntax_bitflags;
382
383
384	/**
385	* raptor_syntax_description:
386	* @names: array of syntax names - the first one (required) is the public name, the rest are aliases. The array is NULL terminated.
387	* @names_count: size of @names array
388	* @label: long descriptive label for syntax
389	* @mime_types: Array of (MIME type, Q) values associated with the syntax (or NULL). If present the array is NULL terminated.
390	* @mime_types_count: size of @mime_types array
391	* @uri_strings: array of URIs identifying the syntax (or NULL). The first one if present is the main URI, the rest are aliases. The array is NULL terminated.
392	* @uri_strings_count: size of @uri_strings array
393	* @flags: See #raptor_syntax_bitflags for the bits
394	*
395	* Description of a syntax or file format.
396	*
397	*/
398	typedef struct {
399	const char* const* names;
400	unsigned int names_count;
401
402	const char* label;
403
404	const raptor_type_q* mime_types;
405	unsigned int mime_types_count;
406
407	const char* const* uri_strings;
408	unsigned int uri_strings_count;
409
410	unsigned int flags;
411	} raptor_syntax_description;
412
413
414	/**
415	* raptor_term_type:
416	* @RAPTOR_TERM_TYPE_URI: RDF URI
417	* @RAPTOR_TERM_TYPE_LITERAL: RDF literal
418	* @RAPTOR_TERM_TYPE_BLANK: RDF blank node
419	* @RAPTOR_TERM_TYPE_UNKNOWN: Internal
420	*
421	* Type of term in a #raptor_statement
422	*
423	* Node type 3 is unused but exists to preserve numeric compatibility
424	* with librdf_node_type values.
425	*/
426	typedef enum {
427	RAPTOR_TERM_TYPE_UNKNOWN = `0`,
428	RAPTOR_TERM_TYPE_URI = `1`,
429	RAPTOR_TERM_TYPE_LITERAL = `2`,
430	/ unused type 3 /
431	RAPTOR_TERM_TYPE_BLANK = `4`
432	} raptor_term_type;
433
434
435	/**
436	* raptor_locator:
437	* @uri: URI of location (or NULL)
438	* @file: Filename of location (or NULL)
439	* @line: Line number of location (or <0 for no line)
440	* @column: Column number of location (or <0 for no column)
441	* @byte: Byte number of location (or <0 for no byte)
442	*
443	* Location information for an error, warning or information message.
444	*/
445	typedef struct {
446	raptor_uri *uri;
447	const char *file;
448	int line;
449	int column;
450	int byte;
451	} raptor_locator;
452
453	/**
454	* raptor_option:
455	* @RAPTOR_OPTION_SCANNING: If true (default false), the RDF/XML
456	* parser will look for embedded rdf:RDF elements inside the XML
457	* content, and not require that the XML start with an rdf:RDF root
458	* element.
459	* @RAPTOR_OPTION_ALLOW_NON_NS_ATTRIBUTES: If true (default true)
460	* then the RDF/XML parser will allow non-XML namespaced attributes
461	* to be accepted as well as rdf: namespaced ones. For example,
462	* 'about' and 'ID' will be interpreted as if they were rdf:about
463	* and rdf:ID respectively.
464	* @RAPTOR_OPTION_ALLOW_OTHER_PARSETYPES: If true (default true)
465	* then the RDF/XML parser will allow unknown parsetypes to be
466	* present and will pass them on to the user. Unimplemented at
467	* present.
468	* @RAPTOR_OPTION_ALLOW_BAGID: If true (default true) then the
469	* RDF/XML parser will support the rdf:bagID attribute that was
470	* removed from the RDF/XML language when it was revised. This
471	* support may be removed in future.
472	* @RAPTOR_OPTION_ALLOW_RDF_TYPE_RDF_LIST: If true (default false)
473	* then the RDF/XML parser will generate the idList rdf:type
474	* rdf:List triple in the handling of rdf:parseType="Collection".
475	* This triple was removed during the revising of RDF/XML after
476	* collections were initially added.
477	* @RAPTOR_OPTION_NORMALIZE_LANGUAGE: If true (default true) then
478	* XML language values such as from xml:lang will be normalized to
479	* lowercase.
480	* @RAPTOR_OPTION_NON_NFC_FATAL: If true (default false) then
481	* illegal Unicode Normal Form C in literals will give a fatal
482	* error, otherwise just a warning.
483	* @RAPTOR_OPTION_WARN_OTHER_PARSETYPES: If true (default true) then
484	* the RDF/XML parser will warn about unknown rdf:parseType values.
485	* @RAPTOR_OPTION_CHECK_RDF_ID: If true (default true) then the
486	* RDF/XML will check rdf:ID attribute values for duplicates and
487	* cause an error if any are found.
488	* @RAPTOR_OPTION_RELATIVE_URIS: If true (default true) then
489	* relative URIs will be used wherever possible when serializing.
490	* @RAPTOR_OPTION_WRITER_AUTO_INDENT: Automatically indent elements when
491	* seriailizing.
492	* @RAPTOR_OPTION_WRITER_AUTO_EMPTY: Automatically detect and
493	* abbreviate empty elements when serializing.
494	* @RAPTOR_OPTION_WRITER_INDENT_WIDTH: Integer number of spaces to use
495	* for each indent level when serializing with auto indent.
496	* @RAPTOR_OPTION_WRITER_XML_VERSION: Integer XML version XML 1.0 (10) or XML 1.1 (11)
497	* @RAPTOR_OPTION_WRITER_XML_DECLARATION: Write XML 1.0 or 1.1 declaration.
498	* @RAPTOR_OPTION_NO_NET: Deny network requests inside other requests.
499	* @RAPTOR_OPTION_RESOURCE_BORDER: Border color of resource
500	* nodes for GraphViz DOT serializer.
501	* @RAPTOR_OPTION_LITERAL_BORDER: Border color of literal nodes
502	* for GraphViz DOT serializer.
503	* @RAPTOR_OPTION_BNODE_BORDER: Border color of blank nodes for
504	* GraphViz DOT serializer.
505	* @RAPTOR_OPTION_RESOURCE_FILL: Fill color of resource nodes
506	* for GraphViz DOT serializer.
507	* @RAPTOR_OPTION_LITERAL_FILL: Fill color of literal nodes for
508	* GraphViz DOT serializer.
509	* @RAPTOR_OPTION_BNODE_FILL: Fill color of blank nodes for
510	* GraphViz DOT serializer.
511	* @RAPTOR_OPTION_HTML_TAG_SOUP: Use a lax HTML parser if an XML parser
512	* fails when read HTML for GRDDL parser.
513	* @RAPTOR_OPTION_MICROFORMATS: Look for microformats for GRDDL parser.
514	* @RAPTOR_OPTION_HTML_LINK: Look for head <link> to type rdf/xml
515	* for GRDDL parser.
516	* @RAPTOR_OPTION_WWW_TIMEOUT: Set timeout for internal WWW URI requests
517	* for GRDDL parser.
518	* @RAPTOR_OPTION_WRITE_BASE_URI: Write @base directive for Turtle/N3.
519	* @RAPTOR_OPTION_WWW_HTTP_CACHE_CONTROL: HTTP Cache-Control: header
520	* @RAPTOR_OPTION_WWW_HTTP_USER_AGENT: HTTP User-Agent: header
521	* @RAPTOR_OPTION_JSON_CALLBACK: JSON serializer callback function.
522	* @RAPTOR_OPTION_JSON_EXTRA_DATA: JSON serializer extra top-level data
523	* @RAPTOR_OPTION_RSS_TRIPLES: Atom/RSS serializer writes extra RDF triples it finds (none, rdf-xml, atom-triples)
524	* @RAPTOR_OPTION_ATOM_ENTRY_URI: Atom entry URI. If given, generate an Atom Entry Document with the item having the given URI, otherwise generate an Atom Feed Document with any items found.
525	* @RAPTOR_OPTION_PREFIX_ELEMENTS: Integer. If set, generate Atom/RSS1.0 documents with prefixed elements, otherwise unprefixed.
526	* @RAPTOR_OPTION_STRICT: Boolean. If set, operate in strict conformance mode.
527	* @RAPTOR_OPTION_WWW_CERT_FILENAME: String. SSL client certificate filename
528	* @RAPTOR_OPTION_WWW_CERT_TYPE: String. SSL client certificate type
529	* @RAPTOR_OPTION_WWW_CERT_PASSPHRASE: String. SSL client certificate passphrase
530	* @RAPTOR_OPTION_WWW_SSL_VERIFY_PEER: Integer. SSL verify peer - non-0 to verify peer SSL certificate (default)
531	* @RAPTOR_OPTION_WWW_SSL_VERIFY_HOST: Integer. SSL verify host - 0 none, 1 CN match, 2 host match (default). Other values are ignored.
532	* @RAPTOR_OPTION_NO_FILE: Deny file reading requests inside other requests.
533	* @RAPTOR_OPTION_LOAD_EXTERNAL_ENTITIES: When reading XML, load external entities.
534	* @RAPTOR_OPTION_LAST: Internal
535	*
536	* Raptor parser, serializer or XML writer options.
537	*/
538	typedef enum {
539	RAPTOR_OPTION_SCANNING,
540	RAPTOR_OPTION_ALLOW_NON_NS_ATTRIBUTES,
541	RAPTOR_OPTION_ALLOW_OTHER_PARSETYPES,
542	RAPTOR_OPTION_ALLOW_BAGID,
543	RAPTOR_OPTION_ALLOW_RDF_TYPE_RDF_LIST,
544	RAPTOR_OPTION_NORMALIZE_LANGUAGE,
545	RAPTOR_OPTION_NON_NFC_FATAL,
546	RAPTOR_OPTION_WARN_OTHER_PARSETYPES,
547	RAPTOR_OPTION_CHECK_RDF_ID,
548	RAPTOR_OPTION_RELATIVE_URIS,
549	RAPTOR_OPTION_WRITER_AUTO_INDENT,
550	RAPTOR_OPTION_WRITER_AUTO_EMPTY,
551	RAPTOR_OPTION_WRITER_INDENT_WIDTH,
552	RAPTOR_OPTION_WRITER_XML_VERSION,
553	RAPTOR_OPTION_WRITER_XML_DECLARATION,
554	RAPTOR_OPTION_NO_NET,
555	RAPTOR_OPTION_RESOURCE_BORDER,
556	RAPTOR_OPTION_LITERAL_BORDER,
557	RAPTOR_OPTION_BNODE_BORDER,
558	RAPTOR_OPTION_RESOURCE_FILL,
559	RAPTOR_OPTION_LITERAL_FILL,
560	RAPTOR_OPTION_BNODE_FILL,
561	RAPTOR_OPTION_HTML_TAG_SOUP,
562	RAPTOR_OPTION_MICROFORMATS,
563	RAPTOR_OPTION_HTML_LINK,
564	RAPTOR_OPTION_WWW_TIMEOUT,
565	RAPTOR_OPTION_WRITE_BASE_URI,
566	RAPTOR_OPTION_WWW_HTTP_CACHE_CONTROL,
567	RAPTOR_OPTION_WWW_HTTP_USER_AGENT,
568	RAPTOR_OPTION_JSON_CALLBACK,
569	RAPTOR_OPTION_JSON_EXTRA_DATA,
570	RAPTOR_OPTION_RSS_TRIPLES,
571	RAPTOR_OPTION_ATOM_ENTRY_URI,
572	RAPTOR_OPTION_PREFIX_ELEMENTS,
573	RAPTOR_OPTION_STRICT,
574	RAPTOR_OPTION_WWW_CERT_FILENAME,
575	RAPTOR_OPTION_WWW_CERT_TYPE,
576	RAPTOR_OPTION_WWW_CERT_PASSPHRASE,
577	RAPTOR_OPTION_NO_FILE,
578	RAPTOR_OPTION_WWW_SSL_VERIFY_PEER,
579	RAPTOR_OPTION_WWW_SSL_VERIFY_HOST,
580	RAPTOR_OPTION_LOAD_EXTERNAL_ENTITIES,
581	RAPTOR_OPTION_LAST = RAPTOR_OPTION_LOAD_EXTERNAL_ENTITIES
582	} raptor_option;
583
584
585	/**
586	* raptor_term_literal_value:
587	* @string: literal string
588	* @string_len: length of string
589	* @datatype: datatype URI (or NULL)
590	* @language: literal language (or NULL)
591	* @language_len: length of language
592	*
593	* Literal term value - this typedef exists solely for use in #raptor_term
594	*
595	* Either @datatype or @language may be non-NULL but not both.
596	*/
597	typedef struct {
598	unsigned char *string;
599	unsigned int string_len;
600
601	raptor_uri *datatype;
602
603	unsigned char *language;
604	unsigned char language_len;
605	} raptor_term_literal_value;
606
607
608	/**
609	* raptor_term_blank_value:
610	* @string: literal string
611	* @string_len: length of string
612	*
613	* Blank term value - this typedef exists solely for use in #raptor_term
614	*
615	*/
616	typedef struct {
617	unsigned char *string;
618	unsigned int string_len;
619	} raptor_term_blank_value;
620
621
622	/**
623	* raptor_term_value:
624	* @uri: uri value when term type is #RAPTOR_TERM_TYPE_URI
625	* @literal: literal value when term type is #RAPTOR_TERM_TYPE_LITERAL
626	* @blank: blank value when term type is #RAPTOR_TERM_TYPE_BLANK
627	*
628	* Term value - this typedef exists solely for use in #raptor_term
629	*
630	**/
631	typedef union {
632	raptor_uri *uri;
633
634	raptor_term_literal_value literal;
635
636	raptor_term_blank_value blank;
637	} raptor_term_value;
638
639
640	/**
641	* raptor_term:
642	* @world: world
643	* @usage: usage reference count (if >0)
644	* @type: term type
645	* @value: term values per type
646	*
647	* An RDF statement term
648	*
649	*/
650	typedef struct {
651	raptor_world* world;
652
653	int usage;
654
655	raptor_term_type type;
656
657	raptor_term_value value;
658
659	} raptor_term;
660
661
662	/**
663	* raptor_statement:
664	* @world: world pointer
665	* @usage: usage count
666	* @subject: statement subject
667	* @predicate: statement predicate
668	* @object: statement object
669	* @graph: statement graph name (or NULL if not present)
670	*
671	* An RDF triple with optional graph name (quad)
672	*
673	* See #raptor_term for a description of how the fields may be used.
674	* As returned by a parser statement_handler.
675	*/
676	typedef struct {
677	raptor_world* world;
678	int usage;
679	raptor_term* subject;
680	raptor_term* predicate;
681	raptor_term* object;
682	raptor_term* graph;
683	} raptor_statement;
684
685
686	/**
687	* raptor_log_level:
688	* @RAPTOR_LOG_LEVEL_NONE: Internal
689	* @RAPTOR_LOG_LEVEL_TRACE: very fine-grained tracing messages information
690	* @RAPTOR_LOG_LEVEL_DEBUG: fine-grained tracing messages suitable for debugging
691	* @RAPTOR_LOG_LEVEL_INFO: coarse-grained information messages
692	* @RAPTOR_LOG_LEVEL_WARN: warning messages of potentially harmful problems
693	* @RAPTOR_LOG_LEVEL_ERROR: error messages where the application can continue
694	* @RAPTOR_LOG_LEVEL_FATAL: fatal error message where the application will likely abort
695	* @RAPTOR_LOG_LEVEL_LAST: Internal
696	*
697	* Log levels
698	*/
699	typedef enum {
700	RAPTOR_LOG_LEVEL_NONE,
701	RAPTOR_LOG_LEVEL_TRACE,
702	RAPTOR_LOG_LEVEL_DEBUG,
703	RAPTOR_LOG_LEVEL_INFO,
704	RAPTOR_LOG_LEVEL_WARN,
705	RAPTOR_LOG_LEVEL_ERROR,
706	RAPTOR_LOG_LEVEL_FATAL,
707	RAPTOR_LOG_LEVEL_LAST = RAPTOR_LOG_LEVEL_FATAL
708	} raptor_log_level;
709
710
711	/**
712	* raptor_domain:
713	* @RAPTOR_DOMAIN_IOSTREAM: I/O stream
714	* @RAPTOR_DOMAIN_NAMESPACE: XML Namespace / namespace stack
715	* @RAPTOR_DOMAIN_PARSER: RDF Parser
716	* @RAPTOR_DOMAIN_QNAME: XML QName
717	* @RAPTOR_DOMAIN_SAX2: XML SAX2
718	* @RAPTOR_DOMAIN_SERIALIZER: RDF Serializer
719	* @RAPTOR_DOMAIN_TERM: RDF Term
720	* @RAPTOR_DOMAIN_TURTLE_WRITER: Turtle Writer
721	* @RAPTOR_DOMAIN_URI: RDF Uri
722	* @RAPTOR_DOMAIN_WORLD: RDF world
723	* @RAPTOR_DOMAIN_WWW: WWW
724	* @RAPTOR_DOMAIN_XML_WRITER: XML Writer
725	* @RAPTOR_DOMAIN_NONE: Internal
726	* @RAPTOR_DOMAIN_LAST: Internal
727	*
728	* Log domain
729	*/
730	typedef enum {
731	RAPTOR_DOMAIN_NONE,
732	RAPTOR_DOMAIN_IOSTREAM,
733	RAPTOR_DOMAIN_NAMESPACE,
734	RAPTOR_DOMAIN_PARSER,
735	RAPTOR_DOMAIN_QNAME,
736	RAPTOR_DOMAIN_SAX2,
737	RAPTOR_DOMAIN_SERIALIZER,
738	RAPTOR_DOMAIN_TERM,
739	RAPTOR_DOMAIN_TURTLE_WRITER,
740	RAPTOR_DOMAIN_URI,
741	RAPTOR_DOMAIN_WORLD,
742	RAPTOR_DOMAIN_WWW,
743	RAPTOR_DOMAIN_XML_WRITER,
744	RAPTOR_DOMAIN_LAST = RAPTOR_DOMAIN_XML_WRITER
745	} raptor_domain;
746
747
748	/**
749	* raptor_log_message:
750	* @code: error code or < 0 if not used or known
751	* @domain: message domain or #RAPTOR_DOMAIN_NONE if not used or known
752	* @level: log message level
753	* @locator: location associated with message or NULL if not known
754	* @text: message string
755	*
756	* Log message.
757	*/
758	typedef struct {
759	int code;
760	raptor_domain domain;
761	raptor_log_level level;
762	raptor_locator *locator;
763	const char *text;
764	} raptor_log_message;
765
766
767	/**
768	* raptor_log_handler:
769	* @user_data: user data
770	* @message: log message
771	*
772	* Handler function for log messages with location
773	*
774	* Used during parsing and serializing for errors and warnings that
775	* may include location information. Handlers may be set
776	* by raptor_world_set_log_handler().
777	*
778	*/
779	typedef void (raptor_log_handler)(void* user_data, raptor_log_message message);
780
781
782	/**
783	* raptor_statement_handler:
784	* @user_data: user data
785	* @statement: statement to report
786	*
787	* Statement (triple) reporting handler function.
788	*
789	* This handler function set with
790	* raptor_parser_set_statement_handler() on a parser receives
791	* statements as the parsing proceeds. The @statement argument to the
792	* handler is shared and must be copied by the caller with
793	* raptor_statement_copy().
794	*/
795	typedef void (raptor_statement_handler)(void* user_data, raptor_statement statement);
796
797	/**
798	* raptor_graph_mark_flags:
799	* @RAPTOR_GRAPH_MARK_START: mark is start of graph (otherwise is end)
800	* @RAPTOR_GRAPH_MARK_DECLARED: mark was declared in syntax rather than implict
801	*
802	* Graph mark handler bitmask flags
803	*/
804	typedef enum {
805	RAPTOR_GRAPH_MARK_START = `1`,
806	RAPTOR_GRAPH_MARK_DECLARED = `2`
807	} raptor_graph_mark_flags;
808
809
810	/**
811	* raptor_graph_mark_handler:
812	* @user_data: user data
813	* @graph: graph to report, NULL for the default graph
814	* @flags: bitmask of #raptor_graph_mark_flags flags
815	*
816	* Graph start/end mark handler function.
817	*
818	* Records start and end of graphs happening in a stream of generated
819	* #raptor_statement via the statement handler. The callback starts a
820	* graph when @flags has #RAPTOR_GRAPH_MARK_START bit set.
821	*
822	* The start and ends may be either declared in the syntax via some
823	* keyword or mechanism such as TRiG {} syntax when @flags has bit
824	* #RAPTOR_GRAPH_MARK_DECLARED set, or be implied by the start/end of
825	* the data in other syntaxes, and the bit will be unset.
826	*/
827	typedef void (raptor_graph_mark_handler)(void* user_data, raptor_uri graph, int flags);
828
829	/**
830	* raptor_generate_bnodeid_handler:
831	* @user_data: user data
832	* @user_bnodeid: a user-specified ID or NULL if none available.
833	*
834	* Generate a blank node identifier handler function.
835	*
836	* Return value: new blank node ID to use
837	*/
838	typedef unsigned char* (raptor_generate_bnodeid_handler)(void* user_data, unsigned* char* user_bnodeid);
839
840	/**
841	* raptor_namespace_handler:
842	* @user_data: user data
843	* @nspace: #raptor_namespace declared
844	*
845	* XML Namespace declaration reporting handler set by
846	* raptor_parser_set_namespace_handler().
847	*/
848	typedef void (raptor_namespace_handler)(void** user_data, raptor_namespace *nspace);
849
850
851	/**
852	* raptor_www_write_bytes_handler:
853	* @www: WWW object
854	* @userdata: user data
855	* @ptr: data pointer
856	* @size: size of individual item
857	* @nmemb: number of items
858	*
859	* Receiving bytes of data from WWW retrieval handler.
860	*
861	* Set by raptor_www_set_write_bytes_handler().
862	*/
863	typedef void (raptor_www_write_bytes_handler)(raptor_www www, void userdata, const* void *ptr, size_t size, size_t nmemb);
864
865	/**
866	* raptor_www_content_type_handler:
867	* @www: WWW object
868	* @userdata: user data
869	* @content_type: content type seen
870	*
871	* Receiving Content-Type: header from WWW retrieval handler.
872	*
873	* Set by raptor_www_set_content_type_handler().
874	*/
875	typedef void (raptor_www_content_type_handler)(raptor_www www, void userdata, const* char *content_type);
876
877	/**
878	* raptor_www_final_uri_handler:
879	* @www: WWW object
880	* @userdata: user data
881	* @final_uri: final URI seen
882	*
883	* Receiving the final resolved URI from a WWW retrieval
884	*
885	* Set by raptor_www_set_final_uri_handler().
886	*/
887	typedef void (raptor_www_final_uri_handler)(raptor_www www, void userdata, raptor_uri final_uri);
888
889	/**
890	* raptor_uri_filter_func:
891	* @user_data: user data
892	* @uri: #raptor_uri URI to check
893	*
894	* Callback function for #raptor_www_set_uri_filter
895	*
896	* Return value: non-0 to filter the URI
897	*/
898	typedef int (raptor_uri_filter_func)(void* user_data, raptor_uri uri);
899
900
901	/**
902	* raptor_world_flag:
903	* @RAPTOR_WORLD_FLAG_LIBXML_GENERIC_ERROR_SAVE: if set (non-0 value) - save/restore the libxml generic error handler when raptor library initializes (default set)
904	* @RAPTOR_WORLD_FLAG_LIBXML_STRUCTURED_ERROR_SAVE: if set (non-0 value) - save/restore the libxml structured error handler when raptor library terminates (default set)
905	* @RAPTOR_WORLD_FLAG_URI_INTERNING: if set (non-0 value) - each URI is saved interned in-memory and reused (default set)
906	* @RAPTOR_WORLD_FLAG_WWW_SKIP_INIT_FINISH: if set (non-0 value) the raptor will neither initialise or terminate the lower level WWW library. Usually in raptor initialising either curl_global_init (for libcurl) are called and in raptor cleanup, curl_global_cleanup is called. This flag allows the application finer control over these libraries such as setting other global options or potentially calling and terminating raptor several times. It does mean that applications which use this call must do their own extra work in order to allocate and free all resources to the system.
907	*
908	* Raptor world flags
909	*
910	* These are used by raptor_world_set_flags() to control raptor-wide
911	* options across classes. These must be set before
912	* raptor_world_open() is called explicitly or implicitly (by
913	* creating a raptor object). There is no enumeration function for
914	* these flags because they are not user options and must be set
915	* before the library is initialised. For similar reasons, there is
916	* no get function.
917	*
918	* If any libxml handler saving/restoring is enabled, any existing
919	* handler and context is saved before parsing and restored
920	* afterwards. Otherwise, no saving/restoring is performed.
921	*
922	*/
923	typedef enum {
924	RAPTOR_WORLD_FLAG_LIBXML_GENERIC_ERROR_SAVE = `1`,
925	RAPTOR_WORLD_FLAG_LIBXML_STRUCTURED_ERROR_SAVE = `2`,
926	RAPTOR_WORLD_FLAG_URI_INTERNING = `3`,
927	RAPTOR_WORLD_FLAG_WWW_SKIP_INIT_FINISH = `4`
928	} raptor_world_flag;
929
930
931	/**
932	* raptor_data_compare_handler:
933	* @data1: first data object
934	* @data2: second data object
935	*
936	* Function to compare two data objects - signature like strcmp() and function pssed to qsort()
937	*
938	* Designed to be passed into generic data structure constructors
939	* like raptor_new_avltree().
940	*
941	* Return value: compare value <0 if @data1 is before @data2, =0 if equal, >0 if @data1 is after @data2
942	*/
943	typedef int (raptor_data_compare_handler)(const* void* data1, const void* data2);
944
945
946	/**
947	* raptor_data_malloc_handler:
948	* @size: data size
949	*
950	* Typedef for a function to allocate memory - signature like malloc()
951	*
952	* Designed to be passed into constructors
953	* like raptor_www_fetch_to_string
954	*
955	* Return value: pointer to newly allocated memory or NULL on failure
956	*/
957	typedef void* (*raptor_data_malloc_handler)(size_t size);
958
959
960	/**
961	* raptor_data_free_handler:
962	* @data: data object or NULL
963	*
964	* Typedef for function to free a data object - signature like free()
965	*
966	* Designed to be passed into generic data structure constructors
967	* like raptor_new_avltree(). If @data is NULL, nothing should be done.
968	*/
969	typedef void (raptor_data_free_handler)(void** data);
970
971
972	/**
973	* raptor_data_context_free_handler:
974	* @context: context data for the free function
975	* @object: object to free
976	*
977	* Handler function for freeing a sequence item with a contextual pointer.
978	*
979	* Set by raptor_new_sequence_with_context().
980	*/
981	typedef void (raptor_data_context_free_handler)(void** context, void* object);
982
983	/**
984	* raptor_data_print_handler:
985	* @object: object to print
986	* @fh: FILE* to print to
987	*
988	* Handler function for printing an object to a stream.
989	*
990	* Set by raptor_new_sequence()
991	*
992	* Return value: non-0 on failure
993	*/
994	typedef int (raptor_data_print_handler)(void* object, FILE fh);
995
996	/**
997	* raptor_data_context_print_handler:
998	* @context: context data for the print function
999	* @object: object to print
1000	* @fh: FILE* to print to
1001	*
1002	* Function function for printing an object with data context to a stream.
1003	*
1004	* Set by raptor_new_sequence_with_context()
1005	*
1006	* Return value: non-0 on failure
1007	*/
1008	typedef int (raptor_data_context_print_handler)(void* context, void* object, FILE fh);
1009
1010	/**
1011	* raptor_stringbuffer:
1012	*
1013	* Raptor string buffer class
1014	*/
1015	typedef struct raptor_stringbuffer_s raptor_stringbuffer;
1016
1017
1018	/ Public functions /
1019
1020	#define raptor_new_world() raptor_new_world_internal(RAPTOR_VERSION)
1021	/ The real target of the raptor_new_world() macro /
1022	RAPTOR_API
1023	raptor_world raptor_new_world_internal(unsigned* int version_decimal);
1024	RAPTOR_API
1025	int raptor_world_open(raptor_world* world);
1026	RAPTOR_API
1027	void raptor_free_world(raptor_world* world);
1028	RAPTOR_API
1029	int raptor_world_set_libxslt_security_preferences(raptor_world world, void* *security_preferences);
1030	RAPTOR_API
1031	int raptor_world_set_flag(raptor_world world, raptor_world_flag flag, int* value);
1032	RAPTOR_API
1033	int raptor_world_set_log_handler(raptor_world world, void* *user_data, raptor_log_handler handler);
1034	RAPTOR_API
1035	void raptor_world_set_generate_bnodeid_handler(raptor_world* world, void *user_data, raptor_generate_bnodeid_handler handler);
1036	RAPTOR_API
1037	unsigned char* raptor_world_generate_bnodeid(raptor_world *world);
1038	RAPTOR_API
1039	void raptor_world_set_generate_bnodeid_parameters(raptor_world* world, char prefix, int* base);
1040	RAPTOR_API
1041	const char* raptor_log_level_get_label(raptor_log_level level);
1042	RAPTOR_API
1043	const char* raptor_domain_get_label(raptor_domain domain);
1044
1045	/ Names /
1046	RAPTOR_API
1047	int raptor_world_is_parser_name(raptor_world* world, const char *name);
1048	RAPTOR_API
1049	const char* raptor_world_guess_parser_name(raptor_world* world, raptor_uri uri, const* char mime_type, const* unsigned char buffer, size_t len, const* unsigned char *identifier);
1050	RAPTOR_API
1051	int raptor_world_is_serializer_name(raptor_world* world, const char *name);
1052
1053	/ Syntax descriptions /
1054	RAPTOR_API
1055	const raptor_syntax_description* raptor_world_get_parser_description(raptor_world* world, unsigned int counter);
1056	RAPTOR_API
1057	const raptor_syntax_description* raptor_world_get_serializer_description(raptor_world* world, unsigned int counter);
1058	RAPTOR_API
1059	int raptor_syntax_description_validate(raptor_syntax_description* desc);
1060
1061	RAPTOR_API
1062	raptor_option raptor_world_get_option_from_uri(raptor_world* world, raptor_uri *uri);
1063
1064
1065	/ Term Class /
1066	RAPTOR_API
1067	raptor_term* raptor_new_term_from_uri(raptor_world* world, raptor_uri* uri);
1068	RAPTOR_API
1069	raptor_term* raptor_new_term_from_counted_uri_string(raptor_world* world, const unsigned char *uri_string, size_t length);
1070	RAPTOR_API
1071	raptor_term* raptor_new_term_from_uri_string(raptor_world* world, const unsigned char *uri_string);
1072	RAPTOR_API
1073	raptor_term* raptor_new_term_from_literal(raptor_world* world, const unsigned char* literal, raptor_uri* datatype, const unsigned char* language);
1074	RAPTOR_API
1075	raptor_term* raptor_new_term_from_counted_literal(raptor_world* world, const unsigned char* literal, size_t literal_len, raptor_uri* datatype, const unsigned char* language, unsigned char language_len);
1076	RAPTOR_API
1077	raptor_term* raptor_new_term_from_blank(raptor_world* world, const unsigned char* blank);
1078	RAPTOR_API
1079	raptor_term* raptor_new_term_from_counted_blank(raptor_world* world, const unsigned char* blank, size_t length);
1080	RAPTOR_API
1081	raptor_term* raptor_new_term_from_counted_string(raptor_world* world, unsigned char* string, size_t length);
1082	RAPTOR_API
1083	raptor_term* raptor_term_copy(raptor_term* term);
1084	RAPTOR_API
1085	int raptor_term_compare(const raptor_term t1, const* raptor_term *t2);
1086	RAPTOR_API
1087	int raptor_term_equals(raptor_term* t1, raptor_term* t2);
1088	RAPTOR_API
1089	void raptor_free_term(raptor_term *term);
1090
1091	RAPTOR_API
1092	unsigned char* raptor_term_to_counted_string(raptor_term term, size_t len_p);
1093	RAPTOR_API
1094	unsigned char* raptor_term_to_string(raptor_term *term);
1095	RAPTOR_API
1096	int raptor_term_escaped_write(const raptor_term term, unsigned* int flags, raptor_iostream* iostr);
1097	RAPTOR_API RAPTOR_DEPRECATED
1098	int raptor_term_ntriples_write(const raptor_term term, raptor_iostream iostr);
1099	RAPTOR_API
1100	int raptor_uri_turtle_write(raptor_world world, raptor_iostream iostr, raptor_uri* uri, raptor_namespace_stack nstack, raptor_uri base_uri);
1101	RAPTOR_API
1102	int raptor_term_turtle_write(raptor_iostream* iostr, raptor_term* term, raptor_namespace_stack nstack, raptor_uri base_uri);
1103	RAPTOR_API
1104	unsigned char* raptor_uri_to_turtle_counted_string(raptor_world world, raptor_uri uri, raptor_namespace_stack nstack, raptor_uri base_uri, size_t *len_p);
1105	RAPTOR_API
1106	unsigned char* raptor_uri_to_turtle_string(raptor_world world, raptor_uri uri, raptor_namespace_stack nstack, raptor_uri base_uri);
1107	RAPTOR_API
1108	unsigned char* raptor_term_to_turtle_counted_string(raptor_term* term, raptor_namespace_stack nstack, raptor_uri base_uri, size_t *len_p);
1109	RAPTOR_API
1110	unsigned char* raptor_term_to_turtle_string(raptor_term* term, raptor_namespace_stack nstack, raptor_uri base_uri);
1111
1112
1113	/ Statement Class /
1114	RAPTOR_API
1115	void raptor_statement_init(raptor_statement statement, raptor_world world);
1116	RAPTOR_API
1117	void raptor_statement_clear(raptor_statement *statement);
1118	RAPTOR_API
1119	raptor_statement* raptor_new_statement(raptor_world *world);
1120	RAPTOR_API
1121	raptor_statement* raptor_new_statement_from_nodes(raptor_world* world, raptor_term subject, raptor_term predicate, raptor_term object, raptor_term graph);
1122	RAPTOR_API
1123	raptor_statement* raptor_statement_copy(raptor_statement *statement);
1124	RAPTOR_API
1125	void raptor_free_statement(raptor_statement *statement);
1126
1127	RAPTOR_API
1128	int raptor_statement_print(const raptor_statement * statement, FILE *stream);
1129	RAPTOR_API
1130	int raptor_statement_print_as_ntriples(const raptor_statement * statement, FILE *stream);
1131	RAPTOR_API
1132	int raptor_statement_compare(const raptor_statement s1, const* raptor_statement *s2);
1133	RAPTOR_API
1134	int raptor_statement_equals(const raptor_statement* s1, const raptor_statement* s2);
1135
1136
1137	/ Parser Class /
1138	RAPTOR_API
1139	raptor_parser* raptor_new_parser(raptor_world* world, const char *name);
1140	RAPTOR_API
1141	raptor_parser* raptor_new_parser_for_content(raptor_world* world, raptor_uri uri, const* char mime_type, const* unsigned char buffer, size_t len, const* unsigned char *identifier);
1142	RAPTOR_API
1143	void raptor_free_parser(raptor_parser* parser);
1144
1145	/ methods /
1146
1147	/ Handlers /
1148	RAPTOR_API
1149	void raptor_parser_set_statement_handler(raptor_parser* parser, void *user_data, raptor_statement_handler handler);
1150	RAPTOR_API
1151	void raptor_parser_set_graph_mark_handler(raptor_parser* parser, void *user_data, raptor_graph_mark_handler handler);
1152	RAPTOR_API
1153	void raptor_parser_set_namespace_handler(raptor_parser* parser, void *user_data, raptor_namespace_handler handler);
1154	RAPTOR_API
1155	void raptor_parser_set_uri_filter(raptor_parser* parser, raptor_uri_filter_func filter, void* user_data);
1156	RAPTOR_API
1157	raptor_locator* raptor_parser_get_locator(raptor_parser* rdf_parser);
1158
1159
1160	/ Parsing functions /
1161	RAPTOR_API
1162	int raptor_parser_parse_start(raptor_parser rdf_parser, raptor_uri uri);
1163	RAPTOR_API
1164	int raptor_parser_parse_chunk(raptor_parser* rdf_parser, const unsigned char buffer, size_t len, int* is_end);
1165	RAPTOR_API
1166	int raptor_parser_parse_file_stream(raptor_parser* rdf_parser, FILE stream, const* char filename, raptor_uri base_uri);
1167	RAPTOR_API
1168	int raptor_parser_parse_file(raptor_parser* rdf_parser, raptor_uri uri, raptor_uri base_uri);
1169	RAPTOR_API
1170	int raptor_parser_parse_uri(raptor_parser* rdf_parser, raptor_uri uri, raptor_uri base_uri);
1171	RAPTOR_API
1172	int raptor_parser_parse_uri_with_connection(raptor_parser* rdf_parser, raptor_uri uri, raptor_uri base_uri, void *connection);
1173	RAPTOR_API
1174	int raptor_parser_parse_iostream(raptor_parser* rdf_parser, raptor_iostream iostr, raptor_uri base_uri);
1175	RAPTOR_API
1176	void raptor_parser_parse_abort(raptor_parser* rdf_parser);
1177	RAPTOR_API
1178	const char* raptor_parser_get_name(raptor_parser *rdf_parser);
1179	RAPTOR_API
1180	const raptor_syntax_description* raptor_parser_get_description(raptor_parser *rdf_parser);
1181
1182	/ parser option methods /
1183	RAPTOR_API
1184	int raptor_parser_set_option(raptor_parser parser, raptor_option option, const* char* string, int integer);
1185	RAPTOR_API
1186	int raptor_parser_get_option(raptor_parser parser, raptor_option option, char*** string_p, int* integer_p);
1187
1188	/ parser utility methods /
1189	RAPTOR_API
1190	const char* raptor_parser_get_accept_header(raptor_parser* rdf_parser);
1191	RAPTOR_API
1192	raptor_world* raptor_parser_get_world(raptor_parser* rdf_parser);
1193	RAPTOR_API
1194	raptor_uri* raptor_parser_get_graph(raptor_parser* rdf_parser);
1195
1196
1197	/ Locator Class /
1198	/ methods /
1199	RAPTOR_API
1200	int raptor_locator_print(raptor_locator* locator, FILE *stream);
1201	RAPTOR_API
1202	int raptor_locator_format(char buffer, size_t length, raptor_locator locator);
1203	RAPTOR_API
1204	int raptor_locator_line(raptor_locator *locator);
1205	RAPTOR_API
1206	int raptor_locator_column(raptor_locator *locator);
1207	RAPTOR_API
1208	int raptor_locator_byte(raptor_locator *locator);
1209	RAPTOR_API
1210	const char* raptor_locator_file(raptor_locator *locator);
1211	RAPTOR_API
1212	const char* raptor_locator_uri(raptor_locator *locator);
1213
1214
1215	/ Serializer Class /
1216	RAPTOR_API
1217	raptor_serializer* raptor_new_serializer(raptor_world* world, const char *name);
1218	RAPTOR_API
1219	void raptor_free_serializer(raptor_serializer* rdf_serializer);
1220
1221	/ methods /
1222	RAPTOR_API
1223	int raptor_serializer_start_to_iostream(raptor_serializer rdf_serializer, raptor_uri uri, raptor_iostream *iostream);
1224	RAPTOR_API
1225	int raptor_serializer_start_to_filename(raptor_serializer rdf_serializer, const* char *filename);
1226	RAPTOR_API
1227	int raptor_serializer_start_to_string(raptor_serializer rdf_serializer, raptor_uri uri, void *string_p, size_t length_p);
1228	RAPTOR_API
1229	int raptor_serializer_start_to_file_handle(raptor_serializer rdf_serializer, raptor_uri uri, FILE *fh);
1230	RAPTOR_API
1231	int raptor_serializer_set_namespace(raptor_serializer* rdf_serializer, raptor_uri uri, const* unsigned char *prefix);
1232	RAPTOR_API
1233	int raptor_serializer_set_namespace_from_namespace(raptor_serializer* rdf_serializer, raptor_namespace *nspace);
1234	RAPTOR_API
1235	int raptor_serializer_serialize_statement(raptor_serializer* rdf_serializer, raptor_statement *statement);
1236	RAPTOR_API
1237	int raptor_serializer_serialize_end(raptor_serializer *rdf_serializer);
1238	RAPTOR_API
1239	raptor_iostream* raptor_serializer_get_iostream(raptor_serializer *serializer);
1240	RAPTOR_API
1241	raptor_locator* raptor_serializer_get_locator(raptor_serializer *rdf_serializer);
1242	RAPTOR_API
1243	int raptor_serializer_flush(raptor_serializer *rdf_serializer);
1244	RAPTOR_API
1245	const raptor_syntax_description* raptor_serializer_get_description(raptor_serializer *rdf_serializer);
1246
1247	/ serializer option methods /
1248	RAPTOR_API
1249	int raptor_serializer_set_option(raptor_serializer serializer, raptor_option option, const* char* string, int integer);
1250	RAPTOR_API
1251	int raptor_serializer_get_option(raptor_serializer serializer, raptor_option option, char*** string_p, int* integer_p);
1252
1253	/ utility methods /
1254	RAPTOR_API
1255	raptor_world* raptor_serializer_get_world(raptor_serializer* rdf_serializer);
1256
1257
1258	/ memory functions /
1259	RAPTOR_API
1260	void raptor_free_memory(void *ptr);
1261	RAPTOR_API
1262	void* raptor_alloc_memory(size_t size);
1263	RAPTOR_API
1264	void* raptor_calloc_memory(size_t nmemb, size_t size);
1265
1266
1267	/ URI Class /
1268	RAPTOR_API
1269	raptor_uri* raptor_new_uri_from_counted_string(raptor_world* world, const unsigned char *uri_string, size_t length);
1270	RAPTOR_API
1271	raptor_uri* raptor_new_uri(raptor_world* world, const unsigned char *uri_string);
1272	RAPTOR_API
1273	raptor_uri* raptor_new_uri_from_uri_local_name(raptor_world* world, raptor_uri uri, const* unsigned char *local_name);
1274	RAPTOR_API
1275	raptor_uri* raptor_new_uri_relative_to_base(raptor_world* world, raptor_uri base_uri, const* unsigned char *uri_string);
1276	RAPTOR_API
1277	raptor_uri* raptor_new_uri_relative_to_base_counted(raptor_world* world, raptor_uri base_uri, const* unsigned char *uri_string, size_t uri_len);
1278	RAPTOR_API
1279	raptor_uri* raptor_new_uri_from_id(raptor_world* world, raptor_uri base_uri, const* unsigned char *id);
1280	RAPTOR_API
1281	raptor_uri* raptor_new_uri_from_uri_or_file_string(raptor_world* world, raptor_uri* base_uri, const unsigned char* uri_or_file_string);
1282	RAPTOR_API
1283	raptor_uri* raptor_new_uri_for_rdf_concept(raptor_world* world, const unsigned char *name);
1284	RAPTOR_API
1285	raptor_uri* raptor_new_uri_for_xmlbase(raptor_uri* old_uri);
1286	RAPTOR_API
1287	raptor_uri* raptor_new_uri_for_retrieval(raptor_uri* old_uri);
1288	RAPTOR_API
1289	void raptor_free_uri(raptor_uri *uri);
1290
1291	/ methods /
1292	RAPTOR_API
1293	int raptor_uri_equals(raptor_uri* uri1, raptor_uri* uri2);
1294	RAPTOR_API
1295	int raptor_uri_compare(raptor_uri* uri1, raptor_uri* uri2);
1296	RAPTOR_API
1297	raptor_uri* raptor_uri_copy(raptor_uri *uri);
1298	RAPTOR_API
1299	unsigned char* raptor_uri_as_string(raptor_uri *uri);
1300	RAPTOR_API
1301	unsigned char* raptor_uri_as_counted_string(raptor_uri uri, size_t len_p);
1302	RAPTOR_API
1303	unsigned char* raptor_uri_to_relative_counted_uri_string(raptor_uri base_uri, raptor_uri reference_uri, size_t *length_p);
1304	RAPTOR_API
1305	unsigned char* raptor_uri_to_relative_uri_string(raptor_uri base_uri, raptor_uri reference_uri);
1306	RAPTOR_API
1307	int raptor_uri_print(const raptor_uri* uri, FILE *stream);
1308	RAPTOR_API
1309	unsigned char* raptor_uri_to_counted_string(raptor_uri uri, size_t len_p);
1310	RAPTOR_API
1311	unsigned char* raptor_uri_to_string(raptor_uri *uri);
1312	RAPTOR_API
1313	raptor_world* raptor_uri_get_world(raptor_uri *uri);
1314	RAPTOR_API
1315	int raptor_uri_file_exists(raptor_uri* uri);
1316	RAPTOR_API
1317	int raptor_uri_escaped_write(raptor_uri* uri, raptor_uri* base_uri, unsigned int flags, raptor_iostream *iostr);
1318
1319	/ XML utility functions /
1320	RAPTOR_API
1321	int raptor_xml_escape_string_any(raptor_world* world, const unsigned char string, size_t len, unsigned* char buffer, size_t length, char* quote, int xml_version);
1322	RAPTOR_API
1323	int raptor_xml_escape_string_any_write(const unsigned char string, size_t len, char* quote, int xml_version, raptor_iostream* iostr);
1324	RAPTOR_API
1325	int raptor_xml_escape_string(raptor_world world, const* unsigned char string, size_t len, unsigned* char buffer, size_t length, char* quote);
1326	RAPTOR_API
1327	int raptor_xml_escape_string_write(const unsigned char string, size_t len, char* quote, raptor_iostream* iostr);
1328	RAPTOR_API
1329	int raptor_xml_name_check(const unsigned char string, size_t length, int* xml_version);
1330
1331
1332	/ portable vsnprintf utility function /
1333	RAPTOR_API RAPTOR_DEPRECATED
1334	char* raptor_vsnprintf(const char *format, va_list arguments) RAPTOR_PRINTF_FORMAT(`1`, `0`);
1335	RAPTOR_API
1336	int raptor_vsnprintf2(char buffer, size_t size, const* char *format, va_list arguments) RAPTOR_PRINTF_FORMAT(`3`, `0`);
1337	RAPTOR_API
1338	int raptor_snprintf(char buffer, size_t size, const* char *format, ...) RAPTOR_PRINTF_FORMAT(`3`, `4`);
1339	RAPTOR_API
1340	int raptor_vasprintf(char *ret, const* char *format, va_list arguments) RAPTOR_PRINTF_FORMAT(`2`, `0`);
1341
1342	/ RFC2396 URI resolving functions /
1343	RAPTOR_API
1344	size_t raptor_uri_resolve_uri_reference(const unsigned char base_uri, const* unsigned char reference_uri, unsigned* char* buffer, size_t length);
1345
1346	/ URI String utility functions /
1347	RAPTOR_API
1348	unsigned char* raptor_uri_filename_to_uri_string(const char *filename);
1349	RAPTOR_API
1350	int raptor_uri_filename_exists(const unsigned char* path);
1351	RAPTOR_API
1352	char* raptor_uri_uri_string_to_filename(const unsigned char *uri_string);
1353	RAPTOR_API
1354	char* raptor_uri_uri_string_to_filename_fragment(const unsigned char uri_string, unsigned* char **fragment_p);
1355	RAPTOR_API
1356	int raptor_uri_uri_string_is_file_uri(const unsigned char* uri_string);
1357	RAPTOR_API
1358	int raptor_stringbuffer_append_uri_escaped_counted_string(raptor_stringbuffer* sb, const char* string, size_t length, int space_is_plus);
1359	RAPTOR_API
1360	char* raptor_uri_uri_string_to_counted_filename_fragment(const unsigned char uri_string, size_t len_p, unsigned char *fragment_p, size_t fragment_len_p);
1361	RAPTOR_API
1362	int raptor_uri_uri_string_is_absolute(const unsigned char* uri_string);
1363
1364
1365	/**
1366	* RAPTOR_RDF_MS_URI:
1367	*
1368	* RDF Namespace URI (rdf:).
1369	*
1370	* Copy with raptor_uri_copy() to use.
1371	*/
1372	#define RAPTOR_RDF_MS_URI raptor_rdf_namespace_uri
1373
1374	/**
1375	* RAPTOR_RDF_SCHEMA_URI:
1376	*
1377	* RDF Schema Namespace URI (rdfs:).
1378	*
1379	* Copy with raptor_uri_copy() to use.
1380	*/
1381	#define RAPTOR_RDF_SCHEMA_URI raptor_rdf_schema_namespace_uri
1382
1383	/**
1384	* RAPTOR_XMLSCHEMA_DATATYPES_URI:
1385	*
1386	* XML Schema Datatypes URI (xsd:).
1387	*
1388	* Copy with raptor_uri_copy() to use.
1389	*/
1390	#define RAPTOR_XMLSCHEMA_DATATYPES_URI raptor_xmlschema_datatypes_namespace_uri
1391
1392	/**
1393	* RAPTOR_OWL_URI:
1394	*
1395	* OWL Namespace URI (owl:).
1396	*
1397	* Copy with raptor_uri_copy() to use.
1398	*/
1399	#define RAPTOR_OWL_URI raptor_owl_namespace_uri
1400
1401
1402	/ raptor_www /
1403	RAPTOR_API
1404	raptor_www* raptor_new_www(raptor_world* world);
1405	RAPTOR_API
1406	raptor_www* raptor_new_www_with_connection(raptor_world* world, void* connection);
1407	RAPTOR_API
1408	void raptor_free_www(raptor_www *www);
1409	RAPTOR_API
1410	int raptor_www_set_ssl_cert_options(raptor_www* www, const char* cert_filename, const char* cert_type, const char* cert_passphrase);
1411	RAPTOR_API
1412	int raptor_www_set_ssl_verify_options(raptor_www* www, int verify_peer, int verify_host);
1413	RAPTOR_API
1414	void raptor_www_set_user_agent(raptor_www www, const* char *user_agent);
1415	RAPTOR_API
1416	void raptor_www_set_proxy(raptor_www www, const* char *proxy);
1417	RAPTOR_API
1418	void raptor_www_set_http_accept(raptor_www www, const* char *value);
1419	RAPTOR_API
1420	void raptor_www_set_write_bytes_handler(raptor_www www, raptor_www_write_bytes_handler handler, void* *user_data);
1421	RAPTOR_API
1422	void raptor_www_set_content_type_handler(raptor_www www, raptor_www_content_type_handler handler, void* *user_data);
1423	RAPTOR_API
1424	void raptor_www_set_final_uri_handler(raptor_www* www, raptor_www_final_uri_handler handler, void *user_data);
1425	RAPTOR_API
1426	void raptor_www_set_uri_filter(raptor_www* www, raptor_uri_filter_func filter, void* user_data);
1427	RAPTOR_API
1428	void raptor_www_set_connection_timeout(raptor_www* www, int timeout);
1429	RAPTOR_API
1430	int raptor_www_set_http_cache_control(raptor_www* www, const char* cache_control);
1431	RAPTOR_API
1432	int raptor_www_fetch(raptor_www www, raptor_uri uri);
1433	RAPTOR_API
1434	int raptor_www_fetch_to_string(raptor_www www, raptor_uri uri, void *string_p, size_t length_p, raptor_data_malloc_handler const malloc_handler);
1435	RAPTOR_API
1436	void* raptor_www_get_connection(raptor_www *www);
1437	RAPTOR_API
1438	void raptor_www_abort(raptor_www www, const* char *reason);
1439	RAPTOR_API
1440	raptor_uri* raptor_www_get_final_uri(raptor_www* www);
1441
1442
1443	/ XML QNames Class /
1444	RAPTOR_API
1445	raptor_qname* raptor_new_qname(raptor_namespace_stack nstack, const* unsigned char name, const* unsigned char *value);
1446	RAPTOR_API
1447	raptor_qname* raptor_new_qname_from_namespace_local_name(raptor_world* world, raptor_namespace ns, const* unsigned char local_name, const* unsigned char *value);
1448
1449	/ methods /
1450	RAPTOR_API
1451	raptor_qname* raptor_qname_copy(raptor_qname *qname);
1452	RAPTOR_API
1453	void raptor_free_qname(raptor_qname* name);
1454	RAPTOR_API
1455	int raptor_qname_equal(raptor_qname name1, raptor_qname name2);
1456	RAPTOR_API
1457	unsigned char* raptor_qname_to_counted_name(raptor_qname qname, size_t length_p);
1458	RAPTOR_API
1459	const raptor_namespace* raptor_qname_get_namespace(raptor_qname* name);
1460	RAPTOR_API
1461	const unsigned char* raptor_qname_get_local_name(raptor_qname* name);
1462	RAPTOR_API
1463	const unsigned char* raptor_qname_get_value(raptor_qname* name);
1464	RAPTOR_API
1465	const unsigned char* raptor_qname_get_counted_value(raptor_qname* name, size_t* length_p);
1466	RAPTOR_API
1467	int raptor_qname_write(raptor_qname qname, raptor_iostream iostr);
1468
1469	/ QName String utility functions /
1470	RAPTOR_API
1471	raptor_uri* raptor_qname_string_to_uri(raptor_namespace_stack nstack, const* unsigned char *name, size_t name_len);
1472	RAPTOR_API
1473	unsigned char* raptor_qname_format_as_xml(const raptor_qname qname, size_t length_p);
1474
1475	/ XML Namespaces Stack class /
1476	RAPTOR_API
1477	raptor_namespace* raptor_new_namespace_from_uri(raptor_namespace_stack nstack, const* unsigned char prefix, raptor_uri ns_uri, int depth);
1478	RAPTOR_API
1479	raptor_namespace_stack* raptor_new_namespaces(raptor_world* world, int defaults);
1480	RAPTOR_API
1481	int raptor_namespaces_init(raptor_world* world, raptor_namespace_stack nstack, int* defaults);
1482	RAPTOR_API
1483	void raptor_namespaces_clear(raptor_namespace_stack *nstack);
1484	RAPTOR_API
1485	void raptor_free_namespaces(raptor_namespace_stack *nstack);
1486
1487	/ methods /
1488	RAPTOR_API
1489	void raptor_namespaces_start_namespace(raptor_namespace_stack nstack, raptor_namespace nspace);
1490	RAPTOR_API
1491	int raptor_namespaces_start_namespace_full(raptor_namespace_stack nstack, const* unsigned char prefix, const* unsigned char ns_uri_string, int* depth);
1492	RAPTOR_API
1493	void raptor_namespaces_end_for_depth(raptor_namespace_stack nstack, int* depth);
1494	RAPTOR_API
1495	raptor_namespace* raptor_namespaces_get_default_namespace(raptor_namespace_stack *nstack);
1496	RAPTOR_API
1497	raptor_namespace* raptor_namespaces_find_namespace(raptor_namespace_stack nstack, const* unsigned char prefix, int* prefix_length);
1498	RAPTOR_API
1499	raptor_namespace* raptor_namespaces_find_namespace_by_uri(raptor_namespace_stack nstack, raptor_uri ns_uri);
1500	RAPTOR_API
1501	int raptor_namespaces_namespace_in_scope(raptor_namespace_stack nstack, const* raptor_namespace *nspace);
1502	RAPTOR_API
1503	raptor_qname* raptor_new_qname_from_namespace_uri(raptor_namespace_stack nstack, raptor_uri uri, int xml_version);
1504
1505
1506	/ XML Namespace Class /
1507	RAPTOR_API
1508	raptor_namespace* raptor_new_namespace(raptor_namespace_stack nstack, const* unsigned char prefix, const* unsigned char ns_uri_string, int* depth);
1509	RAPTOR_API
1510	void raptor_free_namespace(raptor_namespace *ns);
1511	RAPTOR_API
1512	int raptor_namespace_stack_start_namespace(raptor_namespace_stack nstack, raptor_namespace ns, int new_depth);
1513	RAPTOR_API
1514	raptor_uri* raptor_namespace_get_uri(const raptor_namespace *ns);
1515	RAPTOR_API
1516	const unsigned char* raptor_namespace_get_prefix(const raptor_namespace *ns);
1517	RAPTOR_API
1518	const unsigned char* raptor_namespace_get_counted_prefix(const raptor_namespace ns, size_t length_p);
1519	RAPTOR_API
1520	unsigned char* raptor_namespace_format_as_xml(const raptor_namespace ns, size_t length_p);
1521	RAPTOR_API
1522	int raptor_namespace_write(raptor_namespace ns, raptor_iostream iostr);
1523
1524	/ namespace string utility function /
1525	RAPTOR_API
1526	int raptor_xml_namespace_string_parse(const unsigned char string, unsigned* char *prefix, unsigned* char **uri_string);
1527
1528	/ Sequence class /
1529	/**
1530	* raptor_sequence:
1531	*
1532	* Raptor sequence class
1533	*/
1534	typedef struct raptor_sequence_s raptor_sequence;
1535
1536	/ Sequence Class /
1537	RAPTOR_API
1538	raptor_sequence* raptor_new_sequence(raptor_data_free_handler free_handler, raptor_data_print_handler print_handler);
1539	RAPTOR_API
1540	raptor_sequence* raptor_new_sequence_with_context(raptor_data_context_free_handler free_handler, raptor_data_context_print_handler print_handler, void* handler_context);
1541	RAPTOR_API
1542	void raptor_free_sequence(raptor_sequence* seq);
1543
1544	/ methods /
1545	RAPTOR_API
1546	int raptor_sequence_size(raptor_sequence* seq);
1547	RAPTOR_API
1548	int raptor_sequence_set_at(raptor_sequence* seq, int idx, void *data);
1549	RAPTOR_API
1550	int raptor_sequence_push(raptor_sequence* seq, void *data);
1551	RAPTOR_API
1552	int raptor_sequence_shift(raptor_sequence* seq, void *data);
1553	RAPTOR_API
1554	void* raptor_sequence_get_at(raptor_sequence* seq, int idx);
1555	RAPTOR_API
1556	void* raptor_sequence_pop(raptor_sequence* seq);
1557	RAPTOR_API
1558	void* raptor_sequence_unshift(raptor_sequence* seq);
1559	RAPTOR_API
1560	void* raptor_sequence_delete_at(raptor_sequence* seq, int idx);
1561
1562	RAPTOR_API
1563	void raptor_sequence_sort(raptor_sequence* seq, raptor_data_compare_handler compare);
1564	RAPTOR_API
1565	int raptor_sequence_swap(raptor_sequence* seq, int i, int j);
1566	RAPTOR_API
1567	int raptor_sequence_reverse(raptor_sequence* seq, int start_index, int length);
1568	RAPTOR_API
1569	int raptor_sequence_next_permutation(raptor_sequence *seq, raptor_data_compare_handler compare);
1570
1571	/ helper for printing sequences of strings /
1572	RAPTOR_API
1573	int raptor_sequence_print(raptor_sequence* seq, FILE* fh);
1574	RAPTOR_API
1575	int raptor_sequence_join(raptor_sequence* dest, raptor_sequence *src);
1576
1577
1578	/ Unicode and UTF8 /
1579
1580	/**
1581	* raptor_unichar:
1582	*
1583	* raptor Unicode codepoint
1584	*/
1585	typedef unsigned long raptor_unichar;
1586	RAPTOR_API
1587	int raptor_unicode_utf8_string_put_char(raptor_unichar c, unsigned char *output, size_t length);
1588	RAPTOR_API
1589	int raptor_unicode_utf8_string_get_char(const unsigned char input, size_t length, raptor_unichar output);
1590	RAPTOR_API
1591	int raptor_unicode_is_xml11_namestartchar(raptor_unichar c);
1592	RAPTOR_API
1593	int raptor_unicode_is_xml10_namestartchar(raptor_unichar c);
1594	RAPTOR_API
1595	int raptor_unicode_is_xml11_namechar(raptor_unichar c);
1596	RAPTOR_API
1597	int raptor_unicode_is_xml10_namechar(raptor_unichar c);
1598	RAPTOR_API
1599	int raptor_unicode_check_utf8_string(const unsigned char *string, size_t length);
1600	RAPTOR_API
1601	int raptor_unicode_utf8_strlen(const unsigned char *string, size_t length);
1602	RAPTOR_API
1603	size_t raptor_unicode_utf8_substr(unsigned char* dest, size_t* dest_length_p, const unsigned char* src, size_t src_length, int startingLoc, int length);
1604
1605	/ Stringbuffer Class /
1606	RAPTOR_API
1607	raptor_stringbuffer* raptor_new_stringbuffer(void);
1608	RAPTOR_API
1609	void raptor_free_stringbuffer(raptor_stringbuffer *stringbuffer);
1610
1611	/ methods /
1612	RAPTOR_API
1613	int raptor_stringbuffer_append_counted_string(raptor_stringbuffer* stringbuffer, const unsigned char string, size_t length, int* do_copy);
1614	RAPTOR_API
1615	int raptor_stringbuffer_append_string(raptor_stringbuffer* stringbuffer, const unsigned char string, int* do_copy);
1616	RAPTOR_API
1617	int raptor_stringbuffer_append_decimal(raptor_stringbuffer* stringbuffer, int integer);
1618	RAPTOR_API
1619	int raptor_stringbuffer_append_hexadecimal(raptor_stringbuffer* stringbuffer, int hex);
1620	RAPTOR_API
1621	int raptor_stringbuffer_append_stringbuffer(raptor_stringbuffer* stringbuffer, raptor_stringbuffer* append);
1622	RAPTOR_API
1623	int raptor_stringbuffer_prepend_counted_string(raptor_stringbuffer* stringbuffer, const unsigned char string, size_t length, int* do_copy);
1624	RAPTOR_API
1625	int raptor_stringbuffer_prepend_string(raptor_stringbuffer* stringbuffer, const unsigned char string, int* do_copy);
1626	RAPTOR_API
1627	unsigned char* raptor_stringbuffer_as_string(raptor_stringbuffer* stringbuffer);
1628	RAPTOR_API
1629	size_t raptor_stringbuffer_length(raptor_stringbuffer* stringbuffer);
1630	RAPTOR_API
1631	int raptor_stringbuffer_copy_to_string(raptor_stringbuffer* stringbuffer, unsigned char *string, size_t length);
1632
1633	/**
1634	* raptor_iostream_init_func:
1635	* @context: stream context data
1636	*
1637	* Handler function for #raptor_iostream initialising.
1638	*
1639	* Return value: non-0 on failure.
1640	*/
1641	typedef int (raptor_iostream_init_func) (void* *context);
1642
1643	/**
1644	* raptor_iostream_finish_func:
1645	* @context: stream context data
1646	*
1647	* Handler function for #raptor_iostream terminating.
1648	*
1649	*/
1650	typedef void (raptor_iostream_finish_func) (void* *context);
1651
1652	/**
1653	* raptor_iostream_write_byte_func
1654	* @context: stream context data
1655	* @byte: byte to write
1656	*
1657	* Handler function for implementing raptor_iostream_write_byte().
1658	*
1659	* Return value: non-0 on failure.
1660	*/
1661	typedef int (raptor_iostream_write_byte_func) (void* context, const* int byte);
1662
1663	/**
1664	* raptor_iostream_write_bytes_func:
1665	* @context: stream context data
1666	* @ptr: pointer to bytes to write
1667	* @size: size of item
1668	* @nmemb: number of items
1669	*
1670	* Handler function for implementing raptor_iostream_write_bytes().
1671	*
1672	* Return value: non-0 on failure.
1673	*/
1674	typedef int (raptor_iostream_write_bytes_func) (void* context, const* void *ptr, size_t size, size_t nmemb);
1675
1676	/**
1677	* raptor_iostream_write_end_func:
1678	* @context: stream context data
1679	*
1680	* Handler function for implementing raptor_iostream_write_end().
1681	*
1682	* Return value: non-0 on failure.
1683	*/
1684	typedef int (raptor_iostream_write_end_func) (void* *context);
1685
1686	/**
1687	* raptor_iostream_read_bytes_func:
1688	* @context: stream context data
1689	* @ptr: pointer to buffer to read into
1690	* @size: size of buffer
1691	* @nmemb: number of items
1692	*
1693	* Handler function for implementing raptor_iostream_read_bytes().
1694	*
1695	* Return value: number of items read, 0 or < @size on EOF, <0 on failure
1696	*/
1697	typedef int (raptor_iostream_read_bytes_func) (void* context, void* *ptr, size_t size, size_t nmemb);
1698
1699	/**
1700	* raptor_iostream_read_eof_func:
1701	* @context: stream context data
1702	*
1703	* Handler function for implementing raptor_iostream_read_eof().
1704	*
1705	* Return value: non-0 if EOF
1706	*/
1707	typedef int (raptor_iostream_read_eof_func) (void* *context);
1708
1709	/**
1710	* raptor_iostream_handler:
1711	* @version: interface version. Presently 1 or 2.
1712	* @init: initialisation handler - optional, called at most once (V1)
1713	* @finish: finishing handler - optional, called at most once (V1)
1714	* @write_byte: write byte handler - required (for writing) (V1)
1715	* @write_bytes: write bytes handler - required (for writing) (V1)
1716	* @write_end: write end handler - optional (for writing), called at most once (V1)
1717	* @read_bytes: read bytes handler - required (for reading) (V2)
1718	* @read_eof: read EOF handler - required (for reading) (V2)
1719	*
1720	* I/O stream implementation handler structure.
1721	*
1722	*/
1723	typedef struct {
1724	int version;
1725
1726	/ V1 functions /
1727	raptor_iostream_init_func init;
1728	raptor_iostream_finish_func finish;
1729	raptor_iostream_write_byte_func write_byte;
1730	raptor_iostream_write_bytes_func write_bytes;
1731	raptor_iostream_write_end_func write_end;
1732
1733	/ V2 functions /
1734	raptor_iostream_read_bytes_func read_bytes;
1735	raptor_iostream_read_eof_func read_eof;
1736	} raptor_iostream_handler;
1737
1738
1739	/ I/O Stream Class /
1740	RAPTOR_API
1741	raptor_iostream* raptor_new_iostream_from_handler(raptor_world* world, void user_data, const* raptor_iostream_handler* const handler);
1742	RAPTOR_API
1743	raptor_iostream* raptor_new_iostream_to_sink(raptor_world* world);
1744	RAPTOR_API
1745	raptor_iostream* raptor_new_iostream_to_filename(raptor_world* world, const char *filename);
1746	RAPTOR_API
1747	raptor_iostream* raptor_new_iostream_to_file_handle(raptor_world* world, FILE *handle);
1748	RAPTOR_API
1749	raptor_iostream* raptor_new_iostream_to_string(raptor_world* world, void *string_p, size_t length_p, raptor_data_malloc_handler const malloc_handler);
1750	RAPTOR_API
1751	raptor_iostream* raptor_new_iostream_from_sink(raptor_world* world);
1752	RAPTOR_API
1753	raptor_iostream* raptor_new_iostream_from_filename(raptor_world* world, const char *filename);
1754	RAPTOR_API
1755	raptor_iostream* raptor_new_iostream_from_file_handle(raptor_world* world, FILE *handle);
1756	RAPTOR_API
1757	raptor_iostream* raptor_new_iostream_from_string(raptor_world* world, void *string, size_t length);
1758	RAPTOR_API
1759	void raptor_free_iostream(raptor_iostream *iostr);
1760
1761	RAPTOR_API
1762	int raptor_iostream_write_bytes(const void ptr, size_t size, size_t nmemb, raptor_iostream iostr);
1763	RAPTOR_API
1764	int raptor_iostream_write_byte(const int byte, raptor_iostream *iostr);
1765	RAPTOR_API
1766	int raptor_iostream_write_end(raptor_iostream *iostr);
1767	RAPTOR_API
1768	int raptor_iostream_string_write(const void string, raptor_iostream iostr);
1769	RAPTOR_API
1770	int raptor_iostream_counted_string_write(const void string, size_t len, raptor_iostream iostr);
1771	RAPTOR_API
1772	unsigned long raptor_iostream_tell(raptor_iostream *iostr);
1773	RAPTOR_API
1774	int raptor_iostream_decimal_write(int integer, raptor_iostream* iostr);
1775	RAPTOR_API
1776	int raptor_iostream_hexadecimal_write(unsigned int integer, int width, raptor_iostream* iostr);
1777	RAPTOR_API
1778	int raptor_stringbuffer_write(raptor_stringbuffer sb, raptor_iostream iostr);
1779	RAPTOR_API
1780	int raptor_uri_write(raptor_uri uri, raptor_iostream iostr);
1781	RAPTOR_API
1782	int raptor_iostream_read_bytes(void ptr, size_t size, size_t nmemb, raptor_iostream iostr);
1783	RAPTOR_API
1784	int raptor_iostream_read_eof(raptor_iostream *iostr);
1785
1786	/ I/O Stream utility functions /
1787
1788	/**
1789	* raptor_escaped_write_bitflags:
1790	* @RAPTOR_ESCAPED_WRITE_BITFLAG_BS_ESCAPES_BF : Allow \b \f,
1791	* @RAPTOR_ESCAPED_WRITE_BITFLAG_BS_ESCAPES_TNRU : ALlow \t \n \r \u
1792	* @RAPTOR_ESCAPED_WRITE_BITFLAG_UTF8 : Allow UTF-8 for printable U *
1793	* @RAPTOR_ESCAPED_WRITE_BITFLAG_SPARQL_URI_ESCAPES: Must escape #x00-#x20<>\"{}\|^` in URIs
1794	* @RAPTOR_ESCAPED_WRITE_NTRIPLES_LITERAL: N-Triples literal
1795	* @RAPTOR_ESCAPED_WRITE_NTRIPLES_URI: N-Triples URI
1796	* @RAPTOR_ESCAPED_WRITE_SPARQL_LITERAL: SPARQL literal: allows raw UTF8 for printable literals
1797	* @RAPTOR_ESCAPED_WRITE_SPARQL_LONG_LITERAL: SPARQL long literal: no BS-escapes allowed
1798	* @RAPTOR_ESCAPED_WRITE_SPARQL_URI: SPARQL uri: have to escape certain characters
1799	* @RAPTOR_ESCAPED_WRITE_TURTLE_URI: Turtle 2013 URIs (like SPARQL)
1800	* @RAPTOR_ESCAPED_WRITE_TURTLE_LITERAL: Turtle 2013 literals (like SPARQL)
1801	* @RAPTOR_ESCAPED_WRITE_TURTLE_LONG_LITERAL: Turtle 2013 long literals (like SPARQL)
1802	* @RAPTOR_ESCAPED_WRITE_JSON_LITERAL: JSON literals: \b \f \t \r \n and \u \U
1803	*
1804	* Bit flags for raptor_string_escaped_write() and friends.
1805	*/
1806	typedef enum {
1807	RAPTOR_ESCAPED_WRITE_BITFLAG_BS_ESCAPES_BF = `1`,
1808	RAPTOR_ESCAPED_WRITE_BITFLAG_BS_ESCAPES_TNRU = `2`,
1809	RAPTOR_ESCAPED_WRITE_BITFLAG_UTF8 = `4`,
1810	RAPTOR_ESCAPED_WRITE_BITFLAG_SPARQL_URI_ESCAPES = `8`,
1811
1812	/ N-Triples - favour writing \u, \U over UTF8 /
1813	RAPTOR_ESCAPED_WRITE_NTRIPLES_LITERAL = RAPTOR_ESCAPED_WRITE_BITFLAG_BS_ESCAPES_TNRU \| RAPTOR_ESCAPED_WRITE_BITFLAG_BS_ESCAPES_BF,
1814	RAPTOR_ESCAPED_WRITE_NTRIPLES_URI = RAPTOR_ESCAPED_WRITE_BITFLAG_SPARQL_URI_ESCAPES,
1815
1816	/ SPARQL literal: allows raw UTF8 for printable literals /
1817	RAPTOR_ESCAPED_WRITE_SPARQL_LITERAL = RAPTOR_ESCAPED_WRITE_BITFLAG_UTF8,
1818
1819	/ SPARQL long literal: no BS-escapes allowed /
1820	RAPTOR_ESCAPED_WRITE_SPARQL_LONG_LITERAL = RAPTOR_ESCAPED_WRITE_BITFLAG_UTF8,
1821
1822	/ SPARQL uri: have to escape certain characters /
1823	RAPTOR_ESCAPED_WRITE_SPARQL_URI = RAPTOR_ESCAPED_WRITE_BITFLAG_UTF8 \| RAPTOR_ESCAPED_WRITE_BITFLAG_SPARQL_URI_ESCAPES,
1824
1825	/ Turtle (2013) escapes are like SPARQL /
1826	RAPTOR_ESCAPED_WRITE_TURTLE_URI = RAPTOR_ESCAPED_WRITE_SPARQL_URI,
1827	RAPTOR_ESCAPED_WRITE_TURTLE_LITERAL = RAPTOR_ESCAPED_WRITE_SPARQL_LITERAL,
1828	RAPTOR_ESCAPED_WRITE_TURTLE_LONG_LITERAL = RAPTOR_ESCAPED_WRITE_SPARQL_LONG_LITERAL,
1829
1830	/ JSON literals: \b \f \t \r \n and \u \U /
1831	RAPTOR_ESCAPED_WRITE_JSON_LITERAL = RAPTOR_ESCAPED_WRITE_BITFLAG_BS_ESCAPES_TNRU \| RAPTOR_ESCAPED_WRITE_BITFLAG_BS_ESCAPES_BF
1832	} raptor_escaped_write_bitflags;
1833
1834
1835	RAPTOR_API
1836	int raptor_string_ntriples_write(const unsigned char string, size_t len, const* char delim, raptor_iostream *iostr);
1837	RAPTOR_API
1838	int raptor_bnodeid_ntriples_write(const unsigned char bnodeid, size_t len, raptor_iostream iostr);
1839	RAPTOR_API RAPTOR_DEPRECATED
1840	int raptor_string_python_write(const unsigned char string, size_t len, const* char delim, unsigned int mode, raptor_iostream *iostr);
1841	RAPTOR_API
1842	int raptor_statement_ntriples_write(const raptor_statement statement, raptor_iostream iostr, int write_graph_term);
1843	RAPTOR_API
1844	int raptor_string_escaped_write(const unsigned char string, size_t len, const* char delim, unsigned int flags, raptor_iostream *iostr);
1845
1846
1847	/ Parser and Serializer options /
1848
1849	/**
1850	* raptor_option_value_type:
1851	* @RAPTOR_OPTION_VALUE_TYPE_BOOL: Boolean integer value. Non-0 is true
1852	* @RAPTOR_OPTION_VALUE_TYPE_INT: Decimal integer value
1853	* @RAPTOR_OPTION_VALUE_TYPE_STRING: String value
1854	* @RAPTOR_OPTION_VALUE_TYPE_URI: URI String value.
1855	* @RAPTOR_OPTION_VALUE_TYPE_LAST: internal
1856	*
1857	* Option value types.
1858	*/
1859	typedef enum {
1860	RAPTOR_OPTION_VALUE_TYPE_BOOL,
1861	RAPTOR_OPTION_VALUE_TYPE_INT,
1862	RAPTOR_OPTION_VALUE_TYPE_STRING,
1863	RAPTOR_OPTION_VALUE_TYPE_URI,
1864	RAPTOR_OPTION_VALUE_TYPE_LAST = RAPTOR_OPTION_VALUE_TYPE_URI
1865	} raptor_option_value_type;
1866
1867
1868	/**
1869	* raptor_option_description:
1870	* @domain: domain ID
1871	* @option: option ID
1872	* @value_type: data type of option value
1873	* @name: short name for option
1874	* @name_len: length of @name
1875	* @label: description of option
1876	* @uri: URI identifying option
1877	*
1878	* Description of an option for a domain.
1879	*/
1880	typedef struct {
1881	raptor_domain domain;
1882	raptor_option option;
1883	raptor_option_value_type value_type;
1884	const char* name;
1885	size_t name_len;
1886	const char* label;
1887	raptor_uri* uri;
1888	} raptor_option_description;
1889
1890
1891	RAPTOR_API
1892	unsigned int raptor_option_get_count(void);
1893	RAPTOR_API
1894	const char* raptor_option_get_value_type_label(const raptor_option_value_type type);
1895	RAPTOR_API
1896	void raptor_free_option_description(raptor_option_description* option_description);
1897	RAPTOR_API
1898	raptor_option_description* raptor_world_get_option_description(raptor_world* world, const raptor_domain domain, const raptor_option option);
1899
1900
1901	/ SAX2 element Class (raptor_xml_element) /
1902	RAPTOR_API
1903	raptor_xml_element* raptor_new_xml_element(raptor_qname* name, const unsigned char* xml_language, raptor_uri* xml_base);
1904	RAPTOR_API
1905	raptor_xml_element* raptor_new_xml_element_from_namespace_local_name(raptor_namespace ns, const* unsigned char name, const* unsigned char xml_language, raptor_uri xml_base);
1906	RAPTOR_API
1907	void raptor_free_xml_element(raptor_xml_element *element);
1908
1909	/ methods /
1910	RAPTOR_API
1911	raptor_qname* raptor_xml_element_get_name(raptor_xml_element *xml_element);
1912	RAPTOR_API
1913	void raptor_xml_element_set_attributes(raptor_xml_element* xml_element, raptor_qname *attributes, int* count);
1914	RAPTOR_API
1915	raptor_qname** raptor_xml_element_get_attributes(raptor_xml_element* xml_element);
1916	RAPTOR_API
1917	int raptor_xml_element_get_attributes_count(raptor_xml_element* xml_element);
1918	RAPTOR_API
1919	int raptor_xml_element_declare_namespace(raptor_xml_element* xml_element, raptor_namespace *nspace);
1920	RAPTOR_API
1921	int raptor_xml_element_write(raptor_xml_element element, raptor_namespace_stack nstack, int is_empty, int is_end, int depth, raptor_iostream *iostr);
1922	RAPTOR_API
1923	int raptor_xml_element_is_empty(raptor_xml_element* xml_element);
1924	RAPTOR_API
1925	const unsigned char* raptor_xml_element_get_language(raptor_xml_element* xml_element);
1926
1927
1928	/ XML Writer Class (raptor_xml_writer) /
1929	RAPTOR_API
1930	raptor_xml_writer* raptor_new_xml_writer(raptor_world* world, raptor_namespace_stack nstack, raptor_iostream iostr);
1931	RAPTOR_API
1932	void raptor_free_xml_writer(raptor_xml_writer* xml_writer);
1933
1934	/ methods /
1935	RAPTOR_API
1936	void raptor_xml_writer_empty_element(raptor_xml_writer* xml_writer, raptor_xml_element *element);
1937	RAPTOR_API
1938	void raptor_xml_writer_start_element(raptor_xml_writer* xml_writer, raptor_xml_element *element);
1939	RAPTOR_API
1940	void raptor_xml_writer_end_element(raptor_xml_writer* xml_writer, raptor_xml_element *element);
1941	RAPTOR_API
1942	void raptor_xml_writer_newline(raptor_xml_writer* xml_writer);
1943	RAPTOR_API
1944	void raptor_xml_writer_cdata(raptor_xml_writer* xml_writer, const unsigned char *s);
1945	RAPTOR_API
1946	void raptor_xml_writer_cdata_counted(raptor_xml_writer* xml_writer, const unsigned char s, unsigned* int len);
1947	RAPTOR_API
1948	void raptor_xml_writer_raw(raptor_xml_writer* xml_writer, const unsigned char *s);
1949	RAPTOR_API
1950	void raptor_xml_writer_raw_counted(raptor_xml_writer* xml_writer, const unsigned char s, unsigned* int len);
1951	RAPTOR_API
1952	void raptor_xml_writer_comment(raptor_xml_writer* xml_writer, const unsigned char *s);
1953	RAPTOR_API
1954	void raptor_xml_writer_comment_counted(raptor_xml_writer* xml_writer, const unsigned char s, unsigned* int len);
1955	RAPTOR_API
1956	void raptor_xml_writer_flush(raptor_xml_writer* xml_writer);
1957	RAPTOR_API
1958	int raptor_xml_writer_set_option(raptor_xml_writer xml_writer, raptor_option option, char** string, int integer);
1959	RAPTOR_API
1960	int raptor_xml_writer_get_option(raptor_xml_writer xml_writer, raptor_option option, char*** string_p, int* integer_p);
1961	RAPTOR_API
1962	int raptor_xml_writer_get_depth(raptor_xml_writer *xml_writer);
1963
1964	/**
1965	* raptor_sax2_start_element_handler:
1966	* @user_data: user data
1967	* @xml_element: XML element
1968	*
1969	* SAX2 start element handler
1970	*/
1971	typedef void (raptor_sax2_start_element_handler)(void* user_data, raptor_xml_element xml_element);
1972
1973	/**
1974	* raptor_sax2_end_element_handler:
1975	* @user_data: user data
1976	* @xml_element: XML element
1977	*
1978	* SAX2 end element handler
1979	*/
1980	typedef void (raptor_sax2_end_element_handler)(void* user_data, raptor_xml_element xml_element);
1981
1982	/**
1983	* raptor_sax2_characters_handler:
1984	* @user_data: user data
1985	* @xml_element: XML element
1986	* @s: string
1987	* @len: string len
1988	*
1989	* SAX2 characters handler
1990	*/
1991	typedef void (raptor_sax2_characters_handler)(void* user_data, raptor_xml_element xml_element, const unsigned char s, int* len);
1992
1993	/**
1994	* raptor_sax2_cdata_handler:
1995	* @user_data: user data
1996	* @xml_element: XML element
1997	* @s: string
1998	* @len: string len
1999
2000	* SAX2 CDATA section handler
2001	*/
2002	typedef void (raptor_sax2_cdata_handler)(void* user_data, raptor_xml_element xml_element, const unsigned char s, int* len);
2003
2004	/**
2005	* raptor_sax2_comment_handler:
2006	* @user_data: user data
2007	* @xml_element: XML element
2008	* @s: string
2009	*
2010	* SAX2 XML comment handler
2011	*/
2012	typedef void (raptor_sax2_comment_handler)(void* user_data, raptor_xml_element xml_element, const unsigned char *s);
2013
2014	/**
2015	* raptor_sax2_unparsed_entity_decl_handler:
2016	* @user_data: user data
2017	* @entityName: entity name
2018	* @base: base URI
2019	* @systemId: system ID
2020	* @publicId: public ID
2021	* @notationName: notation name
2022	*
2023	* SAX2 unparsed entity (NDATA) handler
2024	*/
2025	typedef void (raptor_sax2_unparsed_entity_decl_handler)(void* user_data, const* unsigned char* entityName, const unsigned char* base, const unsigned char* systemId, const unsigned char* publicId, const unsigned char* notationName);
2026
2027	/**
2028	* raptor_sax2_external_entity_ref_handler:
2029	* @user_data: user data
2030	* @context: context
2031	* @base: base URI
2032	* @systemId: system ID
2033	* @publicId: public ID
2034	*
2035	* SAX2 external entity reference handler
2036	*
2037	* Return value: 0 if processing should not continue because of a
2038	* fatal error in the handling of the external entity.
2039	*/
2040	typedef int (raptor_sax2_external_entity_ref_handler)(void* user_data, const* unsigned char* context, const unsigned char* base, const unsigned char* systemId, const unsigned char* publicId);
2041
2042
2043	/ SAX2 API /
2044	RAPTOR_API
2045	raptor_sax2* raptor_new_sax2(raptor_world world, raptor_locator locator, void* user_data);
2046	RAPTOR_API
2047	void raptor_free_sax2(raptor_sax2 *sax2);
2048
2049	/ methods /
2050	RAPTOR_API
2051	void raptor_sax2_set_start_element_handler(raptor_sax2* sax2, raptor_sax2_start_element_handler handler);
2052	RAPTOR_API
2053	void raptor_sax2_set_end_element_handler(raptor_sax2* sax2, raptor_sax2_end_element_handler handler);
2054	RAPTOR_API
2055	void raptor_sax2_set_characters_handler(raptor_sax2* sax2, raptor_sax2_characters_handler handler);
2056	RAPTOR_API
2057	void raptor_sax2_set_cdata_handler(raptor_sax2* sax2, raptor_sax2_cdata_handler handler);
2058	RAPTOR_API
2059	void raptor_sax2_set_comment_handler(raptor_sax2* sax2, raptor_sax2_comment_handler handler);
2060	RAPTOR_API
2061	void raptor_sax2_set_unparsed_entity_decl_handler(raptor_sax2* sax2, raptor_sax2_unparsed_entity_decl_handler handler);
2062	RAPTOR_API
2063	void raptor_sax2_set_external_entity_ref_handler(raptor_sax2* sax2, raptor_sax2_external_entity_ref_handler handler);
2064	RAPTOR_API
2065	void raptor_sax2_set_namespace_handler(raptor_sax2* sax2, raptor_namespace_handler handler);
2066	RAPTOR_API
2067	void raptor_sax2_set_uri_filter(raptor_sax2* sax2, raptor_uri_filter_func filter, void *user_data);
2068	RAPTOR_API
2069	void raptor_sax2_parse_start(raptor_sax2 sax2, raptor_uri base_uri);
2070	RAPTOR_API
2071	int raptor_sax2_parse_chunk(raptor_sax2* sax2, const unsigned char buffer, size_t len, int* is_end);
2072	RAPTOR_API
2073	const unsigned char* raptor_sax2_inscope_xml_language(raptor_sax2* sax2);
2074	RAPTOR_API
2075	raptor_uri* raptor_sax2_inscope_base_uri(raptor_sax2* sax2);
2076
2077
2078
2079	/ AVL Trees /
2080
2081	/**
2082	* raptor_avltree:
2083	*
2084	* AVL Tree
2085	*/
2086	typedef struct raptor_avltree_s raptor_avltree;
2087
2088	/**
2089	* raptor_avltree_iterator:
2090	*
2091	* AVL Tree Iterator as created by raptor_new_avltree_iterator()
2092	*/
2093	typedef struct raptor_avltree_iterator_s raptor_avltree_iterator;
2094
2095	/**
2096	* raptor_avltree_visit_handler:
2097	* @depth: depth of object in tree
2098	* @data: data object being visited
2099	* @user_data: user data arg to raptor_avltree_visit()
2100	*
2101	* AVL Tree visitor function as given to raptor_avltree_visit()
2102	*
2103	* Return value: non-0 to terminate visit early.
2104	*/
2105	typedef int (raptor_avltree_visit_handler)(int* depth, void* data, void *user_data);
2106
2107
2108	/**
2109	* raptor_avltree_bitflags:
2110	* @RAPTOR_AVLTREE_FLAG_REPLACE_DUPLICATES: If set raptor_avltree_add() will replace any duplicate items. If not set, raptor_avltree_add() will not replace them and will return status >0 when adding a duplicate. (Default is not set)
2111	*
2112	* Bit flags for AVL Tree class constructor raptor_new_avltree()
2113	**/
2114	typedef enum {
2115	RAPTOR_AVLTREE_FLAG_REPLACE_DUPLICATES = `1`
2116	} raptor_avltree_bitflags;
2117
2118
2119	RAPTOR_API
2120	raptor_avltree* raptor_new_avltree(raptor_data_compare_handler compare_handler, raptor_data_free_handler free_handler, unsigned int flags);
2121	RAPTOR_API
2122	void raptor_free_avltree(raptor_avltree* tree);
2123
2124	/ methods /
2125	RAPTOR_API
2126	int raptor_avltree_add(raptor_avltree* tree, void* p_data);
2127	RAPTOR_API
2128	void* raptor_avltree_remove(raptor_avltree* tree, void* p_data);
2129	RAPTOR_API
2130	int raptor_avltree_delete(raptor_avltree* tree, void* p_data);
2131	RAPTOR_API
2132	void* raptor_avltree_search(raptor_avltree* tree, const void* p_data);
2133	RAPTOR_API
2134	int raptor_avltree_visit(raptor_avltree* tree, raptor_avltree_visit_handler visit_handler, void* user_data);
2135	RAPTOR_API
2136	int raptor_avltree_size(raptor_avltree* tree);
2137	RAPTOR_API
2138	void raptor_avltree_set_print_handler(raptor_avltree* tree, raptor_data_print_handler print_handler);
2139	RAPTOR_API
2140	int raptor_avltree_print(raptor_avltree* tree, FILE* stream);
2141
2142	RAPTOR_API
2143	raptor_avltree_iterator* raptor_new_avltree_iterator(raptor_avltree* tree, void* range, raptor_data_free_handler range_free_handler, int direction);
2144	RAPTOR_API
2145	void raptor_free_avltree_iterator(raptor_avltree_iterator* iterator);
2146
2147	RAPTOR_API
2148	int raptor_avltree_iterator_is_end(raptor_avltree_iterator* iterator);
2149	RAPTOR_API
2150	int raptor_avltree_iterator_next(raptor_avltree_iterator* iterator);
2151	RAPTOR_API
2152	void* raptor_avltree_iterator_get(raptor_avltree_iterator* iterator);
2153
2154
2155	#ifdef __cplusplus
2156	}
2157	#endif
2158
2159	#endif
2160