5.8.5 Statement

enum SerdField

Index of a node in a statement.

enumerator SERD_SUBJECT

Subject.

enumerator SERD_PREDICATE

Predicate (“key”)

enumerator SERD_OBJECT

Object (“value”)

enumerator SERD_GRAPH

Graph (“context”)

typedef struct SerdStatementImpl SerdStatement

A subject, predicate, and object, with optional graph context.

SerdStatement *serd_statement_new(SerdAllocator *allocator, const SerdNode *s, const SerdNode *p, const SerdNode *o, const SerdNode *g, const SerdCaret *caret)

Create a new statement.

Note that, to minimise model overhead, statements do not own their nodes, so they must have a longer lifetime than the statement for it to be valid. For statements in models, this is the lifetime of the model. For user-created statements, the simplest way to handle this is to use SerdNodes.

Parameters

• allocator – Allocator to use for statement memory.

• s – The subject

• p – The predicate (“key”)

• o – The object (“value”)

• g – The graph (“context”)

• caret – Optional caret at the origin of this statement

Returns

A new statement that must be freed with serd_statement_free()

SerdStatement *serd_statement_copy(SerdAllocator *allocator, const SerdStatement *statement)

Return a copy of statement

void serd_statement_free(SerdAllocator *allocator, SerdStatement *statement)

Free statement

const SerdNode *serd_statement_node(const SerdStatement *statement, SerdField field)

Return the given node of the statement.

const SerdNode *serd_statement_subject(const SerdStatement *statement)

Return the subject of the statement.

const SerdNode *serd_statement_predicate(const SerdStatement *statement)

Return the predicate of the statement.

const SerdNode *serd_statement_object(const SerdStatement *statement)

Return the object of the statement.

const SerdNode *serd_statement_graph(const SerdStatement *statement)

Return the graph of the statement.

const SerdCaret *serd_statement_caret(const SerdStatement *statement)

Return the source location where the statement originated, or NULL.

bool serd_statement_equals(const SerdStatement *a, const SerdStatement *b)

Return true iff a is equal to b, ignoring statement caret metadata.

Only returns true if nodes are equivalent, does not perform wildcard matching.

bool serd_statement_matches(const SerdStatement *statement, const SerdNode *subject, const SerdNode *predicate, const SerdNode *object, const SerdNode *graph)

Return true iff the statement matches the given pattern.

Nodes match if they are equivalent, or if one of them is NULL. The statement matches if every node matches.