Array builder classes

Array builder classes

Functions

void garrow_array_builder_release_ownership ()
GArrowDataType * garrow_array_builder_get_value_data_type ()
GArrowType garrow_array_builder_get_value_type ()
GArrowArray * garrow_array_builder_finish ()
GArrowBooleanArrayBuilder * garrow_boolean_array_builder_new ()
gboolean garrow_boolean_array_builder_append ()
gboolean garrow_boolean_array_builder_append_values ()
gboolean garrow_boolean_array_builder_append_null ()
gboolean garrow_boolean_array_builder_append_nulls ()
GArrowIntArrayBuilder * garrow_int_array_builder_new ()
gboolean garrow_int_array_builder_append ()
gboolean garrow_int_array_builder_append_values ()
gboolean garrow_int_array_builder_append_null ()
gboolean garrow_int_array_builder_append_nulls ()
GArrowUIntArrayBuilder * garrow_uint_array_builder_new ()
gboolean garrow_uint_array_builder_append ()
gboolean garrow_uint_array_builder_append_values ()
gboolean garrow_uint_array_builder_append_null ()
gboolean garrow_uint_array_builder_append_nulls ()
GArrowInt8ArrayBuilder * garrow_int8_array_builder_new ()
gboolean garrow_int8_array_builder_append ()
gboolean garrow_int8_array_builder_append_values ()
gboolean garrow_int8_array_builder_append_null ()
gboolean garrow_int8_array_builder_append_nulls ()
GArrowUInt8ArrayBuilder * garrow_uint8_array_builder_new ()
gboolean garrow_uint8_array_builder_append ()
gboolean garrow_uint8_array_builder_append_values ()
gboolean garrow_uint8_array_builder_append_null ()
gboolean garrow_uint8_array_builder_append_nulls ()
GArrowInt16ArrayBuilder * garrow_int16_array_builder_new ()
gboolean garrow_int16_array_builder_append ()
gboolean garrow_int16_array_builder_append_values ()
gboolean garrow_int16_array_builder_append_null ()
gboolean garrow_int16_array_builder_append_nulls ()
GArrowUInt16ArrayBuilder * garrow_uint16_array_builder_new ()
gboolean garrow_uint16_array_builder_append ()
gboolean garrow_uint16_array_builder_append_values ()
gboolean garrow_uint16_array_builder_append_null ()
gboolean garrow_uint16_array_builder_append_nulls ()
GArrowInt32ArrayBuilder * garrow_int32_array_builder_new ()
gboolean garrow_int32_array_builder_append ()
gboolean garrow_int32_array_builder_append_values ()
gboolean garrow_int32_array_builder_append_null ()
gboolean garrow_int32_array_builder_append_nulls ()
GArrowUInt32ArrayBuilder * garrow_uint32_array_builder_new ()
gboolean garrow_uint32_array_builder_append ()
gboolean garrow_uint32_array_builder_append_values ()
gboolean garrow_uint32_array_builder_append_null ()
gboolean garrow_uint32_array_builder_append_nulls ()
GArrowInt64ArrayBuilder * garrow_int64_array_builder_new ()
gboolean garrow_int64_array_builder_append ()
gboolean garrow_int64_array_builder_append_values ()
gboolean garrow_int64_array_builder_append_null ()
gboolean garrow_int64_array_builder_append_nulls ()
GArrowUInt64ArrayBuilder * garrow_uint64_array_builder_new ()
gboolean garrow_uint64_array_builder_append ()
gboolean garrow_uint64_array_builder_append_values ()
gboolean garrow_uint64_array_builder_append_null ()
gboolean garrow_uint64_array_builder_append_nulls ()
GArrowFloatArrayBuilder * garrow_float_array_builder_new ()
gboolean garrow_float_array_builder_append ()
gboolean garrow_float_array_builder_append_values ()
gboolean garrow_float_array_builder_append_null ()
gboolean garrow_float_array_builder_append_nulls ()
GArrowDoubleArrayBuilder * garrow_double_array_builder_new ()
gboolean garrow_double_array_builder_append ()
gboolean garrow_double_array_builder_append_values ()
gboolean garrow_double_array_builder_append_null ()
gboolean garrow_double_array_builder_append_nulls ()
GArrowBinaryArrayBuilder * garrow_binary_array_builder_new ()
gboolean garrow_binary_array_builder_append ()
gboolean garrow_binary_array_builder_append_null ()
GArrowStringArrayBuilder * garrow_string_array_builder_new ()
gboolean garrow_string_array_builder_append ()
gboolean garrow_string_array_builder_append_values ()
GArrowDate32ArrayBuilder * garrow_date32_array_builder_new ()
gboolean garrow_date32_array_builder_append ()
gboolean garrow_date32_array_builder_append_values ()
gboolean garrow_date32_array_builder_append_null ()
gboolean garrow_date32_array_builder_append_nulls ()
GArrowDate64ArrayBuilder * garrow_date64_array_builder_new ()
gboolean garrow_date64_array_builder_append ()
gboolean garrow_date64_array_builder_append_values ()
gboolean garrow_date64_array_builder_append_null ()
gboolean garrow_date64_array_builder_append_nulls ()
GArrowTimestampArrayBuilder * garrow_timestamp_array_builder_new ()
gboolean garrow_timestamp_array_builder_append ()
gboolean garrow_timestamp_array_builder_append_values ()
gboolean garrow_timestamp_array_builder_append_null ()
gboolean garrow_timestamp_array_builder_append_nulls ()
GArrowTime32ArrayBuilder * garrow_time32_array_builder_new ()
gboolean garrow_time32_array_builder_append ()
gboolean garrow_time32_array_builder_append_values ()
gboolean garrow_time32_array_builder_append_null ()
gboolean garrow_time32_array_builder_append_nulls ()
GArrowTime64ArrayBuilder * garrow_time64_array_builder_new ()
gboolean garrow_time64_array_builder_append ()
gboolean garrow_time64_array_builder_append_values ()
gboolean garrow_time64_array_builder_append_null ()
gboolean garrow_time64_array_builder_append_nulls ()
GArrowListArrayBuilder * garrow_list_array_builder_new ()
gboolean garrow_list_array_builder_append ()
gboolean garrow_list_array_builder_append_null ()
GArrowArrayBuilder * garrow_list_array_builder_get_value_builder ()
GArrowStructArrayBuilder * garrow_struct_array_builder_new ()
gboolean garrow_struct_array_builder_append ()
gboolean garrow_struct_array_builder_append_null ()
GArrowArrayBuilder * garrow_struct_array_builder_get_field_builder ()
GList * garrow_struct_array_builder_get_field_builders ()
GArrowDecimal128ArrayBuilder * garrow_decimal128_array_builder_new ()
gboolean garrow_decimal128_array_builder_append ()

