# redland - Resource Description Framework (RDF) Library - man(3) - [phpMan] [_redland_(3)](https://www.chedong.com/phpMan.php/man/redland/3/markdown) Redland RDF Application Framework [_redland_(3)](https://www.chedong.com/phpMan.php/man/redland/3/markdown) ## NAME redland - Resource Description Framework (RDF) Library ## VERSION 1.0.16 ## SYNOPSIS #include ## DESCRIPTION **redland **is a library providing support for the Resource Description Framework (RDF) written in ANSI C with APIs in several other languages. This manual page lists most of the redland public API functions but does not claim to be a complete summary of the entire API. For the complete API with full details of the function interface, see the HTML API documentation either on the Redland web site at <> or with the software release in the docs/api directory. ## FUNCTIONS The functions defined by **redland **are all defined with the "librdf_" prefix ### class world librdf_world* **librdf_new_world**(_void_) void **librdf_free_world**(librdf_world* _world_) void **librdf_world_open**(librdf_world* _world_) void **librdf_world_set_error**(librdf_world* _world_, void* _user_data_, void (*_error_fn_)(void* _user_data_, const char* _msg_, ...)) void **librdf_world_set_warning**(librdf_world* _world_, void* _user_data_, void (*_warning_fn_)(void* _user_data_, const char* _msg_, ...)) void **librdf_world_set_digest**(librdf_world*, const char* _name_) void **librdf_world_set_uris_hash**(librdf_world* _world_, librdf_hash* _uris_hash_) const char* **librdf_world_get_feature**(librdf_world* _world_, librdf_uri* _feature_) int **librdf_world_set_feature**(librdf_world* _world_, librdf_uri* _feature_, const char* _value_) ### class iterator librdf_iterator* **librdf_new_iterator**(librdf_world* _world_, void* _context_, int (*_is_end_)(void*), void* (*_get_next_)(void*), void (*_finished_)(void*)) void **librdf_free_iterator**(librdf_iterator*) int **librdf_iterator_end**(librdf_iterator* _iterator_) int **librdf_iterator_finished**(librdf_iterator* _iterator_) int **librdf_iterator_next**(librdf_iterator* _iterator_) void* **librdf_iterator_get_object**(librdf_iterator* _iterator_) void* **librdf_iterator_get_context**(librdf_iterator* _iterator_) void* **librdf_iterator_get_key**(librdf_iterator* _iterator_) void* **librdf_iterator_get_value**(librdf_iterator* _iterator_) int **librdf_iterator_add_map**(librdf_iterator* _iterator_, void* (*_fn_)(void* _context_, void* _item_), void* _context_) void* **librdf_iterator_map_remove_duplicate_nodes**(void* _item_, void* _user_data_) ### class digest void **librdf_digest_register_factory**(librdf_world* _world_, const char* _name_, void (*_factory_) (librdf_digest_factory*)) librdf_digest_factory* **librdf_get_digest_factory**(librdf_world* _world_, const char* _name_) librdf_digest* **librdf_new_digest**(librdf_world* _world_, char* _name_) librdf_digest* **librdf_new_digest_from_factory**(librdf_world* _world_, librdf_digest_factory* _factory_) void **librdf_free_digest**(librdf_digest* _digest_) void **librdf_digest_init**(librdf_digest* _digest_) void **librdf_digest_update**(librdf_digest* _digest_, unsigned char* _buf_, size_t _length_) void **librdf_digest_final**(librdf_digest* _digest_) void* **librdf_digest_get_digest**(librdf_digest* _digest_) char* **librdf_digest_to_string**(librdf_digest* _digest_) void **librdf_digest_print**(librdf_digest* _digest_, FILE* _fh_) ### class uri librdf_uri* **librdf_new_uri**(librdf_world* _world_, const unsigned char * _string_) librdf_uri* **librdf_new_uri_from_uri**(librdf_uri* _uri_) librdf_uri* **librdf_new_uri_from_uri_local_name**(librdf_uri* _uri_, const unsigned char* _local_name_) void **librdf_free_uri**(librdf_uri* _uri_) unsigned char* **librdf_uri_as_string**(librdf_uri* _uri_) unsigned char* **librdf_uri_as_counted_string**(librdf_uri* _uri_, size_t* _len_p_) librdf_digest* **librdf_uri_get_digest**(librdf_uri* _uri_) void librdf_uri_print>(librdf_uri* _uri_, FILE* _fh_) unsigned char* **librdf_uri_to_string**(librdf_uri* _uri_) unsigned char* **librdf_uri_to_counted_string**(librdf_uri* _uri_, size_t* _len_p_) int **librdf_uri_equals**(librdf_uri* _first_uri_, librdf_uri* _second_uri_) int **librdf_uri_is_file_uri**(librdf_uri* _uri_) const char* **librdf_uri_to_filename**(librdf_uri* _uri_) librdf_uri* **librdf_new_uri_normalised_to_base**(const unsigned char* _uri_string_, librdf_uri* _source_uri_, librdf_uri* _base_uri_) librdf_uri* **librdf_new_uri_relative_to_base**(librdf_uri* _base_uri_, const unsigned char* _uri_string_) librdf_uri* **librdf_new_uri_from_filename**(librdf_world* _world_, const char* _filename_) ### class node librdf_node* **librdf_new_node**(librdf_world* _world_) librdf_node* **librdf_new_node_from_uri_string**(librdf_world* _world_, const char* _string_) librdf_node* **librdf_new_node_from_uri**(librdf_world* _world_, librdf_uri* _uri_) librdf_node* **librdf_new_node_from_uri_local_name**(librdf_world* _world_, librdf_uri* _uri_, const char* _local_name_) librdf_node* **librdf_new_node_from_normalised_uri_string**(librdf_world* _world_, const char* _uri_string_, librdf_uri* _source_uri_, librdf_uri* _base_uri_) librdf_node* **librdf_new_node_from_literal**(librdf_world* _world_, const char* _string_, const char* _xml_language_, int _xml_space_, int _is_wf_xml_) librdf_node* **librdf_new_node_from_typed_literal**(librdf_world* _world_, const unsigned char* _string_, const char* _xml_language_, librdf_uri* _datatype_uri_) librdf_node* **librdf_new_node_from_blank_identifier**(librdf_world* _world_, const unsigned char* _identifier_) librdf_node* **librdf_new_node_from_node**(librdf_node* _node_) void **librdf_node_init**(librdf_world* _world_, librdf_node* _node_) void **librdf_free_node**(librdf_node* _r_) librdf_uri* **librdf_node_get_uri**(librdf_node* _node_) librdf_node_type **librdf_node_get_type**(librdf_node* _node_) unsigned char* **librdf_node_get_literal_value**(librdf_node* _node_) unsigned char* **librdf_node_get_literal_value_as_counted_string**(librdf_node* _node_, size_t* _len_p_) char* **librdf_node_get_literal_value_as_latin1**(librdf_node* _node_) char* **librdf_node_get_literal_value_language**(librdf_node* _node_) int **librdf_node_get_literal_value_is_wf_xml**(librdf_node* _node_) librdf_uri* **librdf_node_get_literal_value_datatype_uri**(librdf_node* _node_) int **librdf_node_get_li_ordinal**(librdf_node* _node_) unsigned char* **librdf_node_get_blank_identifier**(librdf_node* _node_) int **librdf_node_is_resource**(librdf_node* _node_) int **librdf_node_is_literal**(librdf_node* _node_) int **librdf_node_is_blank**(librdf_node* _node_) librdf_digest* **librdf_node_get_digest**(librdf_node* _node_) size_t **librdf_node_encode**(librdf_node* _node_, unsigned char* _buffer_, size_t _length_) size_t **librdf_node_decode**(librdf_node* _node_, unsigned char* _buffer_, size_t _length_) unsigned char* **librdf_node_to_string**(librdf_node* _node_) unsigned char* **librdf_node_to_counted_string**(librdf_node* _node_, size_t* _len_p_) void **librdf_node_print**(librdf_node* _node_, FILE* _fh_) int **librdf_node_equals**(librdf_node* _first_node_, librdf_node* _second_node_) ### class concepts The library provides macros for all of the RDF and RDFS concepts - nodes and URIs. For example, "LIBRDF_MS_Alt" for the librdf_node for the rdf:Alt concept and "LIBRDF_MS_Alt_URI" for the librdf_uri for the URI reference of rdf:Alt. "LIBRDF_URI_RDF_MS" and "LIBRDF_URI_RDF_SCHEMA" provide the librdf_uri objects for the RDF and RDFS namespace URIs. They must be copied using **librdf_new_uri_from_uri **to be shared correctly. void **librdf_get_concept_by_name**(librdf_world* _world_, int _is_ms_, const char* _name_, librdf_uri **_uri_p_, librdf_node **_node_p_) ### class statement librdf_statement* **librdf_new_statement**(librdf_world* _world_) librdf_statement* **librdf_new_statement_from_statement**(librdf_statement* _statement_) librdf_statement* **librdf_new_statement_from_nodes**(librdf_world* _world_, librdf_node* _subject_, librdf_node* _predicate_, librdf_node* _object_) void **librdf_statement_init**(librdf_world* _world_, librdf_statement* _statement_) void **librdf_statement_clear**(librdf_statement* _statement_) void **librdf_free_statement**(librdf_statement* _statement_) librdf_node* **librdf_statement_get_subject**(librdf_statement* _statement_) void **librdf_statement_set_subject**(librdf_statement* _statement_, librdf_node* _subject_) librdf_node* **librdf_statement_get_predicate**(librdf_statement* _statement_) void **librdf_statement_set_predicate**(librdf_statement* _statement_, librdf_node* _predicate_) librdf_node* **librdf_statement_get_object**(librdf_statement* _statement_) void **librdf_statement_set_object**(librdf_statement* _statement_, librdf_node* _object_) int **librdf_statement_is_complete**(librdf_statement* _statement_) char* **librdf_statement_to_string**(librdf_statement* _statement_) void **librdf_statement_print**(librdf_statement* _statement_, FILE* _fh_) int **librdf_statement_equals**(librdf_statement* _statement1_, librdf_statement* _statement2_) int **librdf_statement_match**(librdf_statement* _statement_, librdf_statement* _partial_statement_) size_t **librdf_statement_encode**(librdf_statement* _statement_, unsigned char* _buffer_, size_t _length_) size_t **librdf_statement_encode_parts**(librdf_statement* _statement_, unsigned char* _buffer_, size_t _length_, librdf_statement_part _fields_) size_t **librdf_statement_decode**(librdf_statement* _statement_, unsigned char* _buffer_, size_t _length_) size_t **librdf_statement_decode_parts**(librdf_statement* _statement_, librdf_node** _context_node_, unsigned char* _buffer_, size_t _length_) ### class model librdf_model* **librdf_new_model**(librdf_world* _world_, librdf_storage* _storage_, char* _options_string_) librdf_model* **librdf_new_model_with_options**(librdf_world* _world_, librdf_storage* _storage_, librdf_hash* _options_) librdf_model* **librdf_new_model_from_model**(librdf_model* _model_) void **librdf_free_model**(librdf_model* _model_) int **librdf_model_size**(librdf_model* _model_) int **librdf_model_add**(librdf_model* _model_, librdf_node* _subject_, librdf_node* _predicate_, librdf_node* _object_) int **librdf_model_add_string_literal_statement**(librdf_model* _model_, librdf_node* _subject_, librdf_node* _predicate_, char* _string_, char* _xml_language_, int _xml_space_, int _is_wf_xml_) int **librdf_model_add_typed_literal_statement**(librdf_model* _model_, librdf_node* _subject_, librdf_node* _predicate_, const unsigned char* _string_, char* _xml_language_, librdf_uri* _datatype_uri_) int **librdf_model_add_statement**(librdf_model* _model_, librdf_statement* _statement_) int **librdf_model_add_statements**(librdf_model* _model_, librdf_stream* _statement_stream_) int **librdf_model_remove_statement**(librdf_model* _model_, librdf_statement* _statement_) int **librdf_model_contains_statement**(librdf_model* _model_, librdf_statement* _statement_) int **librdf_model_has_arc_in**(librdf_model* _model_, librdf_node* _node_, librdf_node* _property_) int **librdf_model_has_arc_out**(librdf_model* _model_, librdf_node* _node_, librdf_node* _property_) librdf_stream* **librdf_model_as_stream**(librdf_model* _model_) librdf_stream* **librdf_model_find_statements**(librdf_model* _model_, librdf_statement* _statement_) librdf_stream* **librdf_model_find_statements_in_context**(librdf_model* _model_, librdf_statement* _statement_, librdf_node* _context_node_) librdf_stream* **librdf_model_find_statements_with_options**(librdf_model* _model_, librdf_statement* _statement_, librdf_node* _context_node_, librdf_hash* _options_) librdf_iterator* **librdf_model_get_contexts**(librdf_model* _model_) librdf_iterator* **librdf_model_get_sources**(librdf_model* _model_, librdf_node* _arc_, librdf_node* _target_) librdf_iterator* **librdf_model_get_arcs**(librdf_model* _model_, librdf_node* _source_, librdf_node* _target_) librdf_iterator* **librdf_model_get_targets**(librdf_model* _model_, librdf_node* _source_, librdf_node* _arc_) librdf_node* **librdf_model_get_source**(librdf_model* _model_, librdf_node* _arc_, librdf_node* _target_) librdf_node* **librdf_model_get_arc**(librdf_model* _model_, librdf_node* _source_, librdf_node* _target_) librdf_node* **librdf_model_get_target**(librdf_model* _model_, librdf_node* _source_, librdf_node* _arc_) librdf_iterator* **librdf_model_get_arcs_in**(librdf_model* _model_, librdf_node* _node_) librdf_iterator* **librdf_model_get_arcs_out**(librdf_model* _model_, librdf_node* _node_) int **librdf_model_add_submodel**(librdf_model* _model_, librdf_model* _sub_model_) int **librdf_model_remove_submodel**(librdf_model* _model_, librdf_model* _sub_model_) void **librdf_model_print**(librdf_model* _model_, FILE* _fh_) int **librdf_model_context_add_statement**(librdf_model* _model_, librdf_node* _context_, librdf_statement* _statement_) int **librdf_model_context_add_statements**(librdf_model* _model_, librdf_node* _context_, librdf_stream* _stream_) int **librdf_model_context_remove_statement**(librdf_model* _model_, librdf_node* _context_, librdf_statement* _statement_) int **librdf_model_context_remove_statements**(librdf_model* _model_, librdf_node* _context_) librdf_stream* **librdf_model_context_as_stream**(librdf_model* _model_, librdf_node* _context_) librdf_stream* **librdf_model_query**(librdf_model* _model_, librdf_query* _query_) librdf_stream* **librdf_model_query_string**(librdf_model* _model_, const char* _name_, librdf_uri* _uri_, const unsigned char* _query_string_) void **librdf_model_sync**(librdf_model* _model_) librdf_storage* **librdf_model_get_storage**(librdf_model* _model_) librdf_node* **librdf_model_get_feature**(librdf_model* _model_, librdf_uri* _feature_) =item int **librdf_model_set_feature**(librdf_model* _model_, librdf_uri* _feature_, librdf_node* _value_) ### class storage void **librdf_storage_register_factory**(const char* _name_, void (*_factory_) (librdf_storage_factory*)) librdf_storage* **librdf_new_storage**(librdf_world* _world_, char* _storage_name_, char* _name_, char* _options_string_) librdf_storage* **librdf_new_storage_with_options**(librdf_world* _world_, char* _storage_name_, char* _name_, librdf_hash* _options_) librdf_storage* **librdf_new_storage_from_storage**(librdf_storage* _old_storage_) librdf_storage* **librdf_new_storage_from_factory**(librdf_world* _world_, librdf_storage_factory* _factory_, char* _name_, librdf_hash* _options_) void **librdf_free_storage**(librdf_storage* _storage_) int **librdf_storage_open**(librdf_storage* _storage_, librdf_model* _model_) int **librdf_storage_close**(librdf_storage* _storage_) int **librdf_storage_get**(librdf_storage* _storage_, void* _key_, size_t _key_len_, void **_value_, size_t* _value_len_, unsigned int _flags_) int **librdf_storage_size**(librdf_storage* _storage_) int **librdf_storage_add_statement**(librdf_storage* _storage_, librdf_statement* _statement_) int **librdf_storage_add_statements**(librdf_storage* _storage_, librdf_stream* _statement_stream_) int **librdf_storage_remove_statement**(librdf_storage* _storage_, librdf_statement* _statement_) int **librdf_storage_contains_statement**(librdf_storage* _storage_, librdf_statement* _statement_) librdf_stream* **librdf_storage_serialise**(librdf_storage* _storage_) librdf_stream* **librdf_storage_find_statements**(librdf_storage* _storage_, librdf_statement* _statement_) librdf_iterator* **librdf_storage_get_sources**(librdf_storage* _storage_, librdf_node* _arc_, librdf_node* _target_) librdf_iterator* **librdf_storage_get_arcs**(librdf_storage* _storage_, librdf_node* _source_, librdf_node* _target_) librdf_iterator* **librdf_storage_get_targets**(librdf_storage* _storage_, librdf_node* _source_, librdf_node* _arc_) librdf_iterator* **librdf_storage_get_arcs_in**(librdf_storage* _storage_, librdf_node* _node_) librdf_iterator* **librdf_storage_get_arcs_out**(librdf_storage* _storage_, librdf_node* _node_) int **librdf_storage_has_arc_in**(librdf_storage* _storage_, librdf_node* _node_, librdf_node* _property_) int **librdf_storage_has_arc_out**(librdf_storage* _storage_, librdf_node* _node_, librdf_node* _property_) int **librdf_storage_context_add_statement**(librdf_storage* _storage_, librdf_node* _context_, librdf_statement* _statement_) int **librdf_storage_context_add_statements**(librdf_storage* _storage_, librdf_node* _context_, librdf_stream* _stream_) int **librdf_storage_context_remove_statement**(librdf_storage* _storage_, librdf_node* _context_, librdf_statement* _statement_) int **librdf_storage_context_remove_statements**(librdf_storage* _storage_, librdf_node* _context_) librdf_stream* **librdf_storage_context_as_stream**(librdf_storage* _storage_, librdf_node* _context_) int **librdf_storage_supports_query**(librdf_storage* _storage_, librdf_query* _query_) librdf_stream* **librdf_storage_query**(librdf_storage* _storage_, librdf_query* _query_) void **librdf_storage_sync**(librdf_storage* _storage_) ### class parser void **librdf_parser_register_factory**(librdf_world* _world_, const char* _name_, const char* _mime_type_, const 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_, const unsigned char* _string_, librdf_uri* _base_uri_) int librdf_parser_parse_string_into_model(librdf_parser* _parser_, const 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_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_) ### class serializer librdf_serializer* librdf_new_serializer(librdf_world* _world_, const char *_name_, const char *_mime_type_, librdf_uri *_type_uri_) librdf_serializer* librdf_new_serializer_from_factory(librdf_world* _world_, librdf_serializer_factory *_factory_) void librdf_free_serializer(librdf_serializer *_serializer_) int librdf_serializer_serialize_model(librdf_serializer* _serializer_, FILE* _handle_, librdf_uri* _base_uri_, librdf_model* _model_) int librdf_serializer_serialize_model_to_file(librdf_serializer* _serializer_, const char *_name_, librdf_uri* _base_uri_, librdf_model* _model_) void librdf_serializer_set_error(librdf_serializer* _serializer_, void *_user_data_, void (*_error_fn_)(void *user_data, const char *msg, ...)) void librdf_serializer_set_warning(librdf_serializer* _serializer_, void *_user_data_, void (*_warning_fn_)(void *user_data, const char *msg, ...)) librdf_node* librdf_serializer_get_feature(librdf_serializer* _serializer_, librdf_uri* _feature_) int librdf_serializer_set_feature(librdf_serializer* _serializer_, librdf_uri* _feature_, librdf_node* _value_)b int librdf_serializer_set_namespace(librdf_serializer* _serializer_, librdf_uri* _uri_, const char* _prefix_) ### class stream librdf_stream* **librdf_new_stream**(librdf_world* _world_, void* _context_, int (*_end_of_stream_)(void*), librdf_statement* (*_next_statement_)(void*), void (*_finished_)(void*)) librdf_stream* **librdf_new_stream_from_node_iterator**(librdf_iterator* _iterator_, librdf_statement* _statement_, librdf_statement_part _field_) void **librdf_free_stream**(librdf_stream* _stream_) int **librdf_stream_end**(librdf_stream* _stream_) int **librdf_stream_next**(librdf_stream* _stream_) librdf_statement* **librdf_stream_get_object**(librdf_stream* _stream_) void* **librdf_stream_get_context**(librdf_stream* _stream_) void **librdf_stream_set_map**(librdf_stream* _stream_, librdf_statement* (*_map_)(void* _context_, librdf_statement* _statement_), void* _map_context_) void **librdf_stream_print**(librdf_stream* _stream_, FILE* _fh_) ## EXAMPLES #include librdf_storage *storage; librdf_model* model; librdf_statement* statement; librdf_world* world world=librdf_new_world(); librdf_world_open(world); storage=librdf_new_storage(world, "hashes", "test", "hash-type='bdb',dir='.'"); model=librdf_new_model(world, storage, NULL); statement=librdf_new_statement_from_nodes(world, librdf_new_node_from_uri_string(world, ""), librdf_new_node_from_uri_string(world, ""), librdf_new_node_from_literal(world, "Dave Beckett", NULL, 0)); librdf_model_add_statement(model, statement); librdf_free_statement(statement); librdf_model_print(model, stdout); librdf_free_model(model); librdf_free_storage(storage); librdf_free_world(world); ## SEE ALSO [_libraptor_(3)](https://www.chedong.com/phpMan.php/man/libraptor/3/markdown), [_libxml_(4)](https://www.chedong.com/phpMan.php/man/libxml/4/markdown). ## HISTORY The **redland **RDF library was created by Dave Beckett in June 2000. ## AUTHOR Dave Beckett <>, 28-Jun-2012 redland 1.0.16 [_redland_(3)](https://www.chedong.com/phpMan.php/man/redland/3/markdown)