5.8.2.2 Dynamic Allocation

This is a convenient higher-level node construction API which allocates nodes with an allocator.

The returned nodes must be freed with serd_node_free() using the same allocator.

Note that in most cases it is better to use a SerdNodes instead of managing individual node allocations.

SerdNode *serd_node_new(SerdAllocator *allocator, SerdNodeType type, SerdStringView string, SerdNodeFlags flags, SerdStringView meta)

Create a new node of any type.

This is a wrapper for serd_node_construct() that allocates a new node on the heap.

Returns

A newly allocated node that must be freed with serd_node_free(), or null.

SerdNode *serd_new_token(SerdAllocator *allocator, SerdNodeType type, SerdStringView string)

Create a new simple “token” node.

This is a wrapper for serd_node_construct_token() that allocates a new node on the heap.

Returns

A newly allocated node that must be freed with serd_node_free(), or null.

SerdNode *serd_new_string(SerdAllocator *allocator, SerdStringView string)

Create a new string literal node.

This is a trivial wrapper for serd_new_token() that passes SERD_LITERAL for the type.

Returns

A newly allocated node that must be freed with serd_node_free(), or null.

SerdNode *serd_new_uri(SerdAllocator *allocator, SerdStringView string)

Create a new URI node from a string.

This is a wrapper for serd_node_construct_uri() that allocates a new node on the heap.

Returns

A newly allocated node that must be freed with serd_node_free(), or null.

SerdNode *serd_new_parsed_uri(SerdAllocator *allocator, SerdURIView uri)

Create a new URI node from a parsed URI.

This is a wrapper for serd_node_construct_uri() that allocates a new node on the heap.

Returns

A newly allocated node that must be freed with serd_node_free(), or null.

SerdNode *serd_new_file_uri(SerdAllocator *allocator, SerdStringView path, SerdStringView hostname)

Create a new file URI node from a path and optional hostname.

This is a wrapper for serd_node_construct_file_uri() that allocates a new node on the heap.

Returns

A newly allocated node that must be freed with serd_node_free(), or null.

SerdNode *serd_new_literal(SerdAllocator *allocator, SerdStringView string, SerdNodeFlags flags, SerdStringView meta)

Create a new literal node.

This is a wrapper for serd_node_construct_literal() that allocates a new node on the heap.

Returns

A newly allocated node that must be freed with serd_node_free(), or null.

SerdNode *serd_new_boolean(SerdAllocator *allocator, bool b)

Create a new canonical xsd:boolean node.

This is a wrapper for serd_node_construct_boolean() that allocates a new node on the heap.

Returns

A newly allocated node that must be freed with serd_node_free(), or null.

SerdNode *serd_new_decimal(SerdAllocator *allocator, double d)

Create a new canonical xsd:decimal literal.

This is a wrapper for serd_node_construct_decimal() that allocates a new node on the heap.

Returns

A newly allocated node that must be freed with serd_node_free(), or null.

SerdNode *serd_new_double(SerdAllocator *allocator, double d)

Create a new canonical xsd:double literal.

This is a wrapper for serd_node_construct_double() that allocates a new node on the heap.

Returns

A newly allocated node that must be freed with serd_node_free(), or null.

SerdNode *serd_new_float(SerdAllocator *allocator, float f)

Create a new canonical xsd:float literal.

This is a wrapper for serd_node_construct_float() that allocates a new node on the heap.

Returns

A newly allocated node that must be freed with serd_node_free(), or null.

SerdNode *serd_new_integer(SerdAllocator *allocator, int64_t i, SerdStringView datatype)

Create a new canonical xsd:integer literal.

This is a wrapper for serd_node_construct_integer() that allocates a new node on the heap.

Returns

A newly allocated node that must be freed with serd_node_free(), or null.

SerdNode *serd_new_base64(SerdAllocator *allocator, const void *buf, size_t size, SerdStringView datatype)

Create a new canonical xsd:base64Binary literal.

This is a wrapper for serd_node_construct_base64() that allocates a new node on the heap.

Returns

A newly allocated node that must be freed with serd_node_free(), or null.