GI.GLib.Structs.StrvBuilder

StrvBuilder is a method of easily building dynamically sized NULL-terminated string arrays.

The following example shows how to build a two element array:

C code

 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);

Since: 2.68

Exported types

newtype StrvBuilder

Memory-managed wrapper type.

Constructors

StrvBuilder (ManagedPtr StrvBuilder)

Instances

Eq StrvBuilder

Defined in GI.GLib.Structs.StrvBuilder

Methods

(==) :: StrvBuilder -> StrvBuilder -> Bool

(/=) :: StrvBuilder -> StrvBuilder -> Bool

BoxedPtr StrvBuilder

Defined in GI.GLib.Structs.StrvBuilder

Methods

boxedPtrCopy :: StrvBuilder -> IO StrvBuilder

boxedPtrFree :: StrvBuilder -> IO ()

ManagedPtrNewtype StrvBuilder

Defined in GI.GLib.Structs.StrvBuilder

Methods

toManagedPtr :: StrvBuilder -> ManagedPtr StrvBuilder

Methods

Click to display all available methods, including inherited ones

Methods

add, addv, end.

Getters

None.

Setters

None.

add

strvBuilderAdd

Arguments

:: (HasCallStack, MonadIO m)

=> StrvBuilder

builder: a StrvBuilder

-> Text

value: a string.

-> m ()

Add a string to the end of the array.

Since 2.68

addv

strvBuilderAddv

Arguments

:: (HasCallStack, MonadIO m)

=> StrvBuilder

builder: a StrvBuilder

-> [Text]

value: the vector of strings to add

-> m ()

Appends all the strings in the given vector to the builder.

Since 2.70

end

strvBuilderEnd

Arguments

:: (HasCallStack, MonadIO m)

=> StrvBuilder

builder: a StrvBuilder

-> m [Text]

Returns: the constructed string array.

Since 2.68

Ends the builder process and returns the constructed NULL-terminated string array. The returned value should be freed with strfreev when no longer needed.