ARRAY_REMOVE

Назначение

Удаляет из массива все элементы, равные заданному значению, сохраняя относительный порядок оставшихся элементов.

Синтаксис

• ARRAY_REMOVE(arr, target)

Параметры

• arr: ARRAY<T>, поддерживает числа, типы boolean, string, datetime, IP, UUID и другие.
• 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, удаляются значения NULL из arr.

  • 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]