方法

ArrowListArrayBuilder附加

已棄用：0.12.0

宣告 [src]

gboolean
garrow_list_array_builder_append (
  GArrowListArrayBuilder* builder
  GError** error
)

描述

無可用描述。

自 0.12.0 起已棄用

請改用 garrow_list_array_builder_append_value()。

回傳值

類型： gboolean

TRUE 成功時，FALSE 如果發生錯誤。

它會附加新的列表元素。若要附加新的列表元素，您需要呼叫此函式，然後將列表元素值附加到 value_builder。value_builder 是在建構子中指定的 GArrowArrayBuilder。您可以透過 garrow_list_array_builder_get_value_builder() 取得 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);
}