#include <RaptorContainer.h>

Inheritance diagram for knowrob::RaptorContainer:

Collaboration diagram for knowrob::RaptorContainer:

Classes
struct	mapped_statement

Public Member Functions
	RaptorContainer (uint32_t size, std::string_view origin)

	RaptorContainer (uint32_t size)

	~RaptorContainer ()

Triple *	add (raptor_term s, raptor_term p, raptor_term o, librdf_node context=nullptr)

Triple *	add (raptor_statement statement, librdf_node context=nullptr)

void	reset ()

void	rollbackLast ()

void	shrink ()

auto	size () const

ConstGenerator	cgenerator () const override

MutableGenerator	generator () override

	RaptorContainer (uint32_t size, std::string_view origin)

	RaptorContainer (uint32_t size)

	~RaptorContainer ()

Triple *	add (raptor_term s, raptor_term p, raptor_term o, librdf_node context=nullptr)

Triple *	add (raptor_statement statement, librdf_node context=nullptr)

void	reset ()

void	rollbackLast ()

void	shrink ()

auto	size () const

ConstGenerator	cgenerator () const override

MutableGenerator	generator () override

Public Member Functions inherited from knowrob::MutableTripleContainer
iterator	begin ()

bool	isMutable () const override

iterator	begin ()

bool	isMutable () const override

Public Member Functions inherited from knowrob::TripleContainer
virtual	~TripleContainer ()=default

iterator	begin () const

bool	empty () const

virtual	~TripleContainer ()=default

iterator	begin () const

bool	empty () const

Protected Attributes
std::vector< mapped_statement >	raptorData_

std::vector< TriplePtr >	mappedData_

std::size_t	actualSize_

std::optional< std::string_view >	origin_

Additional Inherited Members
Public Types inherited from knowrob::MutableTripleContainer
using	MutableGenerator = std::function< TriplePtr *()>

using	MutableGenerator = std::function< TriplePtr *()>

Public Types inherited from knowrob::TripleContainer
using	ConstGenerator = std::function< const TriplePtr *()>

using	ConstGenerator = std::function< const TriplePtr *()>

Static Public Member Functions inherited from knowrob::MutableTripleContainer
static iterator	end ()

static iterator	end ()

Static Public Member Functions inherited from knowrob::TripleContainer
static iterator	end ()

static iterator	end ()

Detailed Description

A batch of triples loaded with raptor.

Definition at line 18 of file RaptorContainer.h.

Constructor & Destructor Documentation

◆ RaptorContainer() [1/4]

RaptorContainer::RaptorContainer	(	uint32_t	size,
		std::string_view	origin
	)

Parameters

size	the maximum number of triples to be stored.
origin	the origin of the triples.

Definition at line 12 of file RaptorContainer.cpp.

         : raptorData_(size),
           mappedData_(size),
           actualSize_(0),
           origin_(origin) {
     for (auto &triple: mappedData_) {
         triple.ptr = new TripleView();
         triple.owned = true;
     }
 }

◆ RaptorContainer() [2/4]

RaptorContainer::RaptorContainer ( uint32_t size )

explicit

Parameters

size	the maximum number of triples to be stored.

Definition at line 23 of file RaptorContainer.cpp.

         : raptorData_(size),
           mappedData_(size),
           actualSize_(0) {
 }

◆ ~RaptorContainer() [1/2]

RaptorContainer::~RaptorContainer ( )

Definition at line 29 of file RaptorContainer.cpp.

                                   {
     reset();
 }

◆ RaptorContainer() [3/4]

knowrob::RaptorContainer::RaptorContainer	(	uint32_t	size,
		std::string_view	origin
	)

Parameters

size	the maximum number of triples to be stored.
origin	the origin of the triples.

◆ RaptorContainer() [4/4]

knowrob::RaptorContainer::RaptorContainer ( uint32_t size )

explicit

Parameters

size	the maximum number of triples to be stored.

◆ ~RaptorContainer() [2/2]

knowrob::RaptorContainer::~RaptorContainer ( )

Member Function Documentation

◆ add() [1/4]

Triple * RaptorContainer::add	(	raptor_statement *	statement,
		librdf_node *	context = `nullptr`
	)

Add a triple to the batch.

Parameters

