Что означает S.find(sub[, start[, end]])?

Я учусь использовать строку документации python.

>>> print(str.find.__doc__)
S.find(sub[, start[, end]]) -> int
...

Когда я печатаю строку документации str.find(), я не понимаю, что это значит.

Что означает S.find(sub[, start[, end]])?


person Radia    schedule 10.05.2020    source источник
comment
Что ты имеешь в виду? это сигнатура метода str.findmethod.   -  person Jan    schedule 10.05.2020
comment
@Jan Я хочу знать, что это означает [, в S.find(sub[, start[, end]])   -  person Radia    schedule 10.05.2020
comment
Рассматривали ли вы возможность поиска в настоящих документах? Необязательные аргументы start и end интерпретируются как в нотации фрагмента. Кстати, квадратные скобки обычно означают, что что-то необязательно.   -  person Tomerikoo    schedule 10.05.2020
comment
Сигнатура метода (и его полная строка документации) показана и объяснена здесь, например: https://docs.python.org/3/library/stdtypes.html#str.find   -  person Jan    schedule 10.05.2020
comment
@Tomerikoo извините, мои извинения. Я должен был проверить документы. но спасибо за ваш комментарий   -  person Radia    schedule 10.05.2020


Ответы (1)


Это означает, что метод find в String займет 3 параметры, из которых 2 являются необязательными.

Пример:

 a = "Hello World"
 a.find("World")        # returns 6
 a.find("World", 4)     # returns 6
 a.find("World", 4, 6)  # returns -1 meaning it cannot be found

Вернемся к вашему выводу:

S.find(sub[, start[, end]]) -> int
  • S здесь относится к строковой переменной, которая в моем случае была a.

  • -> int означает, что функция выводит целое число, которое по умолчанию является позицией найденного слова или -1, если оно не найдено, что в моем случае было 6 и -1.

  • sub относится к слову, которое вы ищете, которое в моем случае было "World".

  • start и end относятся к начальному и конечному индексам, где можно найти строку, которая в моем случае была 4 и 6 соответственно.

person Jackson    schedule 10.05.2020
comment
[, start[, end]] относится к необязательным параметрам! Я получаю это сейчас. Спасибо большое! - person Radia; 10.05.2020