docs/wsar_html.zip:wsar_html/wmem__strbuf_8h_source.html

#ifndef __WMEM_STRBUF_H__

#define __WMEM_STRBUF_H__


#include <ws_codepoints.h>


#include "wmem_core.h"


#ifdef __cplusplus

extern "C" {

#endif /* __cplusplus */


struct _wmem_strbuf_t {

    wmem_allocator_t *allocator;


    char *str;


    size_t len;


    size_t alloc_size;

};


typedef struct _wmem_strbuf_t wmem_strbuf_t;


WS_DLL_PUBLIC

wmem_strbuf_t *

wmem_strbuf_new_sized(wmem_allocator_t *allocator, size_t alloc_size);


WS_DLL_PUBLIC

wmem_strbuf_t *

wmem_strbuf_new(wmem_allocator_t *allocator, const char *str);


#define wmem_strbuf_create(allocator) \

    wmem_strbuf_new(allocator, "")


WS_DLL_PUBLIC

wmem_strbuf_t *

wmem_strbuf_new_len(wmem_allocator_t *allocator, const char *str, size_t len);


WS_DLL_PUBLIC

wmem_strbuf_t *

wmem_strbuf_dup(wmem_allocator_t *allocator, const wmem_strbuf_t *strbuf);


WS_DLL_PUBLIC

void

wmem_strbuf_append(wmem_strbuf_t *strbuf, const char *str);


WS_DLL_PUBLIC

void

wmem_strbuf_append_len(wmem_strbuf_t *strbuf, const char *str, size_t append_len);


WS_DLL_PUBLIC

void

wmem_strbuf_append_printf(wmem_strbuf_t *strbuf, const char *format, ...)

G_GNUC_PRINTF(2, 3);


WS_DLL_PUBLIC

void

wmem_strbuf_append_vprintf(wmem_strbuf_t *strbuf, const char *fmt, va_list ap);


WS_DLL_PUBLIC

void

wmem_strbuf_append_c(wmem_strbuf_t *strbuf, const char c);


WS_DLL_PUBLIC

void

wmem_strbuf_append_c_count(wmem_strbuf_t *strbuf, const char c, size_t count);


WS_DLL_PUBLIC

void

wmem_strbuf_append_unichar(wmem_strbuf_t *strbuf, const gunichar c);


#define wmem_strbuf_append_unichar_repl(buf) \

            wmem_strbuf_append_unichar(buf, UNICODE_REPLACEMENT_CHARACTER)


WS_DLL_PUBLIC

void

wmem_strbuf_append_unichar_validated(wmem_strbuf_t *strbuf, const gunichar c);


WS_DLL_PUBLIC

void

wmem_strbuf_append_hex(wmem_strbuf_t *strbuf, uint8_t ch);


WS_DLL_PUBLIC

size_t

wmem_strbuf_append_hex_unichar(wmem_strbuf_t *strbuf, gunichar ch);


WS_DLL_PUBLIC

void

wmem_strbuf_truncate(wmem_strbuf_t *strbuf, const size_t len);


WS_DLL_PUBLIC

const char *

wmem_strbuf_get_str(const wmem_strbuf_t *strbuf);


WS_DLL_PUBLIC

size_t

wmem_strbuf_get_len(const wmem_strbuf_t *strbuf);


WS_DLL_PUBLIC

int

wmem_strbuf_strcmp(const wmem_strbuf_t *sb1, const wmem_strbuf_t *sb2);


WS_DLL_PUBLIC

const char *

wmem_strbuf_strstr(const wmem_strbuf_t *haystack, const wmem_strbuf_t *needle);


WS_DLL_PUBLIC

char *

wmem_strbuf_finalize(wmem_strbuf_t *strbuf);


WS_DLL_PUBLIC

void

wmem_strbuf_destroy(wmem_strbuf_t *strbuf);


WS_DLL_PUBLIC

bool

wmem_strbuf_utf8_validate(wmem_strbuf_t *strbuf, const char **endptr);


WS_DLL_PUBLIC

void

wmem_strbuf_utf8_make_valid(wmem_strbuf_t *strbuf);


#ifdef __cplusplus

}

#endif /* __cplusplus */


#endif /* __WMEM_STRBUF_H__ */


/*

 * Editor modelines  -  https://www.wireshark.org/tools/modelines.html

 *

 * Local variables:

 * c-basic-offset: 4

 * tab-width: 8

 * indent-tabs-mode: nil

 * End:

 *

 * vi: set shiftwidth=4 tabstop=8 expandtab:

 * :indentSize=4:tabSize=8:noTabs=true:

 */

wmem_strbuf_append_vprintf
WS_DLL_PUBLIC void wmem_strbuf_append_vprintf(wmem_strbuf_t *strbuf, const char *fmt, va_list ap)
Append formatted text to a string buffer using a va_list.
Definition wmem_strbuf.c:182

wmem_strbuf_utf8_make_valid
WS_DLL_PUBLIC void wmem_strbuf_utf8_make_valid(wmem_strbuf_t *strbuf)
Ensure the contents of a wmem string buffer are valid UTF-8.
Definition wmem_strbuf.c:446

wmem_strbuf_new_sized
WS_DLL_PUBLIC wmem_strbuf_t * wmem_strbuf_new_sized(wmem_allocator_t *allocator, size_t alloc_size)
Create a new string buffer with a specified initial allocation size.
Definition wmem_strbuf.c:31

wmem_strbuf_get_str
WS_DLL_PUBLIC const char * wmem_strbuf_get_str(const wmem_strbuf_t *strbuf)
Retrieve the current string content from a wmem string buffer.
Definition wmem_strbuf.c:337

