Method

ArrowStringArrayBuilderappend_strings

Declaration [src]

gboolean
garrow_string_array_builder_append_strings (
  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.16.0

Parameters

`values`	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`	`gint64`
	The length of `values`.
`is_valids`	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`	`gint64`
	The length of `is_valids`.
`error`	`GError **`
	The return location for a `GError*`, or `NULL`.

Return value

Returns:	`gboolean`
	`TRUE` on success, `FALSE` if there was an error.