1
0
mirror of https://github.com/cookiengineer/audacity synced 2025-05-05 22:28:57 +02:00
2010-01-24 09:19:39 +00:00

191 lines
5.9 KiB
C

/* -*- Mode: c; c-basic-offset: 2 -*-
*
* rdf_node.h - RDF Node definition
*
* Copyright (C) 2000-2008, David Beckett http://www.dajobe.org/
* Copyright (C) 2000-2004, University of Bristol, UK http://www.bristol.ac.uk/
*
* This package is Free Software and part of Redland http://librdf.org/
*
* It is licensed under the following three licenses as alternatives:
* 1. GNU Lesser General Public License (LGPL) V2.1 or any newer version
* 2. GNU General Public License (GPL) V2 or any newer version
* 3. Apache License, V2.0 or any newer version
*
* You may not use this file except in compliance with at least one of
* the above three licenses.
*
* See LICENSE.html or LICENSE.txt at the top of this package for the
* complete terms and further detail along with the license texts for
* the licenses in COPYING.LIB, COPYING and LICENSE-2.0.txt respectively.
*
*
*/
#ifndef LIBRDF_NODE_H
#define LIBRDF_NODE_H
#ifndef LIBRDF_OBJC_FRAMEWORK
#include <rdf_uri.h>
#else
#include <Redland/rdf_uri.h>
#endif
#ifdef __cplusplus
extern "C" {
#endif
/* Node types */
/* DEPENDENCY: If this list is changed, the librdf_node_type_names
* definition in rdf_node.c must be updated to match
*
* Node type 3 is unused and should not be renumbered to keep binary
* ABI compatibility.
*/
/**
* librdf_node_type:
* @LIBRDF_NODE_TYPE_UNKNOWN: Internal
* @LIBRDF_NODE_TYPE_RESOURCE: rdf:Resource (& rdf:Property) - has a URI
* @LIBRDF_NODE_TYPE_LITERAL: rdf:Literal - has an XML string, language,
* XML space
* @LIBRDF_NODE_TYPE_BLANK: blank node has an identifier string.
* @LIBRDF_NODE_TYPE_LAST: Internal
*
* Type of a redland node.
*
* Better to check this with functions librdf_node_is_resource(),
* librdf_node_is_literal() or librdf_node_is_blank().
*
*/
typedef enum {
LIBRDF_NODE_TYPE_UNKNOWN = 0, /* To catch uninitialised nodes */
LIBRDF_NODE_TYPE_RESOURCE = 1, /* rdf:Resource (& rdf:Property) - has a URI */
LIBRDF_NODE_TYPE_LITERAL = 2, /* rdf:Literal - has an XML string, language, XML space */
/* node type 3 is unused at present. Do not renumber this list. */
LIBRDF_NODE_TYPE_BLANK = 4, /* blank node has an identifier string */
LIBRDF_NODE_TYPE_LAST = LIBRDF_NODE_TYPE_BLANK
} librdf_node_type;
#ifdef LIBRDF_INTERNAL
#include <rdf_node_internal.h>
#endif
/* Create a new Node. */
REDLAND_API
librdf_node* librdf_new_node(librdf_world* world);
/* Create a new resource Node from URI string. */
REDLAND_API
librdf_node* librdf_new_node_from_uri_string(librdf_world* world, const unsigned char *uri_string);
/* Create a new resource Node from URI object. */
REDLAND_API
librdf_node* librdf_new_node_from_uri(librdf_world* world, librdf_uri *uri);
/* Create a new resource Node from URI object with a local_name */
REDLAND_API
librdf_node* librdf_new_node_from_uri_local_name(librdf_world* world, librdf_uri *uri, const unsigned char *local_name);
/* Create a new resource Node from URI string renormalised to a new base */
REDLAND_API
librdf_node* librdf_new_node_from_normalised_uri_string(librdf_world* world, const unsigned char *uri_string, librdf_uri *source_uri, librdf_uri *base_uri);
/* Create a new Node from literal string / language. */
REDLAND_API
librdf_node* librdf_new_node_from_literal(librdf_world* world, const unsigned char *string, const char *xml_language, int is_wf_xml);
/* Create a new Node from a typed literal string / language. */
REDLAND_API
librdf_node* librdf_new_node_from_typed_literal(librdf_world *world, const unsigned char *value, const char *xml_language, librdf_uri* datatype_uri);
REDLAND_API
librdf_node* librdf_new_node_from_typed_counted_literal(librdf_world *world, const unsigned char *value, size_t value_len, const char *xml_language, size_t xml_language_len, librdf_uri* datatype_uri);
/* Create a new Node from blank node identifier. */
REDLAND_API
librdf_node* librdf_new_node_from_blank_identifier(librdf_world* world, const unsigned char *identifier);
/* Create a new Node from an existing Node - CLONE */
REDLAND_API
librdf_node* librdf_new_node_from_node(librdf_node *node);
/* destructor */
REDLAND_API
void librdf_free_node(librdf_node* node);
/* functions / methods */
REDLAND_API
librdf_uri* librdf_node_get_uri(librdf_node* node);
REDLAND_API
librdf_node_type librdf_node_get_type(librdf_node* node);
REDLAND_API
unsigned char* librdf_node_get_literal_value(librdf_node* node);
REDLAND_API
unsigned char* librdf_node_get_literal_value_as_counted_string(librdf_node* node, size_t* len_p);
REDLAND_API
char* librdf_node_get_literal_value_as_latin1(librdf_node* node);
REDLAND_API
char* librdf_node_get_literal_value_language(librdf_node* node);
REDLAND_API
int librdf_node_get_literal_value_is_wf_xml(librdf_node* node);
REDLAND_API
librdf_uri* librdf_node_get_literal_value_datatype_uri(librdf_node* node);
REDLAND_API
int librdf_node_get_li_ordinal(librdf_node* node);
REDLAND_API
unsigned char *librdf_node_get_blank_identifier(librdf_node* node);
REDLAND_API
int librdf_node_is_resource(librdf_node* node);
REDLAND_API
int librdf_node_is_literal(librdf_node* node);
REDLAND_API
int librdf_node_is_blank(librdf_node* node);
/* serialise / deserialise */
REDLAND_API
size_t librdf_node_encode(librdf_node* node, unsigned char *buffer, size_t length);
REDLAND_API
librdf_node* librdf_node_decode(librdf_world *world, size_t* size_p, unsigned char *buffer, size_t length);
/* convert to a string */
REDLAND_API
unsigned char *librdf_node_to_string(librdf_node* node);
REDLAND_API
unsigned char* librdf_node_to_counted_string(librdf_node* node, size_t* len_p);
/* pretty print it */
REDLAND_API
void librdf_node_print(librdf_node* node, FILE *fh);
/* utility functions */
REDLAND_API
int librdf_node_equals(librdf_node* first_node, librdf_node* second_node);
/* create an iterator for a static array of nodes */
REDLAND_API
librdf_iterator* librdf_node_static_iterator_create(librdf_node** nodes, int size);
#ifdef __cplusplus
}
#endif
#endif