wmem_strbuf_append_unichar
WS_DLL_PUBLIC void wmem_strbuf_append_unichar(wmem_strbuf_t *strbuf, const gunichar c)
Append a Unicode character to a string buffer.
Definition wmem_strbuf.c:233

wmem_strbuf_append_unichar_validated
WS_DLL_PUBLIC void wmem_strbuf_append_unichar_validated(wmem_strbuf_t *strbuf, const gunichar c)
Append a validated Unicode character to a string buffer.
Definition wmem_strbuf.c:248

wmem_strbuf_append_c_count
WS_DLL_PUBLIC void wmem_strbuf_append_c_count(wmem_strbuf_t *strbuf, const char c, size_t count)
Append a character to a string buffer multiple times.
Definition wmem_strbuf.c:222

wmem_strbuf_utf8_validate
WS_DLL_PUBLIC bool wmem_strbuf_utf8_validate(wmem_strbuf_t *strbuf, const char **endptr)
Validate the contents of a wmem string buffer as UTF-8.
Definition wmem_strbuf.c:440

wmem_strbuf_new_len
WS_DLL_PUBLIC wmem_strbuf_t * wmem_strbuf_new_len(wmem_allocator_t *allocator, const char *str, size_t len)
Create a new string buffer initialized with a substring of specified length.
Definition wmem_strbuf.c:49

wmem_strbuf_append_len
WS_DLL_PUBLIC void wmem_strbuf_append_len(wmem_strbuf_t *strbuf, const char *str, size_t append_len)
Append a specified number of bytes from a string to a string buffer.
Definition wmem_strbuf.c:141

wmem_strbuf_get_len
WS_DLL_PUBLIC size_t wmem_strbuf_get_len(const wmem_strbuf_t *strbuf)
Retrieve the current length of a wmem string buffer.
Definition wmem_strbuf.c:343

wmem_strbuf_append_hex_unichar
WS_DLL_PUBLIC size_t wmem_strbuf_append_hex_unichar(wmem_strbuf_t *strbuf, gunichar ch)
Append an escape sequence representation of a Unicode character to a wmem string buffer.
Definition wmem_strbuf.c:311

wmem_strbuf_strcmp
WS_DLL_PUBLIC int wmem_strbuf_strcmp(const wmem_strbuf_t *sb1, const wmem_strbuf_t *sb2)
Compare the contents of two wmem string buffers.
Definition wmem_strbuf.c:366

wmem_strbuf_new
WS_DLL_PUBLIC wmem_strbuf_t * wmem_strbuf_new(wmem_allocator_t *allocator, const char *str)
Create a new string buffer initialized with a copy of the given string.
Definition wmem_strbuf.c:74

wmem_strbuf_finalize
WS_DLL_PUBLIC char * wmem_strbuf_finalize(wmem_strbuf_t *strbuf)
Finalize a wmem string buffer and extract its raw string.
Definition wmem_strbuf.c:382

wmem_strbuf_destroy
WS_DLL_PUBLIC void wmem_strbuf_destroy(wmem_strbuf_t *strbuf)
Destroy a wmem string buffer and release its associated memory.
Definition wmem_strbuf.c:395

wmem_strbuf_append_c
WS_DLL_PUBLIC void wmem_strbuf_append_c(wmem_strbuf_t *strbuf, const char c)
Append a single character to a string buffer.
Definition wmem_strbuf.c:212

wmem_strbuf_append_printf
WS_DLL_PUBLIC void wmem_strbuf_append_printf(wmem_strbuf_t *strbuf, const char *format,...)
Append formatted text to a string buffer.
Definition wmem_strbuf.c:202

wmem_strbuf_strstr
WS_DLL_PUBLIC const char * wmem_strbuf_strstr(const wmem_strbuf_t *haystack, const wmem_strbuf_t *needle)
Search for a substring within a wmem string buffer.
Definition wmem_strbuf.c:372

wmem_strbuf_truncate
WS_DLL_PUBLIC void wmem_strbuf_truncate(wmem_strbuf_t *strbuf, const size_t len)
Truncate a wmem string buffer to a specified length.
Definition wmem_strbuf.c:326

wmem_strbuf_dup
WS_DLL_PUBLIC wmem_strbuf_t * wmem_strbuf_dup(wmem_allocator_t *allocator, const wmem_strbuf_t *strbuf)
Duplicate an existing string buffer using the specified memory allocator.
Definition wmem_strbuf.c:80

wmem_strbuf_append
WS_DLL_PUBLIC void wmem_strbuf_append(wmem_strbuf_t *strbuf, const char *str)
Append a null-terminated string to the end of a string buffer.
Definition wmem_strbuf.c:123

wmem_strbuf_append_hex
WS_DLL_PUBLIC void wmem_strbuf_append_hex(wmem_strbuf_t *strbuf, uint8_t ch)
Append an escape sequence representation of a byte to a wmem string buffer.
Definition wmem_strbuf.c:263

_wmem_allocator_t
Internal memory allocator interface used by the wmem subsystem.
Definition wmem_allocator.h:34

_wmem_strbuf_t
Internal structure representing a wmem-allocated string buffer.
Definition wmem_strbuf.h:38

_wmem_strbuf_t::alloc_size
size_t alloc_size
Definition wmem_strbuf.h:60

_wmem_strbuf_t::allocator
wmem_allocator_t * allocator
Definition wmem_strbuf.h:42

_wmem_strbuf_t::str
char * str
Definition wmem_strbuf.h:48

_wmem_strbuf_t::len
size_t len
Definition wmem_strbuf.h:54

wmem_core.h