tuple.count()

Метод count() возвращает количество элементов кортежа, равных заданному значению. Сравнение производится через оператор ==. Это один из всего двух методов, доступных у кортежа (второй — index()), что отражает неизменяемость этого типа: всё, что можно — посчитать и найти.

Сигнатура

tuple.count(x)

Параметры

  • x — значение, количество вхождений которого нужно посчитать. Любого типа, сравнимого через ==.

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

Целое число (int) — количество вхождений x. Если вхождений нет, возвращается 0, исключение не выбрасывается.

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

Пример 1. Подсчёт чисел.

dice_rolls = (3, 6, 1, 6, 4, 6, 2)
print(dice_rolls.count(6))
print(dice_rolls.count(5))

3
0

Пример 2. Подсчёт строк в неизменяемой конфигурации.

pins = ("INPUT", "OUTPUT", "INPUT", "INPUT_PULLUP", "OUTPUT")
print("INPUT:", pins.count("INPUT"))
print("OUTPUT:", pins.count("OUTPUT"))

INPUT: 2
OUTPUT: 2

Пример 3. Подсчёт вложенных кортежей.

Сравнение работает и для составных элементов:

points = ((0, 0), (1, 2), (0, 0), (3, 4), (0, 0))
print(points.count((0, 0)))

3

Пример 4. Логические значения.

True и 1 равны через ==:

flags = (True, 1, False, 0, True)
print(flags.count(True))
print(flags.count(0))

3
2

Пример 5. Проверка постоянства данных.

Кортеж неизменяем — счётчик одинаков на протяжении всей жизни объекта:

record = ("ok", "fail", "ok", "ok", "fail", "ok")
total = len(record)
ok = record.count("ok")
print(f"Успешных: {ok}/{total} ({ok / total:.0%})")

Успешных: 4/6 (67%)

См. также

  • tuple.index() — поиск позиции элемента в кортеже

  • list.count() — аналогичный метод для списков

Примечание

Лицензия и источники

Техническое описание метода адаптировано из официальной документации Python (https://docs.python.org), доступной под Python Software Foundation License Version 2. Перевод на русский, примеры использования и пояснения — © AlashEd Wiki.