str.index()

Метод index() возвращает индекс первого вхождения подстроки в строке. В отличие от find(), если подстрока не найдена, метод выбрасывает исключение ValueError.

Сигнатура

str.index(sub, start=0, end=len(str))

Параметры

  • sub — искомая подстрока.

  • start — необязательный индекс начала поиска (по умолчанию 0).

  • end — необязательный индекс конца поиска (по умолчанию — длина строки).

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

Целое число (int) — позиция первого символа найденной подстроки. Если подстрока не найдена — выбрасывается ValueError.

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

Пример 1. Поиск символа.

text = "Arduino UNO"
print(text.index("U"))

8

Пример 2. Поиск подстроки.

text = "ESP32 DevKit"
print(text.index("Dev"))

6

Пример 3. Подстрока не найдена.

try:
    "Arduino".index("ESP")
except ValueError as e:
    print("Не найдено:", e)

Не найдено: substring not found

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

text = "abcabc"
print(text.index("b", 2))

4

Пример 5. Извлечение значения из ключа.

config = "baud=9600"
pos = config.index("=")
print(config[pos + 1:])

9600

См. также

  • str.find() — то же, но без исключения (возвращает -1)

  • str.count() — подсчёт количества вхождений

  • str.startswith() — проверка начала строки

Примечание

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

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