5.13.1 Cursor

typedef struct SerdCursorImpl SerdCursor

A cursor that iterates over statements in a model.

A cursor is a smart iterator that visits all statements that match a pattern.

SerdCursor *serd_cursor_copy(SerdAllocator *allocator, const SerdCursor *cursor)

Return a new copy of cursor

const SerdStatement *serd_cursor_get(const SerdCursor *cursor)

Return the statement pointed to by cursor

SerdStatus serd_cursor_advance(SerdCursor *cursor)

Increment cursor to point to the next statement.

Returns

Failure if cursor was already at the end.

bool serd_cursor_is_end(const SerdCursor *cursor)

Return true if the cursor has reached its end.

bool serd_cursor_equals(const SerdCursor *lhs, const SerdCursor *rhs)

Return true iff lhs equals rhs.

Two cursors are equivalent if they point to the same statement in the same index in the same model, or are both the end of the same model. Note that two cursors can point to the same statement but not be equivalent, since they may have reached the statement via different indices.

void serd_cursor_free(SerdCursor *cursor)

Free cursor