statement	a raptor statement.
context	the context of the statement.

Returns: the added statement.

Definition at line 113 of file RaptorContainer.cpp.

                                                                               {
     return add(statement->subject, statement->predicate, statement->object, context);
 }

◆ add() [2/4]

Triple* knowrob::RaptorContainer::add	(	raptor_statement *	statement,
		librdf_node *	context = `nullptr`
	)

Add a triple to the batch.

Parameters

statement	a raptor statement.
context	the context of the statement.

Returns: the added statement.

◆ add() [3/4]

Triple * RaptorContainer::add	(	raptor_term *	s,
		raptor_term *	p,
		raptor_term *	o,
		librdf_node *	context = `nullptr`
	)

Add a triple to the batch.

Parameters

s	a raptor term.
p	a raptor term.
o	a raptor term.
context	the context of the statement.

Returns: the added statement.

Definition at line 56 of file RaptorContainer.cpp.

                                                                                                  {
     // validate input from raptor
     if (!s || !p || !o) {
         KB_WARN("received malformed data from raptor, skipping statement.");
         return nullptr;
     }
  
     // keep a reference on the data
     auto c_s = raptor_term_copy(s);
     auto c_p = raptor_term_copy(p);
     auto c_o = raptor_term_copy(o);
     auto &endpoint_triple = raptorData_[actualSize_];
     endpoint_triple.s = c_s;
     endpoint_triple.p = c_p;
     endpoint_triple.o = c_o;
  
     // map statement to KnowRob datatype
     auto triple = mappedData_[actualSize_];
     triple->reset();
  
     // read graph name
     if (context) {
         // the context node is a string literal with the graph name
         triple->setGraph((const char *) librdf_node_get_literal_value(context));
     } else if (origin_.has_value()) {
         // user specified origin
         triple->setGraph(origin_.value().data());
     }
  
     // read predicate
     triple->setPredicate((const char *) raptor_uri_as_string(c_p->value.uri));
     // read subject
     if (c_s->type == RAPTOR_TERM_TYPE_BLANK)
         triple->setSubjectBlank((const char *) c_s->value.blank.string);
     else
         triple->setSubject((const char *) raptor_uri_as_string(c_s->value.uri));
  
     // read object
     if (c_o->type == RAPTOR_TERM_TYPE_BLANK) {
         triple->setObjectBlank((const char *) c_o->value.blank.string);
     } else if (c_o->type == RAPTOR_TERM_TYPE_LITERAL) {
         auto stringForm = (const char *) c_o->value.literal.string;
         // parse literal type
         XSDType xsdType = XSDType::STRING;
         if (c_o->value.literal.datatype) {
             auto typeURI = (const char *) raptor_uri_as_string(c_o->value.literal.datatype);
             xsdType = xsdTypeFromIRI(typeURI);
         }
         triple->setXSDValue(stringForm, xsdType);
     } else {
         triple->setObjectIRI((const char *) raptor_uri_as_string(c_o->value.uri));
     }
  
     actualSize_ += 1;
     return triple.ptr;
 }

◆ add() [4/4]

Triple* knowrob::RaptorContainer::add	(	raptor_term *	s,
		raptor_term *	p,
		raptor_term *	o,
		librdf_node *	context = `nullptr`
	)

Add a triple to the batch.

Parameters

s	a raptor term.
p	a raptor term.
o	a raptor term.
context	the context of the statement.

Returns: the added statement.

◆ cgenerator() [1/2]

TripleContainer::ConstGenerator RaptorContainer::cgenerator ( ) const

overridevirtual

Returns: a generator function that returns a const pointer to a triple.

Implements knowrob::TripleContainer.

Definition at line 33 of file RaptorContainer.cpp.

                                                                 {
     return [this, i = std::size_t(0)]() mutable -> const TriplePtr * {
         if (i < actualSize_) return &mappedData_[i++];
         return nullptr;
     };
 }

◆ cgenerator() [2/2]

ConstGenerator knowrob::RaptorContainer::cgenerator ( ) const

overridevirtual

Returns: a generator function that returns a const pointer to a triple.

Implements knowrob::TripleContainer.

◆ generator() [1/2]

MutableTripleContainer::MutableGenerator RaptorContainer::generator ( )

overridevirtual

Returns: a generator function that returns a pointer to a triple.

