COUNTEQUAL

Назначение

Подсчитывает количество элементов массива, равных заданному целевому значению.

Синтаксис

• COUNTEQUAL(arr, target)

Параметры

• arr: ARRAY<T>, поддерживаются числовые, логические, строковые типы элементов, типы даты и времени, а также IP.
• target: того же типа, что и элементы arr.

Возвращаемое значение

• Возвращает BIGINT — количество равных элементов.

Примечания по использованию

• В этой функции NULL равен NULL и учитывается при подсчёте.

Примеры

• Базовые примеры

  • COUNTEQUAL([1,2,3,2], 2) -> 2
  • COUNTEQUAL(['a','b','a'], 'a') -> 2
  • COUNTEQUAL([true,false,false], false) -> 2

• NULL считается равным целевому значению и учитывается при подсчёте

  • COUNTEQUAL([1,NULL,2,NULL], NULL) -> 2
  • COUNTEQUAL([1,NULL,1], 1) -> 2
  • COUNTEQUAL([1, 2], NULL) -> 0

• Если массив равен NULL, возвращается NULL

  • COUNTEQUAL(NULL, 1) -> NULL