26#ifndef RTE_COMMON_STRING_H
27#define RTE_COMMON_STRING_H
38typedef struct rte_string_s
144 bool *out_found,
size_t *out_index);
160 bool *out_found,
size_t *out_index);
185 bool *out_has_token);
rte_status_t
Common result/status codes.
rte_status_t rte_string_to_u64(const rte_string_t *str, uint64_t *out_value)
As rte_string_to_u32(), for uint64_t.
rte_status_t rte_string_split_next(const rte_string_t *str, char delimiter, size_t *io_cursor, rte_const_buffer_t *out_token, bool *out_has_token)
Reentrant, bounded string splitting - unlike strtok(), all state is caller-owned via io_cursor,...
rte_status_t rte_string_from_i64(rte_string_t *dest, int64_t value)
Bounded base-10 itoa equivalent for int64_t. Replaces dest's content.
rte_status_t rte_string_from_i32(rte_string_t *dest, int32_t value)
Bounded base-10 itoa equivalent for int32_t. Replaces dest's content.
rte_status_t rte_string_copy(rte_string_t *dest, const char *src)
Bounded strcpy equivalent. Never calls strlen(src) - scans for a NUL only up to dest's capacity (REQ-...
rte_status_t rte_string_find_char(const rte_string_t *str, char c, bool *out_found, size_t *out_index)
Bounded strchr equivalent. "Not found" is a normal outcome, not an error - see out_found.
rte_status_t rte_string_find_substr(const rte_string_t *haystack, const rte_string_t *needle, bool *out_found, size_t *out_index)
Bounded strstr equivalent. "Not found" is a normal outcome, not an error - see out_found.
rte_status_t rte_string_append_i64(rte_string_t *dest, int64_t value)
Bounded base-10 append of an int64_t; a leading '-' is emitted for negative values....
rte_status_t rte_string_append_u32(rte_string_t *dest, uint32_t value)
Bounded base-10 append of a uint32_t to dest's existing content (unlike rte_string_from_u32(),...
size_t rte_string_length(const rte_string_t *str)
Returns a string's current length (not counting a NUL terminator).
rte_status_t rte_string_clear(rte_string_t *str)
Resets a string to empty. Capacity and storage are unchanged.
rte_status_t rte_string_concat(rte_string_t *dest, const char *src)
Bounded strcat equivalent. Never calls strlen(src) - scans for a NUL only up to dest's remaining capa...
rte_status_t rte_string_c_str(rte_string_t *str, const char **out_cstr)
Ensures a NUL terminator is present within capacity (without incrementing length) and returns a point...
rte_status_t rte_string_append_i32(rte_string_t *dest, int32_t value)
Bounded base-10 append of an int32_t; a leading '-' is emitted for negative values....
rte_status_t rte_string_append_hex_u32(rte_string_t *dest, uint32_t value, uint8_t min_digits)
Bounded append of a uint32_t formatted as lowercase hexadecimal (no "0x" prefix - the caller prepends...
rte_status_t rte_string_append_u64(rte_string_t *dest, uint64_t value)
Bounded base-10 append of a uint64_t. See rte_string_append_u32().
rte_status_t rte_string_init(rte_string_t *str, char *storage, size_t capacity)
Binds a string to caller-owned storage. Initial length is 0 (empty string).
rte_status_t rte_string_from_u64(rte_string_t *dest, uint64_t value)
Bounded base-10 itoa equivalent for uint64_t. Replaces dest's content.
rte_status_t rte_string_copy_n(rte_string_t *dest, const char *src, size_t src_len)
Bounded copy of an exact-length, not-necessarily-NUL-terminated source (e.g. a length-prefixed field)...
rte_status_t rte_string_to_i32(const rte_string_t *str, int32_t *out_value)
As rte_string_to_u32(), for int32_t; a leading '-' is accepted.
rte_status_t rte_string_to_i64(const rte_string_t *str, int64_t *out_value)
As rte_string_to_i32(), for int64_t.
rte_status_t rte_string_to_u32(const rte_string_t *str, uint32_t *out_value)
Bounded base-10 atoi equivalent for uint32_t.
rte_status_t rte_string_compare(const rte_string_t *a, const rte_string_t *b, int32_t *out_cmp)
Bounded strcmp equivalent. Compares up to the shorter string's length, then by length if that prefix ...
rte_status_t rte_string_from_u32(rte_string_t *dest, uint32_t value)
Bounded base-10 itoa equivalent for uint32_t. Replaces dest's content.
Cross-layer data buffer abstraction (ADR-002).
Common status/error codes returned by every Safe API Framework function. Shared across all OS Abstrac...
Common fixed-width types and the caller-owned-storage handle pattern used by every OAL service (see A...
Mutable, bounds-tracked view over caller-owned storage.
Read-only view of a buffer's currently valid bytes. Grants no write access to the underlying storage.
Bounded string: buf.length is the string length, not counting a NUL.
1.18.0