tuple.index()

Метод index() возвращает индекс первого вхождения указанного значения в кортеже. Если значение не найдено, выбрасывается ValueError. Через необязательные start и stop можно ограничить область поиска. Это один из двух методов кортежа (вместе с count()).

Сигнатура

tuple.index(x, start=0, stop=sys.maxsize)

Параметры

x — искомое значение. Сравнение через ==.
start — индекс начала поиска (включительно). По умолчанию 0.
stop — индекс конца поиска (не включительно). По умолчанию — до конца кортежа.

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

Целое число (int) — индекс первого вхождения. Если не найдено — ValueError.

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

Пример 1. Поиск элемента.

days = ("пн", "вт", "ср", "чт", "пт", "сб", "вс")
print(days.index("ср"))

Пример 2. Обработка ValueError.

colors = ("red", "green", "blue")
try:
    print(colors.index("yellow"))
except ValueError as e:
    print("Не найдено:", e)

Не найдено: tuple.index(x): x not in tuple

Пример 3. Поиск следующего вхождения.

data = (1, 2, 3, 2, 1, 2)
first = data.index(2)
second = data.index(2, first + 1)
print(first, second)

1 3

Пример 4. Ограничение диапазона.

values = (10, 20, 30, 40, 50)
print(values.index(30, 0, 4))
try:
    values.index(50, 0, 4)
except ValueError:
    print("В диапазоне [0,4) элемента 50 нет")

2
В диапазоне [0,4) элемента 50 нет

Пример 5. Поиск составного значения.

coords = ((0, 0), (1, 2), (3, 4), (1, 2))
print(coords.index((1, 2)))

См. также

tuple.count() — подсчёт количества вхождений в кортеже
list.index() — аналогичный метод для списков

Примечание

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

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