From 05f3e795bebbf51c1a5a859cd015d5dbd74c21f9 Mon Sep 17 00:00:00 2001 From: David Robillard Date: Wed, 19 Jan 2011 07:24:09 +0000 Subject: Initial import. git-svn-id: http://svn.drobilla.net/serd/trunk@2 490d8e77-9747-427b-9fa3-0b8f29cee8a0 --- serd/serd.h | 194 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 194 insertions(+) create mode 100644 serd/serd.h (limited to 'serd') diff --git a/serd/serd.h b/serd/serd.h new file mode 100644 index 00000000..0e5d3029 --- /dev/null +++ b/serd/serd.h @@ -0,0 +1,194 @@ +/* Serd, an RDF serialisation library. + * Copyright 2011 David Robillard + * + * Serd is free software: you can redistribute it and/or modify it under + * the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * Serd is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public + * License for details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program. If not, see . + */ + +#ifndef SERD_SERD_H +#define SERD_SERD_H + +#include +#include +#include +#include + +#ifdef SERD_SHARED + #if defined _WIN32 || defined __CYGWIN__ + #define SERD_LIB_IMPORT __declspec(dllimport) + #define SERD_LIB_EXPORT __declspec(dllexport) + #else + #define SERD_LIB_IMPORT __attribute__ ((visibility("default"))) + #define SERD_LIB_EXPORT __attribute__ ((visibility("default"))) + #endif + #ifdef SERD_INTERNAL + #define SERD_API SERD_LIB_EXPORT + #else + #define SERD_API SERD_LIB_IMPORT + #endif +#else + #define SERD_API +#endif + +typedef enum { + SERD_TURTLE = 1, + SERD_NTRIPLES = 2 +} SerdSyntax; + + +/** @defgroup string Measured UTF-8 string + * @{ + */ + +typedef struct { + size_t n_bytes; + size_t n_chars; + uint8_t buf[]; +} SerdString; + +SERD_API +SerdString* +serd_string_new(const uint8_t* utf8); + +SERD_API +SerdString* +serd_string_copy(const SerdString* s); + +typedef enum { + BLANK = 1, + URI = 2, + QNAME = 3, + LITERAL = 4 +} SerdNodeType; + +/** @} */ + + +/** @defgroup uri Parsed URI + * @{ + */ + +typedef struct { + const uint8_t* buf; + size_t len; +} SerdRange; + +typedef struct { + SerdRange scheme; + SerdRange authority; + SerdRange path_base; + SerdRange path; + SerdRange query; + SerdRange fragment; + bool base_uri_has_authority; +} SerdURI; + +SERD_API +bool +serd_uri_string_is_relative(const uint8_t* utf8); + +SERD_API +bool +serd_uri_parse(const uint8_t* utf8, SerdURI* out); + +SERD_API +bool +serd_uri_resolve(const SerdURI* uri, const SerdURI* base, SerdURI* out); + +SERD_API +bool +serd_uri_write(const SerdURI* uri, FILE* file); + +SERD_API +SerdString* +serd_uri_serialise(const SerdURI* uri, + SerdURI* out); + +/** @} */ + + +/** @defgroup reader Reader for RDF syntax + * @{ + */ + +typedef struct SerdReaderImpl* SerdReader; + +typedef bool (*SerdBaseHandler)(void* handle, + const SerdString* uri); + +typedef bool (*SerdPrefixHandler)(void* handle, + const SerdString* name, + const SerdString* uri); + +typedef bool (*SerdStatementHandler)(void* handle, + const SerdString* graph, + const SerdString* subject, + SerdNodeType subject_type, + const SerdString* predicate, + SerdNodeType predicate_type, + const SerdString* object, + SerdNodeType object_type, + const SerdString* object_lang, + const SerdString* object_datatype); + +SERD_API +SerdReader +serd_reader_new(SerdSyntax syntax, + void* handle, + SerdBaseHandler base_handler, + SerdPrefixHandler prefix_handler, + SerdStatementHandler statement_handler); + +SERD_API +bool +serd_reader_read_file(SerdReader reader, + FILE* file, + const uint8_t* name); + +SERD_API +void +serd_reader_free(SerdReader reader); + +/** @} */ + + +/** @defgroup namespaces Namespaces (prefixes for CURIEs) + * @{ + */ + +typedef struct SerdNamespacesImpl* SerdNamespaces; + +SERD_API +SerdNamespaces +serd_namespaces_new(); + +SERD_API +void +serd_namespaces_free(SerdNamespaces ns); + +SERD_API +void +serd_namespaces_add(SerdNamespaces ns, + const SerdString* name, + const SerdString* uri); + +SERD_API +bool +serd_namespaces_expand(SerdNamespaces ns, + const SerdString* qname, + SerdRange* uri_prefix, + SerdRange* uri_suffix); + +/** @} */ + +#endif /* SERD_SERD_H */ -- cgit v1.2.1