Struct
GLibStrvBuilder
since: 2.68
Description [src]
struct GStrvBuilder {
/* No available fields */
}
GStrvBuilder is a helper object to build a NULL-terminated string arrays.
The following example shows how to build a two element array:
g_autoptr(GStrvBuilder) builder = g_strv_builder_new ();
g_strv_builder_add (builder, "hello");
g_strv_builder_add (builder, "world");
g_auto(GStrv) array = g_strv_builder_end (builder);
g_assert_true (g_strv_equal (array, (const char *[]) { "hello", "world", NULL }));
Available since: 2.68
Constructors
g_strv_builder_new
Creates a new GStrvBuilder with a reference count of 1.
Use g_strv_builder_unref() on the returned value when no longer needed.
since: 2.68
Instance methods
g_strv_builder_end
Ends the builder process and returns the constructed NULL-terminated string
array. The returned value should be freed with g_strfreev() when no longer needed.
g_strv_builder_ref
Atomically increments the reference count of builder by one.
This function is thread-safe and may be called from any thread.
since: 2.68
g_strv_builder_take
Add a string to the end of the array. After value belongs to the
GStrvBuilder and may no longer be modified by the caller.
g_strv_builder_unref_to_strv
Decreases the reference count on the string vector builder, and returns
its contents as a NULL-terminated string array.
since: 2.82