ARRAY_REMOVE

機能

配列から指定された値と等しいすべての要素を削除し、残りの要素の相対的な順序を保持します。

構文

• ARRAY_REMOVE(arr, target)

パラメータ

• arr: ARRAY<T>、数値、boolean、string、datetime、IPなどをサポート
• target: 配列要素と同じ型の値で、削除する要素のマッチングに使用

戻り値

• 入力と同じ型のARRAY<T>を返します。
• arrがNULLの場合、NULLを返します。

使用上の注意

• マッチングルール: 値がtargetと等しい要素のみが削除されます。NULLはNULLと等しくなります。

例

• 基本: 削除後、残りの要素は元の相対的な順序を保持します。

  • ARRAY_REMOVE([1,2,3], 1) -> [2,3]
  • ARRAY_REMOVE([1,2,3,null], 1) -> [2,3,null]

• targetがNULLの場合、arr内のNULLを削除します。

  • ARRAY_REMOVE(['a','b','c',NULL], NULL) -> NULL

• arrがNULLの場合、NULLを返します

  • ARRAY_REMOVE(NULL, 2) -> NULL

• マッチしない場合

  • ARRAY_REMOVE([1,2,3], 258) -> [1,2,3]