/**
* librdf_world_set_raptor:
* @world: librdf_world object
* @raptor_world_ptr: raptor_world object
*
* Set the #raptor_world instance to be used with this #librdf_world.
*
* If no raptor_world instance is set with this function,
* librdf_world_open() creates a new instance.
*
* Ownership of the raptor_world is not taken. If the raptor library
* instance is set with this function, librdf_free_world() will not
* free it.
*
**/
void
librdf_world_set_raptor(librdf_world* world, raptor_world* raptor_world_ptr)
{
LIBRDF_ASSERT_OBJECT_POINTER_RETURN(world, librdf_world);
world->raptor_world_ptr = raptor_world_ptr;
world->raptor_world_allocated_here = 0;
}
/**
* librdf_statement_set_object:
* @statement: #librdf_statement object
* @node: #librdf_node of object
*
* Set the statement object.
*
* The object passed in becomes owned by
* the statement object and must not be used by the caller after this call.
**/
void
librdf_statement_set_object(librdf_statement *statement, librdf_node *node)
{
LIBRDF_ASSERT_OBJECT_POINTER_RETURN(statement, librdf_statement);
statement->object=node;
}
/**
* librdf_uri_print:
* @uri: #librdf_uri object
* @fh: file handle
*
* Print the URI to the given file handle.
*
**/
void
librdf_uri_print (librdf_uri* uri, FILE *fh)
{
LIBRDF_ASSERT_OBJECT_POINTER_RETURN(uri, librdf_uri);
fputs((const char*)librdf_uri_as_string(uri), fh);
}
/**
* librdf_statement_set_predicate:
* @statement: #librdf_statement object
* @node: #librdf_node of predicate
*
* Set the statement predicate.
*
* The predicate passed in becomes owned by
* the statement object and must not be used by the caller after this call.
**/
void
librdf_statement_set_predicate(librdf_statement *statement, librdf_node *node)
{
LIBRDF_ASSERT_OBJECT_POINTER_RETURN(statement, librdf_statement);
statement->predicate=node;
}
void
librdf_statement_clear(librdf_statement *statement)
{
LIBRDF_ASSERT_OBJECT_POINTER_RETURN(statement, librdf_statement);
raptor_statement_clear(statement);
}
void
librdf_storage_sync(librdf_storage* storage)
{
LIBRDF_ASSERT_OBJECT_POINTER_RETURN(storage, librdf_storage);
if(storage->factory->sync)
storage->factory->sync(storage);
}
void
librdf_statement_init(librdf_world *world, librdf_statement *statement)
{
librdf_world_open(world);
LIBRDF_ASSERT_OBJECT_POINTER_RETURN(statement, librdf_statement);
raptor_statement_init(statement, world->raptor_world_ptr);
}
/**
* librdf_statement_init:
* @world: redland world object
* @statement: #librdf_statement object
*
* Initialise a statically declared librdf_statement.
*
* This MUST be called on a statically declared librdf_statement
* to initialise it properly. It is the responsibility of the
* user of the statically allocated librdf_statement to deal
* with deallocation of any statement parts (subject, predicate, object).
**/
void
librdf_statement_init(librdf_world *world, librdf_statement *statement)
{
librdf_world_open(world);
LIBRDF_ASSERT_OBJECT_POINTER_RETURN(statement, librdf_statement);
statement->world=world;
statement->subject=NULL;
statement->predicate=NULL;
statement->object=NULL;
}
/**
* librdf_free_storage - Destructor - destroy a librdf_storage object
* @storage: &librdf_storage object
*
**/
void
librdf_free_storage (librdf_storage* storage)
{
LIBRDF_ASSERT_OBJECT_POINTER_RETURN(storage, librdf_storage);
if(--storage->usage)
return;
if(storage->factory)
storage->factory->terminate(storage);
if(storage->context)
LIBRDF_FREE(librdf_storage_context, storage->context);
LIBRDF_FREE(librdf_storage, storage);
}
/**
* librdf_statement_print:
* @statement: the statement
* @fh: file handle
*
* Pretty print the statement to a file descriptor.
*
* This method is for debugging and the format of the output should
* not be relied on.
*
**/
void
librdf_statement_print(librdf_statement *statement, FILE *fh)
{
unsigned char *s;
LIBRDF_ASSERT_OBJECT_POINTER_RETURN(statement, librdf_statement);
if(!statement)
return;
s=librdf_statement_to_string(statement);
if(!s)
return;
fputs((const char*)s, fh);
LIBRDF_FREE(cstring, s);
}
/**
* librdf_free_uri:
* @uri: #librdf_uri object
*
* Destructor - destroy a #librdf_uri object.
*
**/
void
librdf_free_uri (librdf_uri* uri)
{
librdf_hash_datum key; /* on stack */
#ifdef WITH_THREADS
librdf_world *world;
#endif
LIBRDF_ASSERT_OBJECT_POINTER_RETURN(uri, librdf_uri);
#ifdef WITH_THREADS
world = uri->world;
pthread_mutex_lock(world->mutex);
#endif
uri->usage--;
#if defined(LIBRDF_DEBUG) && LIBRDF_DEBUG > 1
LIBRDF_DEBUG3("URI %s usage count now %d\n", uri->string, uri->usage);
#endif
/* decrement usage, don't free if not 0 yet*/
if(uri->usage) {
#ifdef WITH_THREADS
pthread_mutex_unlock(world->mutex);
#endif
return;
}
#if defined(LIBRDF_DEBUG) && LIBRDF_DEBUG > 1
LIBRDF_DEBUG3("Deleting URI %s from hash, max usage was %d\n", uri->string, uri->max_usage);
#endif
key.data=uri->string;
key.size=uri->string_length;
/* Hash deletion fails only if the key is not found.
This is not a fatal error so do not check for return value. */
librdf_hash_delete_all(uri->world->uris_hash, &key);
if(uri->string)
LIBRDF_FREE(cstring, uri->string);
LIBRDF_FREE(librdf_uri, uri);
#ifdef WITH_THREADS
pthread_mutex_unlock(world->mutex);
#endif
}
/**
* librdf_statement_print:
* @statement: the statement
* @fh: file handle
*
* Pretty print the statement to a file descriptor.
*
* This method is for debugging and the format of the output should
* not be relied on.
*
**/
void
librdf_statement_print(librdf_statement *statement, FILE *fh)
{
raptor_iostream *iostr;
LIBRDF_ASSERT_OBJECT_POINTER_RETURN(statement, librdf_statement);
if(!statement)
return;
iostr = raptor_new_iostream_to_file_handle(statement->world->raptor_world_ptr, fh);
if(!iostr)
return;
librdf_statement_write(statement, iostr);
raptor_free_iostream(iostr);
}
/**
* librdf_statement_clear:
* @statement: #librdf_statement object
*
* Empty a librdf_statement of nodes.
*
**/
void
librdf_statement_clear(librdf_statement *statement)
{
LIBRDF_ASSERT_OBJECT_POINTER_RETURN(statement, librdf_statement);
if(statement->subject) {
librdf_free_node(statement->subject);
statement->subject=NULL;
}
if(statement->predicate) {
librdf_free_node(statement->predicate);
statement->predicate=NULL;
}
if(statement->object) {
librdf_free_node(statement->object);
statement->object=NULL;
}
}
/**
* librdf_free_statement:
* @statement: #librdf_statement object
*
* Destructor - destroy a #librdf_statement.
*
**/
void
librdf_free_statement(librdf_statement* statement)
{
#ifdef WITH_THREADS
librdf_world *world;
#endif
LIBRDF_ASSERT_OBJECT_POINTER_RETURN(statement, librdf_statement);
#ifdef WITH_THREADS
world = statement->world;
pthread_mutex_lock(world->statements_mutex);
#endif
librdf_statement_clear(statement);
#ifdef WITH_THREADS
pthread_mutex_unlock(world->statements_mutex);
#endif
LIBRDF_FREE(librdf_statement, statement);
}