Implements knowrob::MutableTripleContainer.

Definition at line 40 of file RaptorContainer.cpp.

                                                                   {
     return [this, i = std::size_t(0)]() mutable -> TriplePtr * {
         if (i < actualSize_) return &mappedData_[i++];
         return nullptr;
     };
 }

◆ generator() [2/2]

MutableGenerator knowrob::RaptorContainer::generator ( )

overridevirtual

Returns: a generator function that returns a pointer to a triple.

Implements knowrob::MutableTripleContainer.

◆ reset() [1/2]

void RaptorContainer::reset ( )

Reset the batch to be empty.

Definition at line 47 of file RaptorContainer.cpp.

                             {
     for (std::size_t i = 0; i < actualSize_; i++) {
         raptor_free_term(raptorData_[i].s);
         raptor_free_term(raptorData_[i].p);
         raptor_free_term(raptorData_[i].o);
     }
     actualSize_ = 0;
 }

◆ reset() [2/2]

void knowrob::RaptorContainer::reset ( )

Reset the batch to be empty.

◆ rollbackLast() [1/2]

void RaptorContainer::rollbackLast ( )

Rollback the last added statement.

Definition at line 117 of file RaptorContainer.cpp.

                                    {
     if (actualSize_ > 0) {
         actualSize_ -= 1;
         raptor_free_term(raptorData_[actualSize_].s);
         raptor_free_term(raptorData_[actualSize_].p);
         raptor_free_term(raptorData_[actualSize_].o);
     }
 }

◆ rollbackLast() [2/2]

void knowrob::RaptorContainer::rollbackLast ( )

Rollback the last added statement.

◆ shrink() [1/2]

void RaptorContainer::shrink ( )

Shrink the batch to the actual size.

Definition at line 126 of file RaptorContainer.cpp.

                              {
     mappedData_.resize(actualSize_);
     raptorData_.resize(actualSize_);
 }

◆ shrink() [2/2]

void knowrob::RaptorContainer::shrink ( )

Shrink the batch to the actual size.

◆ size() [1/2]

auto knowrob::RaptorContainer::size ( ) const

inline

Returns: the actual size of the batch.

Definition at line 69 of file RaptorContainer.h.

69 { return actualSize_; }

◆ size() [2/2]

auto knowrob::RaptorContainer::size ( ) const

inline

Returns: the actual size of the batch.

Definition at line 69 of file RaptorContainer.h.

69 { return actualSize_; }

Member Data Documentation

◆ actualSize_

std::size_t knowrob::RaptorContainer::actualSize_

protected

Definition at line 85 of file RaptorContainer.h.

◆ mappedData_

std::vector< TriplePtr > knowrob::RaptorContainer::mappedData_

protected

Definition at line 84 of file RaptorContainer.h.

◆ origin_

std::optional< std::string_view > knowrob::RaptorContainer::origin_

protected

Definition at line 86 of file RaptorContainer.h.

◆ raptorData_

std::vector< mapped_statement > knowrob::RaptorContainer::raptorData_

protected

Definition at line 83 of file RaptorContainer.h.

The documentation for this class was generated from the following files:

build/_CPack_Packages/Linux/DEB/knowrob-2.1.0-Linux/usr/include/knowrob/storage/redland/RaptorContainer.h
src/storage/redland/RaptorContainer.cpp

Classes

Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ RaptorContainer() [1/4]

◆ RaptorContainer() [2/4]

◆ ~RaptorContainer() [1/2]

◆ RaptorContainer() [3/4]

◆ RaptorContainer() [4/4]

◆ ~RaptorContainer() [2/2]

Member Function Documentation

◆ add() [1/4]

◆ add() [2/4]

◆ add() [3/4]

◆ add() [4/4]

◆ cgenerator() [1/2]

◆ cgenerator() [2/2]

◆ generator() [1/2]

◆ generator() [2/2]

◆ reset() [1/2]

◆ reset() [2/2]

◆ rollbackLast() [1/2]

◆ rollbackLast() [2/2]

◆ shrink() [1/2]

◆ shrink() [2/2]

◆ size() [1/2]

◆ size() [2/2]

Member Data Documentation

◆ actualSize_

◆ mappedData_

◆ origin_

◆ raptorData_