Method

ArrowStringArrayBuilderappend_values

deprecated: 1.0.0 since: 0.10.0

Declaration [src]

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
)

Description [src]

Append multiple values at once. It’s more efficient than multiple append and append_null calls.

Available since: 0.10.0

Deprecated since: 1.0.0

Use garrow_string_array_builder_append_strings() instead.

This method is not directly available to language bindings.

Parameters

values

Type: An array of gchar*

The array of strings.

The length of the array is specified in the values_length argument.
The data is owned by the caller of the function.
Each element is a NUL terminated UTF-8 string.
values_length

Type: gint64

The length of values.

is_valids

Type: An array of gboolean

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.

The argument can be NULL.
The length of the array is specified in the is_valids_length argument.
The data is owned by the caller of the function.
is_valids_length

Type: gint64

The length of is_valids.

error

Type: GError **

The return location for a recoverable error.

The argument can be NULL.
If the return location is not NULL, then you must initialize it to a NULL GError*.
The argument will left initialized to NULL by the method if there are no errors.
In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.

Return value

Type: gboolean

TRUE on success, FALSE if there was an error.