5.2 String View

struct SerdStringView

An immutable slice of a string.

This type is used for many string parameters, to allow referring to slices of strings in-place and to avoid redundant string measurement.

const char *buf

Start of string.

size_t len

Length of string in bytes.

SERD_EMPTY_STRING()

Return a view of an empty string.

SERD_STRING(str)

Return a view of an entire string by measuring it.

This makes a view of the given string by measuring it with strlen.

Parameters

• str – Non-null pointer to the start of a null-terminated C string.

SERD_OPTIONAL_STRING(str)

Return a view of an entire string by measuring it, or the empty string.

This is the same as SERD_STRING, but tolerates null, in which case an empty string view is returned.

Parameters

• str – Pointer to the start of a null-terminated C string, or null.

SERD_SUBSTRING(str, len)

Return a view of a substring, or a premeasured string.

This makes either a view of a slice of a string (which may not be null terminated), or a view of a string that has already been measured. This is faster than SERD_STRING for dynamic strings since it does not call strlen, so should be used when the length of the string is already known.

Parameters

• str – Pointer to the start of the substring.

• len – Length of the substring in bytes, not including the trailing null terminator if present.