Properties

gpointer array-builder Write / Construct Only

Types and Values

Object Hierarchy

    GObject
    ╰── GArrowArrayBuilder
        ├── GArrowBinaryArrayBuilder
        ├── GArrowBooleanArrayBuilder
        ├── GArrowDate32ArrayBuilder
        ├── GArrowDate64ArrayBuilder
        ├── GArrowDecimal128ArrayBuilder
        ├── GArrowDoubleArrayBuilder
        ├── GArrowFloatArrayBuilder
        ├── GArrowInt16ArrayBuilder
        ├── GArrowInt32ArrayBuilder
        ├── GArrowInt64ArrayBuilder
        ├── GArrowInt8ArrayBuilder
        ├── GArrowIntArrayBuilder
        ├── GArrowListArrayBuilder
        ├── GArrowStructArrayBuilder
        ├── GArrowTime32ArrayBuilder
        ├── GArrowTime64ArrayBuilder
        ├── GArrowTimestampArrayBuilder
        ├── GArrowUInt16ArrayBuilder
        ├── GArrowUInt32ArrayBuilder
        ├── GArrowUInt64ArrayBuilder
        ├── GArrowUInt8ArrayBuilder
        ├── GArrowUIntArrayBuilder
        ├── GArrowBinaryArrayBuilder
           ╰── GArrowStringArrayBuilder
        ├── GArrowBooleanArrayBuilder
        ├── GArrowDate32ArrayBuilder
        ├── GArrowDate64ArrayBuilder
        ├── GArrowDoubleArrayBuilder
        ├── GArrowFloatArrayBuilder
        ├── GArrowInt16ArrayBuilder
        ├── GArrowInt32ArrayBuilder
        ├── GArrowInt64ArrayBuilder
        ├── GArrowInt8ArrayBuilder
        ├── GArrowIntArrayBuilder
        ├── GArrowListArrayBuilder
        ├── GArrowStructArrayBuilder
        ├── GArrowTime32ArrayBuilder
        ├── GArrowTime64ArrayBuilder
        ├── GArrowTimestampArrayBuilder
        ├── GArrowUInt16ArrayBuilder
        ├── GArrowUInt32ArrayBuilder
        ├── GArrowUInt64ArrayBuilder
        ╰── GArrowUInt8ArrayBuilder

Includes

#include <arrow-glib/arrow-glib.h>

Description

GArrowArrayBuilder is a base class for all array builder classes such as GArrowBooleanArrayBuilder.

You need to use array builder class to create a new array.

GArrowBooleanArrayBuilder is the class to create a new GArrowBooleanArray.

GArrowIntArrayBuilder is the class to create a new integer array. Integer size is automatically chosen. It's recommend that you use this builder instead of specific integer size builder such as GArrowInt8ArrayBuilder.

GArrowUIntArrayBuilder is the class to create a new unsigned integer array. Unsigned integer size is automatically chosen. It's recommend that you use this builder instead of specific unsigned integer size builder such as GArrowUInt8ArrayBuilder.

GArrowInt8ArrayBuilder is the class to create a new GArrowInt8Array.

GArrowUInt8ArrayBuilder is the class to create a new GArrowUInt8Array.

GArrowInt16ArrayBuilder is the class to create a new GArrowInt16Array.

GArrowUInt16ArrayBuilder is the class to create a new GArrowUInt16Array.

GArrowInt32ArrayBuilder is the class to create a new GArrowInt32Array.

GArrowUInt32ArrayBuilder is the class to create a new GArrowUInt32Array.

GArrowInt64ArrayBuilder is the class to create a new GArrowInt64Array.

GArrowUInt64ArrayBuilder is the class to create a new GArrowUInt64Array.

GArrowFloatArrayBuilder is the class to creating a new GArrowFloatArray.

GArrowDoubleArrayBuilder is the class to create a new GArrowDoubleArray.

GArrowBinaryArrayBuilder is the class to create a new GArrowBinaryArray.

GArrowStringArrayBuilder is the class to create a new GArrowStringArray.

GArrowDate32ArrayBuilder is the class to create a new GArrowDate32Array.

GArrowDate64ArrayBuilder is the class to create a new GArrowDate64Array.

GArrowTimestampArrayBuilder is the class to create a new GArrowTimestampArray.

GArrowTime32ArrayBuilder is the class to create a new GArrowTime32Array.

GArrowTime64ArrayBuilder is the class to create a new GArrowTime64Array.

GArrowListArrayBuilder is the class to create a new GArrowListArray.

