Slice

XSlice

typedef struct{
  const char *ptr;
  size_t length;
}XSlice;

X_STRVIEW

Creates a compile-time string view from a string literal.

#define X_STRVIEW(s) ((XSlice){(s), sizeof(s)-1u})

x_slice

#define x_slice(cstr) (x_slice_init((cstr), strlen(cstr)))

x_slice_cmp

Lexicographically compares two string views.

X_STRING_API int32_t x_slice_cmp(
 XSlice a,
 XSlice b
);

x_slice_cmp_ci

Lexicographically compares two string views case-insensitively.

X_STRING_API int32_t x_slice_cmp_ci(
 XSlice a,
 XSlice b
);

x_slice_contains_char

Checks whether a string view contains the specified character.

X_STRING_API bool x_slice_contains_char(
 XSlice sv,
 char c
);

x_slice_contains_utf8

Checks whether a string view contains the specified UTF-8 codepoint.

X_STRING_API bool x_slice_contains_utf8(
 XSlice sv,
 uint32_t codepoint
);

x_slice_ends_with_cstr

Checks whether a string view ends with the given C-string suffix.

X_STRING_API bool x_slice_ends_with_cstr(
 XSlice sv,
 const char *prefix
);

x_slice_eq

Compares two string views for equality.

X_STRING_API bool x_slice_eq(
 XSlice a,
 XSlice b
);

x_slice_eq_ci

Compares two string views case-insensitively.

X_STRING_API bool x_slice_eq_ci(
 XSlice a,
 XSlice b
);

x_slice_eq_cstr

Compares a string view with a C-string for equality.

X_STRING_API bool x_slice_eq_cstr(
 XSlice a,
 const char *b
);

x_slice_find

Finds the first occurrence of a character in a string view.

X_STRING_API int32_t x_slice_find(
 XSlice sv,
 char c
);

x_slice_find_white_space

Finds the next ASCII whitespace in a string view.

X_STRING_API int32_t x_slice_find_white_space(XSlice sv);

x_slice_from_cstr

Creates a non-owning string view from a null-terminated C-string.

X_STRING_API XSlice x_slice_from_cstr(const char *s);

x_slice_from_smallstr

Creates a non-owning string view from a fixed-capacity small string.

X_STRING_API XSlice x_slice_from_smallstr(const XSmallstr *s);

x_slice_hash

Computes a 32-bit FNV hash for a XSlice

X_STRING_API uint32_t x_slice_hash(XSlice slice);

x_slice_init

#define x_slice_init(cstr, len) ((XSlice){.ptr=(cstr), .length=(len)})

x_slice_next_token

Extracts the next token delimited by a character.

X_STRING_API bool x_slice_next_token(
 XSlice *input,
 char delim,
 XSlice *token
);

x_slice_next_token_white_space

Extracts the next token delimited by ASCII whitespace.

X_STRING_API bool x_slice_next_token_white_space(
 XSlice *input,
 XSlice *token
);

x_slice_rfind

Finds the last occurrence of a character in a string view.

X_STRING_API int32_t x_slice_rfind(
 XSlice sv,
 char c
);

x_slice_split_at

Splits a string view at the first occurrence of a delimiter.

X_STRING_API bool x_slice_split_at(
 XSlice sv,
 char delim,
 XSlice *left,
 XSlice *right
);

x_slice_split_at_white_space

Splits a string view at the first ASCII whitespace.

X_STRING_API bool x_slice_split_at_white_space(
 XSlice sv,
 XSlice *left,
 XSlice *right
);

x_slice_starts_with_cstr

Checks whether a string view starts with the given C-string prefix.

X_STRING_API bool x_slice_starts_with_cstr(
 XSlice sv,
 const char *prefix
);

x_slice_substr

Creates a sub-view by byte range from a string view.

X_STRING_API XSlice x_slice_substr(
 XSlice sv,
 size_t start,
 size_t len
);

x_slice_trim

Removes leading and trailing ASCII whitespace from a string view.

X_STRING_API XSlice x_slice_trim(XSlice sv);

x_slice_trim_left

Removes leading ASCII whitespace from a string view.

X_STRING_API XSlice x_slice_trim_left(XSlice sv);

x_slice_trim_right

Removes trailing ASCII whitespace from a string view.

X_STRING_API XSlice x_slice_trim_right(XSlice sv);