Smallstr

XSmallstr

typedef struct{
  char buf[X_SMALLSTR_MAX_LENGTH+1];
  size_t length;
}XSmallstr;

x_smallstr_append_char

Appends a single character if space allows.

X_STRING_API size_t x_smallstr_append_char(
 XSmallstr *s,
 char c
);

x_smallstr_append_cstr

Appends a null-terminated C-string if space allows.

X_STRING_API size_t x_smallstr_append_cstr(
 XSmallstr *s,
 const char *cstr
);

x_smallstr_append_n

Appends a fixed-length portion of a C-string to a small string.

X_STRING_API size_t x_smallstr_append_n(
 XSmallstr *s,
 const char *cstr,
 size_t n
);

x_smallstr_append_slice

Appends the contents of a string view to a small string.

X_STRING_API size_t x_smallstr_append_slice(
 XSmallstr *s,
 XSlice sv
);

x_smallstr_appendf

Appends formatted text to a small string.

X_STRING_API size_t x_smallstr_appendf(
 XSmallstr *s,
 const char *fmt,
 ...
);

x_smallstr_capacity

Returns the maximum number of bytes (excluding terminator) a small string can hold.

X_STRING_API size_t x_smallstr_capacity(void);

x_smallstr_clear

Clears the small string to empty.

X_STRING_API void x_smallstr_clear(XSmallstr *s);

x_smallstr_cmp

Compares two small strings.

X_STRING_API int32_t x_smallstr_cmp(
 const XSmallstr *a,
 const XSmallstr *b
);

x_smallstr_cmp_ci

Compares two small strings case-insensitively.

X_STRING_API int32_t x_smallstr_cmp_ci(
 const XSmallstr *a,
 const XSmallstr *b
);

x_smallstr_cmp_cstr

Compares a small string with a null-terminated C-string.

X_STRING_API int32_t x_smallstr_cmp_cstr(
 const XSmallstr *a,
 const char *b
);

x_smallstr_contains_char

Checks whether a small string contains the specified character.

X_STRING_API bool x_smallstr_contains_char(
 const XSmallstr *s,
 char c
);

x_smallstr_cstr

Returns a pointer to the small string's null-terminated buffer.

X_STRING_API const char * x_smallstr_cstr(const XSmallstr *s);

x_smallstr_format

Formats text into a small string; truncates if necessary.

X_STRING_API size_t x_smallstr_format(
 XSmallstr *s,
 const char *fmt,
 ...
);

x_smallstr_from_cstr

Copies a null-terminated C-string into a small string.

X_STRING_API size_t x_smallstr_from_cstr(
 XSmallstr *s,
 const char *cstr
);

x_smallstr_from_slice

Copies a string view into a small string.

X_STRING_API size_t x_smallstr_from_slice(
 XSlice sv,
 XSmallstr *out
);

x_smallstr_init

Initializes a fixed-capacity small string from a source C-string.

X_STRING_API int32_t x_smallstr_init(
 XSmallstr *s,
 const char *str
);

x_smallstr_is_empty

Tests whether a small string is empty.

X_STRING_API bool x_smallstr_is_empty(const XSmallstr *s);

x_smallstr_join

Concatenates multiple string views into a small string, inserting a separator between them.

X_STRING_API size_t x_smallstr_join(
 XSmallstr *dst,
 const XSlice *parts,
 size_t count,
 XSlice sep
);

x_smallstr_length

Returns the current byte length of the small string.

X_STRING_API size_t x_smallstr_length(const XSmallstr *s);

x_smallstr_replace_all

Replaces all occurrences of a substring in a small string.

X_STRING_API int32_t x_smallstr_replace_all(
 XSmallstr *s,
 const char *find,
 const char *replace
);

x_smallstr_substring

Copies a byte-range substring into a small string.

X_STRING_API size_t x_smallstr_substring(
 const XSmallstr *s,
 size_t start,
 size_t len,
 XSmallstr *out
);

x_smallstr_to_slice

Creates a non-owning view over a small string's contents.

X_STRING_API XSlice x_smallstr_to_slice(const XSmallstr *s);

x_smallstr_trim

Trims leading and trailing ASCII whitespace in a small string.

X_STRING_API void x_smallstr_trim(XSmallstr *s);

x_smallstr_trim_left

Trims leading ASCII whitespace in a small string.

X_STRING_API void x_smallstr_trim_left(XSmallstr *s);

x_smallstr_trim_right

Trims trailing ASCII whitespace in a small string.

X_STRING_API void x_smallstr_trim_right(XSmallstr *s);

x_smallstr_try_append_cstr

Attempts to append a C-string to a small string up to its capacity.

X_STRING_API bool x_smallstr_try_append_cstr(
 XSmallstr *s,
 const char *cstr,
 size_t *out_appended
);

x_smallstr_vappendf

Appends formatted text to a small string using a va_list.

X_STRING_API size_t x_smallstr_vappendf(
 XSmallstr *s,
 const char *fmt,
 va_list args
);