GArrowStructArrayBuilder is the class to create a new GArrowStructArray.

GArrowDecimal128ArrayBuilder is the class to create a new GArrowDecimal128Array.

Functions

garrow_array_builder_release_ownership ()

void
garrow_array_builder_release_ownership
                               (GArrowArrayBuilder *builder);

Release ownership of arrow::ArrayBuilder in builder.

[skip]

Parameters

builder

A GArrowArrayBuilder.

 

Since: 0.8.0


garrow_array_builder_get_value_data_type ()

GArrowDataType *
garrow_array_builder_get_value_data_type
                               (GArrowArrayBuilder *builder);

Parameters

builder

A GArrowArrayBuilder.

 

Returns

The GArrowDataType of the value of the array builder.

[transfer full]

Since: 0.9.0


garrow_array_builder_get_value_type ()

GArrowType
garrow_array_builder_get_value_type (GArrowArrayBuilder *builder);

Parameters

builder

A GArrowArrayBuilder.

 

Returns

The GArrowType of the value of the array builder.

Since: 0.9.0


garrow_array_builder_finish ()

GArrowArray *
garrow_array_builder_finish (GArrowArrayBuilder *builder,
                             GError **error);

Parameters

builder

A GArrowArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

The built GArrowArray on success, NULL on error.

[transfer full]


garrow_boolean_array_builder_new ()

GArrowBooleanArrayBuilder *
garrow_boolean_array_builder_new (void);

Returns

A newly created GArrowBooleanArrayBuilder.


garrow_boolean_array_builder_append ()

gboolean
garrow_boolean_array_builder_append (GArrowBooleanArrayBuilder *builder,
                                     gboolean value,
                                     GError **error);

Parameters

builder

A GArrowBooleanArrayBuilder.

 

value

A boolean value.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_boolean_array_builder_append_values ()

