ARRAY_REPEAT

関数

ARRAY_REPEATは、すべての要素が指定された値を持つ、指定された長さの配列を生成するために使用されます。

構文

ARRAY_REPEAT(element, count)

パラメータ

• element: ARRAYでサポートされている任意のストレージタイプ。

• count: Integer型、返される配列の長さを指定します。

戻り値

• ARRAY<T>型の配列を返します。ここでTはelementの型です。
  • 配列には同じelementのcount個のコピーが含まれます。

使用上の注意

• count = 0またはNULLの場合、空の配列を返します。
• elementがNULLの場合、配列内のすべての要素がNULLになります。
• この関数はARRAY_WITH_CONSTANTと同じ機能を持ちますが、パラメータの順序が逆になっています。

例

1. 簡単な例

   SELECT ARRAY_REPEAT('hello', 3);
   +---------------------------------+
   | ARRAY_REPEAT('hello', 3) |
   +---------------------------------+
   | ["hello", "hello", "hello"]     |
   +---------------------------------+

2. 特殊なケース

   SELECT ARRAY_REPEAT('hello', 0);
   +---------------------------------+
   | ARRAY_REPEAT('hello', 0) |
   +---------------------------------+
   | []                              |
   +---------------------------------+
   
   SELECT ARRAY_REPEAT('hello', NULL);
   +------------------------------------+
   | ARRAY_REPEAT('hello', NULL) |
   +------------------------------------+
   | []                                 |
   +------------------------------------+
   
   SELECT ARRAY_REPEAT(NULL, 2);
   +------------------------------+
   | ARRAY_REPEAT(NULL, 2) |
   +------------------------------+
   | [null, null]                 |
   +------------------------------+
   
   SELECT ARRAY_REPEAT(NULL, NULL);
   +---------------------------------+
   | ARRAY_REPEAT(NULL, NULL) |
   +---------------------------------+
   | []                              |
   +---------------------------------+
   
   -- Returns error: INVALID_ARGUMENT
   SELECT ARRAY_REPEAT('hello', -1);