gboolean
garrow_boolean_array_builder_append_values
                               (GArrowBooleanArrayBuilder *builder,
                                const gboolean *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowBooleanArrayBuilder.

 

values

The array of boolean.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_boolean_array_builder_append_null ()

gboolean
garrow_boolean_array_builder_append_null
                               (GArrowBooleanArrayBuilder *builder,
                                GError **error);

Parameters

builder

A GArrowBooleanArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_boolean_array_builder_append_nulls ()

gboolean
garrow_boolean_array_builder_append_nulls
                               (GArrowBooleanArrayBuilder *builder,
                                gint64 n,
                                GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowBooleanArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_int_array_builder_new ()

GArrowIntArrayBuilder *
garrow_int_array_builder_new (void);

Returns

A newly created GArrowIntArrayBuilder.

Since: 0.6.0


garrow_int_array_builder_append ()

gboolean
garrow_int_array_builder_append (GArrowIntArrayBuilder *builder,
                                 gint64 value,
                                 GError **error);

Parameters

builder

A GArrowIntArrayBuilder.

 

value

A int value.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.6.0


garrow_int_array_builder_append_values ()

gboolean
garrow_int_array_builder_append_values
                               (GArrowIntArrayBuilder *builder,
                                const gint64 *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowIntArrayBuilder.

 

values

The array of int.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_int_array_builder_append_null ()

gboolean
garrow_int_array_builder_append_null (GArrowIntArrayBuilder *builder,
                                      GError **error);

Parameters

builder

A GArrowIntArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.6.0


garrow_int_array_builder_append_nulls ()

gboolean
garrow_int_array_builder_append_nulls (GArrowIntArrayBuilder *builder,
                                       gint64 n,
                                       GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowIntArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_uint_array_builder_new ()

GArrowUIntArrayBuilder *
garrow_uint_array_builder_new (void);

Returns

A newly created GArrowUIntArrayBuilder.

Since: 0.8.0


garrow_uint_array_builder_append ()

gboolean
garrow_uint_array_builder_append (GArrowUIntArrayBuilder *builder,
                                  guint64 value,
                                  GError **error);

Parameters

builder

A GArrowUIntArrayBuilder.

 

value

A unsigned int value.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_uint_array_builder_append_values ()

gboolean
garrow_uint_array_builder_append_values
                               (GArrowUIntArrayBuilder *builder,
                                const guint64 *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowUIntArrayBuilder.

 

values

The array of unsigned int.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_uint_array_builder_append_null ()

gboolean
garrow_uint_array_builder_append_null (GArrowUIntArrayBuilder *builder,
                                       GError **error);

Parameters

builder

A GArrowUIntArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_uint_array_builder_append_nulls ()

gboolean
garrow_uint_array_builder_append_nulls
                               (GArrowUIntArrayBuilder *builder,
                                gint64 n,
                                GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowUIntArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_int8_array_builder_new ()

GArrowInt8ArrayBuilder *
garrow_int8_array_builder_new (void);

Returns

A newly created GArrowInt8ArrayBuilder.


garrow_int8_array_builder_append ()

gboolean
garrow_int8_array_builder_append (GArrowInt8ArrayBuilder *builder,
                                  gint8 value,
                                  GError **error);

Parameters

builder

A GArrowInt8ArrayBuilder.

 

value

A int8 value.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_int8_array_builder_append_values ()

gboolean
garrow_int8_array_builder_append_values
                               (GArrowInt8ArrayBuilder *builder,
                                const gint8 *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowInt8ArrayBuilder.

 

values

The array of int8.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_int8_array_builder_append_null ()

gboolean
garrow_int8_array_builder_append_null (GArrowInt8ArrayBuilder *builder,
                                       GError **error);

Parameters

builder

A GArrowInt8ArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_int8_array_builder_append_nulls ()

gboolean
garrow_int8_array_builder_append_nulls
                               (GArrowInt8ArrayBuilder *builder,
                                gint64 n,
                                GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowInt8ArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_uint8_array_builder_new ()

GArrowUInt8ArrayBuilder *
garrow_uint8_array_builder_new (void);

Returns

A newly created GArrowUInt8ArrayBuilder.


garrow_uint8_array_builder_append ()

gboolean
garrow_uint8_array_builder_append (GArrowUInt8ArrayBuilder *builder,
                                   guint8 value,
                                   GError **error);

Parameters

builder

A GArrowUInt8ArrayBuilder.

 

value

An uint8 value.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_uint8_array_builder_append_values ()

gboolean
garrow_uint8_array_builder_append_values
                               (GArrowUInt8ArrayBuilder *builder,
                                const guint8 *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowUInt8ArrayBuilder.

 

values

The array of uint8.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_uint8_array_builder_append_null ()

gboolean
garrow_uint8_array_builder_append_null
                               (GArrowUInt8ArrayBuilder *builder,
                                GError **error);

Parameters

builder

A GArrowUInt8ArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_uint8_array_builder_append_nulls ()

gboolean
garrow_uint8_array_builder_append_nulls
                               (GArrowUInt8ArrayBuilder *builder,
                                gint64 n,
                                GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowUInt8ArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_int16_array_builder_new ()

GArrowInt16ArrayBuilder *
garrow_int16_array_builder_new (void);

Returns

A newly created GArrowInt16ArrayBuilder.


garrow_int16_array_builder_append ()

gboolean
garrow_int16_array_builder_append (GArrowInt16ArrayBuilder *builder,
                                   gint16 value,
                                   GError **error);

Parameters

builder

A GArrowInt16ArrayBuilder.

 

value

A int16 value.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_int16_array_builder_append_values ()

gboolean
garrow_int16_array_builder_append_values
                               (GArrowInt16ArrayBuilder *builder,
                                const gint16 *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowInt16ArrayBuilder.

 

values

The array of int16.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_int16_array_builder_append_null ()

gboolean
garrow_int16_array_builder_append_null
                               (GArrowInt16ArrayBuilder *builder,
                                GError **error);

Parameters

builder

A GArrowInt16ArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_int16_array_builder_append_nulls ()

gboolean
garrow_int16_array_builder_append_nulls
                               (GArrowInt16ArrayBuilder *builder,
                                gint64 n,
                                GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowInt16ArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_uint16_array_builder_new ()

GArrowUInt16ArrayBuilder *
garrow_uint16_array_builder_new (void);

Returns

A newly created GArrowUInt16ArrayBuilder.


garrow_uint16_array_builder_append ()

gboolean
garrow_uint16_array_builder_append (GArrowUInt16ArrayBuilder *builder,
                                    guint16 value,
                                    GError **error);

Parameters

builder

A GArrowUInt16ArrayBuilder.

 

value

An uint16 value.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_uint16_array_builder_append_values ()

gboolean
garrow_uint16_array_builder_append_values
                               (GArrowUInt16ArrayBuilder *builder,
                                const guint16 *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowUInt16ArrayBuilder.

 

values

The array of uint16.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_uint16_array_builder_append_null ()

gboolean
garrow_uint16_array_builder_append_null
                               (GArrowUInt16ArrayBuilder *builder,
                                GError **error);

Parameters

builder

A GArrowUInt16ArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_uint16_array_builder_append_nulls ()

gboolean
garrow_uint16_array_builder_append_nulls
                               (GArrowUInt16ArrayBuilder *builder,
                                gint64 n,
                                GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowUInt16ArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_int32_array_builder_new ()

GArrowInt32ArrayBuilder *
garrow_int32_array_builder_new (void);

Returns

A newly created GArrowInt32ArrayBuilder.


garrow_int32_array_builder_append ()

gboolean
garrow_int32_array_builder_append (GArrowInt32ArrayBuilder *builder,
                                   gint32 value,
                                   GError **error);

Parameters

builder

A GArrowInt32ArrayBuilder.

 

value

A int32 value.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_int32_array_builder_append_values ()

gboolean
garrow_int32_array_builder_append_values
                               (GArrowInt32ArrayBuilder *builder,
                                const gint32 *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowInt32ArrayBuilder.

 

values

The array of int32.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_int32_array_builder_append_null ()

gboolean
garrow_int32_array_builder_append_null
                               (GArrowInt32ArrayBuilder *builder,
                                GError **error);

Parameters

builder

A GArrowInt32ArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_int32_array_builder_append_nulls ()

gboolean
garrow_int32_array_builder_append_nulls
                               (GArrowInt32ArrayBuilder *builder,
                                gint64 n,
                                GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowInt32ArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_uint32_array_builder_new ()

GArrowUInt32ArrayBuilder *
garrow_uint32_array_builder_new (void);

Returns

A newly created GArrowUInt32ArrayBuilder.


garrow_uint32_array_builder_append ()

gboolean
garrow_uint32_array_builder_append (GArrowUInt32ArrayBuilder *builder,
                                    guint32 value,
                                    GError **error);

Parameters

builder

A GArrowUInt32ArrayBuilder.

 

value

An uint32 value.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_uint32_array_builder_append_values ()

gboolean
garrow_uint32_array_builder_append_values
                               (GArrowUInt32ArrayBuilder *builder,
                                const guint32 *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowUInt32ArrayBuilder.

 

values

The array of uint32.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_uint32_array_builder_append_null ()

gboolean
garrow_uint32_array_builder_append_null
                               (GArrowUInt32ArrayBuilder *builder,
                                GError **error);

Parameters

builder

A GArrowUInt32ArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_uint32_array_builder_append_nulls ()

gboolean
garrow_uint32_array_builder_append_nulls
                               (GArrowUInt32ArrayBuilder *builder,
                                gint64 n,
                                GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowUInt32ArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_int64_array_builder_new ()

GArrowInt64ArrayBuilder *
garrow_int64_array_builder_new (void);

Returns

A newly created GArrowInt64ArrayBuilder.


garrow_int64_array_builder_append ()

gboolean
garrow_int64_array_builder_append (GArrowInt64ArrayBuilder *builder,
                                   gint64 value,
                                   GError **error);

Parameters

builder

A GArrowInt64ArrayBuilder.

 

value

A int64 value.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_int64_array_builder_append_values ()

gboolean
garrow_int64_array_builder_append_values
                               (GArrowInt64ArrayBuilder *builder,
                                const gint64 *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowInt64ArrayBuilder.

 

values

The array of int64.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_int64_array_builder_append_null ()

gboolean
garrow_int64_array_builder_append_null
                               (GArrowInt64ArrayBuilder *builder,
                                GError **error);

Parameters

builder

A GArrowInt64ArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_int64_array_builder_append_nulls ()

gboolean
garrow_int64_array_builder_append_nulls
                               (GArrowInt64ArrayBuilder *builder,
                                gint64 n,
                                GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowInt64ArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_uint64_array_builder_new ()

GArrowUInt64ArrayBuilder *
garrow_uint64_array_builder_new (void);

Returns

A newly created GArrowUInt64ArrayBuilder.


garrow_uint64_array_builder_append ()

gboolean
garrow_uint64_array_builder_append (GArrowUInt64ArrayBuilder *builder,
                                    guint64 value,
                                    GError **error);

Parameters

builder

A GArrowUInt64ArrayBuilder.

 

value

An uint64 value.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_uint64_array_builder_append_values ()

gboolean
garrow_uint64_array_builder_append_values
                               (GArrowUInt64ArrayBuilder *builder,
                                const guint64 *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowUInt64ArrayBuilder.

 

values

The array of uint64.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_uint64_array_builder_append_null ()

gboolean
garrow_uint64_array_builder_append_null
                               (GArrowUInt64ArrayBuilder *builder,
                                GError **error);

Parameters

builder

A GArrowUInt64ArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_uint64_array_builder_append_nulls ()

gboolean
garrow_uint64_array_builder_append_nulls
                               (GArrowUInt64ArrayBuilder *builder,
                                gint64 n,
                                GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowUInt64ArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_float_array_builder_new ()

GArrowFloatArrayBuilder *
garrow_float_array_builder_new (void);

Returns

A newly created GArrowFloatArrayBuilder.


garrow_float_array_builder_append ()

gboolean
garrow_float_array_builder_append (GArrowFloatArrayBuilder *builder,
                                   gfloat value,
                                   GError **error);

Parameters

builder

A GArrowFloatArrayBuilder.

 

value

A float value.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_float_array_builder_append_values ()

gboolean
garrow_float_array_builder_append_values
                               (GArrowFloatArrayBuilder *builder,
                                const gfloat *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowFloatArrayBuilder.

 

values

The array of float.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_float_array_builder_append_null ()

gboolean
garrow_float_array_builder_append_null
                               (GArrowFloatArrayBuilder *builder,
                                GError **error);

Parameters

builder

A GArrowFloatArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_float_array_builder_append_nulls ()

gboolean
garrow_float_array_builder_append_nulls
                               (GArrowFloatArrayBuilder *builder,
                                gint64 n,
                                GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowFloatArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_double_array_builder_new ()

GArrowDoubleArrayBuilder *
garrow_double_array_builder_new (void);

Returns

A newly created GArrowDoubleArrayBuilder.


garrow_double_array_builder_append ()

gboolean
garrow_double_array_builder_append (GArrowDoubleArrayBuilder *builder,
                                    gdouble value,
                                    GError **error);

Parameters

builder

A GArrowDoubleArrayBuilder.

 

value

A double value.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_double_array_builder_append_values ()

gboolean
garrow_double_array_builder_append_values
                               (GArrowDoubleArrayBuilder *builder,
                                const gdouble *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowDoubleArrayBuilder.

 

values

The array of double.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_double_array_builder_append_null ()

gboolean
garrow_double_array_builder_append_null
                               (GArrowDoubleArrayBuilder *builder,
                                GError **error);

Parameters

builder

A GArrowDoubleArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_double_array_builder_append_nulls ()

gboolean
garrow_double_array_builder_append_nulls
                               (GArrowDoubleArrayBuilder *builder,
                                gint64 n,
                                GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowDoubleArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_binary_array_builder_new ()

GArrowBinaryArrayBuilder *
garrow_binary_array_builder_new (void);

Returns

A newly created GArrowBinaryArrayBuilder.


garrow_binary_array_builder_append ()

gboolean
garrow_binary_array_builder_append (GArrowBinaryArrayBuilder *builder,
                                    const guint8 *value,
                                    gint32 length,
                                    GError **error);

Parameters

builder

A GArrowBinaryArrayBuilder.

 

value

A binary value.

[array length=length]

length

A value length.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_binary_array_builder_append_null ()

gboolean
garrow_binary_array_builder_append_null
                               (GArrowBinaryArrayBuilder *builder,
                                GError **error);

Parameters

builder

A GArrowBinaryArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_string_array_builder_new ()

GArrowStringArrayBuilder *
garrow_string_array_builder_new (void);

Returns

A newly created GArrowStringArrayBuilder.


garrow_string_array_builder_append ()

gboolean
garrow_string_array_builder_append (GArrowStringArrayBuilder *builder,
                                    const gchar *value,
                                    GError **error);

Parameters

builder

A GArrowStringArrayBuilder.

 

value

A string value.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.


garrow_string_array_builder_append_values ()

gboolean
garrow_string_array_builder_append_values
                               (GArrowStringArrayBuilder *builder,
                                const gchar **values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowStringArrayBuilder.

 

values

The array of strings.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.10.0


garrow_date32_array_builder_new ()

GArrowDate32ArrayBuilder *
garrow_date32_array_builder_new (void);

Returns

A newly created GArrowDate32ArrayBuilder.

Since: 0.7.0


garrow_date32_array_builder_append ()

gboolean
garrow_date32_array_builder_append (GArrowDate32ArrayBuilder *builder,
                                    gint32 value,
                                    GError **error);

Parameters

builder

A GArrowDate32ArrayBuilder.

 

value

The number of days since UNIX epoch in signed 32bit integer.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.7.0


garrow_date32_array_builder_append_values ()

gboolean
garrow_date32_array_builder_append_values
                               (GArrowDate32ArrayBuilder *builder,
                                const gint32 *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowDate32ArrayBuilder.

 

values

The array of the number of days since UNIX epoch in signed 32bit integer.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_date32_array_builder_append_null ()

gboolean
garrow_date32_array_builder_append_null
                               (GArrowDate32ArrayBuilder *builder,
                                GError **error);

Parameters

builder

A GArrowDate32ArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.7.0


garrow_date32_array_builder_append_nulls ()

gboolean
garrow_date32_array_builder_append_nulls
                               (GArrowDate32ArrayBuilder *builder,
                                gint64 n,
                                GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowDate32ArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_date64_array_builder_new ()

GArrowDate64ArrayBuilder *
garrow_date64_array_builder_new (void);

Returns

A newly created GArrowDate64ArrayBuilder.

Since: 0.7.0


garrow_date64_array_builder_append ()

gboolean
garrow_date64_array_builder_append (GArrowDate64ArrayBuilder *builder,
                                    gint64 value,
                                    GError **error);

Parameters

builder

A GArrowDate64ArrayBuilder.

 

value

The number of milliseconds since UNIX epoch in signed 64bit integer.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.7.0


garrow_date64_array_builder_append_values ()

gboolean
garrow_date64_array_builder_append_values
                               (GArrowDate64ArrayBuilder *builder,
                                const gint64 *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowDate64ArrayBuilder.

 

values

The array of the number of milliseconds since UNIX epoch in signed 64bit integer.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_date64_array_builder_append_null ()

gboolean
garrow_date64_array_builder_append_null
                               (GArrowDate64ArrayBuilder *builder,
                                GError **error);

Parameters

builder

A GArrowDate64ArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.7.0


garrow_date64_array_builder_append_nulls ()

gboolean
garrow_date64_array_builder_append_nulls
                               (GArrowDate64ArrayBuilder *builder,
                                gint64 n,
                                GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowDate64ArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_timestamp_array_builder_new ()

GArrowTimestampArrayBuilder *
garrow_timestamp_array_builder_new (GArrowTimestampDataType *data_type);

Parameters

data_type

A GArrowTimestampDataType.

 

Returns

A newly created GArrowTimestampArrayBuilder.

Since: 0.7.0


garrow_timestamp_array_builder_append ()

gboolean
garrow_timestamp_array_builder_append (GArrowTimestampArrayBuilder *builder,
                                       gint64 value,
                                       GError **error);

Parameters

builder

A GArrowTimestampArrayBuilder.

 

value

The number of milliseconds since UNIX epoch in signed 64bit integer.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.7.0


garrow_timestamp_array_builder_append_values ()

gboolean
garrow_timestamp_array_builder_append_values
                               (GArrowTimestampArrayBuilder *builder,
                                const gint64 *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowTimestampArrayBuilder.

 

values

The array of the number of milliseconds since UNIX epoch in signed 64bit integer.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_timestamp_array_builder_append_null ()

gboolean
garrow_timestamp_array_builder_append_null
                               (GArrowTimestampArrayBuilder *builder,
                                GError **error);

Parameters

builder

A GArrowTimestampArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.7.0


garrow_timestamp_array_builder_append_nulls ()

gboolean
garrow_timestamp_array_builder_append_nulls
                               (GArrowTimestampArrayBuilder *builder,
                                gint64 n,
                                GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowTimestampArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_time32_array_builder_new ()

GArrowTime32ArrayBuilder *
garrow_time32_array_builder_new (GArrowTime32DataType *data_type);

Parameters

data_type

A GArrowTime32DataType.

 

Returns

A newly created GArrowTime32ArrayBuilder.

Since: 0.7.0


garrow_time32_array_builder_append ()

gboolean
garrow_time32_array_builder_append (GArrowTime32ArrayBuilder *builder,
                                    gint32 value,
                                    GError **error);

Parameters

builder

A GArrowTime32ArrayBuilder.

 

value

The number of days since UNIX epoch in signed 32bit integer.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.7.0


garrow_time32_array_builder_append_values ()

gboolean
garrow_time32_array_builder_append_values
                               (GArrowTime32ArrayBuilder *builder,
                                const gint32 *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowTime32ArrayBuilder.

 

values

The array of the number of days since UNIX epoch in signed 32bit integer.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_time32_array_builder_append_null ()

gboolean
garrow_time32_array_builder_append_null
                               (GArrowTime32ArrayBuilder *builder,
                                GError **error);

Parameters

builder

A GArrowTime32ArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.7.0


garrow_time32_array_builder_append_nulls ()

gboolean
garrow_time32_array_builder_append_nulls
                               (GArrowTime32ArrayBuilder *builder,
                                gint64 n,
                                GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowTime32ArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_time64_array_builder_new ()

GArrowTime64ArrayBuilder *
garrow_time64_array_builder_new (GArrowTime64DataType *data_type);

Parameters

data_type

A GArrowTime64DataType.

 

Returns

A newly created GArrowTime64ArrayBuilder.

Since: 0.7.0


garrow_time64_array_builder_append ()

gboolean
garrow_time64_array_builder_append (GArrowTime64ArrayBuilder *builder,
                                    gint64 value,
                                    GError **error);

Parameters

builder

A GArrowTime64ArrayBuilder.

 

value

The number of milliseconds since UNIX epoch in signed 64bit integer.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.7.0


garrow_time64_array_builder_append_values ()

gboolean
garrow_time64_array_builder_append_values
                               (GArrowTime64ArrayBuilder *builder,
                                const gint64 *values,
                                gint64 values_length,
                                const gboolean *is_valids,
                                gint64 is_valids_length,
                                GError **error);

Append multiple values at once. It's more efficient than multiple append() and append_null() calls.

Parameters

builder

A GArrowTime64ArrayBuilder.

 

values

The array of the number of milliseconds since UNIX epoch in signed 64bit integer.

[array length=values_length]

values_length

The length of values.

 

is_valids

The array of boolean that shows whether the Nth value is valid or not. If the Nth is_valids is TRUE, the Nth values is valid value. Otherwise the Nth value is null value.

[nullable][array length=is_valids_length]

is_valids_length

The length of is_valids.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_time64_array_builder_append_null ()

gboolean
garrow_time64_array_builder_append_null
                               (GArrowTime64ArrayBuilder *builder,
                                GError **error);

Parameters

builder

A GArrowTime64ArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.7.0


garrow_time64_array_builder_append_nulls ()

gboolean
garrow_time64_array_builder_append_nulls
                               (GArrowTime64ArrayBuilder *builder,
                                gint64 n,
                                GError **error);

Append multiple nulls at once. It's more efficient than multiple append_null() calls.

Parameters

builder

A GArrowTime64ArrayBuilder.

 

n

The number of null values to be appended.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.8.0


garrow_list_array_builder_new ()

GArrowListArrayBuilder *
garrow_list_array_builder_new (GArrowListDataType *data_type,
                               GError **error);

Parameters

data_type

A GArrowListDataType for value.

 

error

Return location for a GError or NULL.

[nullable]

Returns

A newly created GArrowListArrayBuilder.


garrow_list_array_builder_append ()

gboolean
garrow_list_array_builder_append (GArrowListArrayBuilder *builder,
                                  GError **error);

Parameters

builder

A GArrowListArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

It appends a new list element. To append a new list element, you need to call this function then append list element values to value_builder. value_builder is the GArrowArrayBuilder specified to constructor. You can get value_builder by garrow_list_array_builder_get_value_builder().

GArrowInt8ArrayBuilder *value_builder;
GArrowListArrayBuilder *builder;
value_builder = garrow_int8_array_builder_new();
builder = garrow_list_array_builder_new(value_builder, NULL);
// Start 0th list element: [1, 0, -1]
garrow_list_array_builder_append(builder, NULL);
garrow_int8_array_builder_append(value_builder, 1);
garrow_int8_array_builder_append(value_builder, 0);
garrow_int8_array_builder_append(value_builder, -1);
// Start 1st list element: [-29, 29]
garrow_list_array_builder_append(builder, NULL);
garrow_int8_array_builder_append(value_builder, -29);
garrow_int8_array_builder_append(value_builder, 29);
{
// [[1, 0, -1], [-29, 29]]
GArrowArray *array = garrow_array_builder_finish(builder);
// Now, builder is needless.
g_object_unref(builder);
g_object_unref(value_builder);
// Use array...
g_object_unref(array);
}


garrow_list_array_builder_append_null ()

gboolean
garrow_list_array_builder_append_null (GArrowListArrayBuilder *builder,
                                       GError **error);

Parameters

builder

A GArrowListArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

It appends a new NULL element.


garrow_list_array_builder_get_value_builder ()

GArrowArrayBuilder *
garrow_list_array_builder_get_value_builder
                               (GArrowListArrayBuilder *builder);

Parameters

builder

A GArrowListArrayBuilder.

 

Returns

The GArrowArrayBuilder for values.

[transfer none]


garrow_struct_array_builder_new ()

GArrowStructArrayBuilder *
garrow_struct_array_builder_new (GArrowStructDataType *data_type,
                                 GError **error);

Parameters

data_type

GArrowStructDataType for the struct.

 

error

Return location for a GError or NULL.

[nullable]

Returns

A newly created GArrowStructArrayBuilder.


garrow_struct_array_builder_append ()

gboolean
garrow_struct_array_builder_append (GArrowStructArrayBuilder *builder,
                                    GError **error);

Parameters

builder

A GArrowStructArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

It appends a new struct element. To append a new struct element, you need to call this function then append struct element field values to all field_builders. field_values are the GArrowArrayBuilder specified to constructor. You can get field_builder by garrow_struct_array_builder_get_field_builder() or garrow_struct_array_builder_get_field_builders().

// TODO


garrow_struct_array_builder_append_null ()

gboolean
garrow_struct_array_builder_append_null
                               (GArrowStructArrayBuilder *builder,
                                GError **error);

Parameters

builder

A GArrowStructArrayBuilder.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

It appends a new NULL element.


garrow_struct_array_builder_get_field_builder ()

GArrowArrayBuilder *
garrow_struct_array_builder_get_field_builder
                               (GArrowStructArrayBuilder *builder,
                                gint i);

Parameters

builder

A GArrowStructArrayBuilder.

 

i

The index of the field in the struct.

 

Returns

The GArrowArrayBuilder for the i-th field.

[transfer none]


garrow_struct_array_builder_get_field_builders ()

GList *
garrow_struct_array_builder_get_field_builders
                               (GArrowStructArrayBuilder *builder);

Parameters

builder

A GArrowStructArrayBuilder.

 

Returns

The GArrowArrayBuilder for all fields.

[element-type GArrowArray][transfer none]


garrow_decimal128_array_builder_new ()

GArrowDecimal128ArrayBuilder *
garrow_decimal128_array_builder_new (GArrowDecimalDataType *data_type);

Parameters

data_type

GArrowDecimalDataType for the decimal.

 

Returns

A newly created GArrowDecimal128ArrayBuilder.

Since: 0.10.0


garrow_decimal128_array_builder_append ()

gboolean
garrow_decimal128_array_builder_append
                               (GArrowDecimal128ArrayBuilder *builder,
                                GArrowDecimal128 *value,
                                GError **error);

Parameters

builder

A GArrowDecimal128ArrayBuilder.

 

value

A decimal value.

 

error

Return location for a GError or NULL.

[nullable]

Returns

TRUE on success, FALSE if there was an error.

Since: 0.10.0

Types and Values

GARROW_TYPE_ARRAY_BUILDER

#define GARROW_TYPE_ARRAY_BUILDER (garrow_array_builder_get_type())

struct GArrowArrayBuilderClass

struct GArrowArrayBuilderClass {
  GObjectClass parent_class;
};

struct GArrowBooleanArrayBuilder

struct GArrowBooleanArrayBuilder;

It wraps arrow::BooleanBuilder.


struct GArrowIntArrayBuilder

struct GArrowIntArrayBuilder;

It wraps arrow::AdaptiveIntBuilder.


GARROW_TYPE_UINT_ARRAY_BUILDER

#define GARROW_TYPE_UINT_ARRAY_BUILDER (garrow_uint_array_builder_get_type())

struct GArrowUIntArrayBuilderClass

struct GArrowUIntArrayBuilderClass {
  GArrowArrayBuilderClass parent_class;
};

struct GArrowInt8ArrayBuilder

struct GArrowInt8ArrayBuilder;

It wraps arrow::Int8Builder.


struct GArrowUInt8ArrayBuilder

struct GArrowUInt8ArrayBuilder;

It wraps arrow::UInt8Builder.


struct GArrowInt16ArrayBuilder

struct GArrowInt16ArrayBuilder;

It wraps arrow::Int16Builder.


struct GArrowUInt16ArrayBuilder

struct GArrowUInt16ArrayBuilder;

It wraps arrow::UInt16Builder.


struct GArrowInt32ArrayBuilder

struct GArrowInt32ArrayBuilder;

It wraps arrow::Int32Builder.


struct GArrowUInt32ArrayBuilder

struct GArrowUInt32ArrayBuilder;

It wraps arrow::UInt32Builder.


struct GArrowInt64ArrayBuilder

struct GArrowInt64ArrayBuilder;

It wraps arrow::Int64Builder.


struct GArrowUInt64ArrayBuilder

struct GArrowUInt64ArrayBuilder;

It wraps arrow::UInt64Builder.


struct GArrowFloatArrayBuilder

struct GArrowFloatArrayBuilder;

It wraps arrow::FloatBuilder.


struct GArrowDoubleArrayBuilder

struct GArrowDoubleArrayBuilder;

It wraps arrow::DoubleBuilder.


struct GArrowBinaryArrayBuilder

struct GArrowBinaryArrayBuilder;

It wraps arrow::BinaryBuilder.


struct GArrowStringArrayBuilder

struct GArrowStringArrayBuilder;

It wraps arrow::StringBuilder.


struct GArrowDate32ArrayBuilder

struct GArrowDate32ArrayBuilder;

It wraps arrow::Date32Builder.


struct GArrowDate64ArrayBuilder

struct GArrowDate64ArrayBuilder;

It wraps arrow::Date64Builder.


struct GArrowTimestampArrayBuilder

struct GArrowTimestampArrayBuilder;

It wraps arrow::TimestampBuilder.


struct GArrowTime32ArrayBuilder

struct GArrowTime32ArrayBuilder;

It wraps arrow::Time32Builder.


struct GArrowTime64ArrayBuilder

struct GArrowTime64ArrayBuilder;

It wraps arrow::Time64Builder.


struct GArrowListArrayBuilder

struct GArrowListArrayBuilder;

It wraps arrow::ListBuilder.


struct GArrowStructArrayBuilder

struct GArrowStructArrayBuilder;

It wraps arrow::StructBuilder.


GARROW_TYPE_DECIMAL128_ARRAY_BUILDER

#define GARROW_TYPE_DECIMAL128_ARRAY_BUILDER (garrow_decimal128_array_builder_get_type())

struct GArrowDecimal128ArrayBuilderClass

struct GArrowDecimal128ArrayBuilderClass {
  GArrowArrayBuilderClass parent_class;
};

GArrowArrayBuilder

typedef struct _GArrowArrayBuilder GArrowArrayBuilder;

GArrowDecimal128ArrayBuilder

typedef struct _GArrowDecimal128ArrayBuilder GArrowDecimal128ArrayBuilder;

GArrowUIntArrayBuilder

typedef struct _GArrowUIntArrayBuilder GArrowUIntArrayBuilder;

Property Details

The “array-builder” property

  “array-builder”            gpointer

The raw arrow::ArrayBuilder *.

Flags: Write / Construct Only