Что делает объект с многоточием Python?

в Python 3 можно использовать литерал с многоточием ... в качестве заполнителя " nop " для кода:

def will_do_something():
    ...

это не магия; любое выражение может быть использовано вместо ..., например:

def will_do_something():
    1

(не могу использовать слово "санкции", но я могу сказать, что это использование было не откровенно отвергнут Гвидо.)

вы также можете использовать многоточие при указании ожидаемого doctest выход:

class MyClass(object):
    """Example of a doctest Ellipsis

    >>> thing = MyClass()
    >>> # Match <class '__main__.MyClass'> and <class '%(module).MyClass'>
    >>> type(thing)           # doctest:+ELLIPSIS
    <class '....MyClass'>
    """
    pass

начиная с Python 3.5 и PEP484, буквальный многоточие используется для обозначения определенных типов для статического типа проверки при использовании введя модуль.

Пример 1:

однородные кортежи произвольной длины могут быть выражены с помощью одного типа и Многоточия, например Tuple[int, ...]

Пример 2:

можно объявить возвращаемый тип вызываемого объекта без указания вызова подпись путем замены литерального многоточия (три точки) для списка аргументов:

def partial(func: Callable[..., str], *args) -> Callable[..., str]:
    # Body

С документация Python:

этот объект используется слайс обозначения (см. Ссылка На Python Руководство). Он не поддерживает никаких специальных оперативный. Есть ровно один объект многоточие, под названием Ellipsis (a встроенное имя).

вы можете использовать многоточие самостоятельно, в пользовательских ситуациях нарезки, таких как numpy, но он не используется ни в одном встроенном классе.

Я не знаю, был ли он добавлен специально для использования в numpy, но я, конечно, не видел его в другом месте.

Читайте также: как вы используете синтаксис многоточия нарезки в Python?

__getitem__ минимальный ... пример в пользовательском классе

... служит в качестве магического значения одноэлементного класса, которое передается в __getitem__ когда вы используете "волшебный вид"... синтаксис.

класс может делать с ним все, что захочет.

пример:

class C(object):
    def __getitem__(self, k):
        return k

# Single argument is passed directly.
assert C()[0] == 0

# Multiple indices generate a tuple.
assert C()[0, 1] == (0, 1)

# Slice notation generates a slice object.
assert C()[1:2:3] == slice(1, 2, 3)

# Ellipsis notation generates the Ellipsis class object.
# Ellipsis is a singleton, so we can compare with `is`.
assert C()[...] is Ellipsis

# Everything mixed up.
assert C()[1, 2:3:4, ..., 6] == (1, slice(2,3,4), Ellipsis, 6)

встроенный питон list класс выбирает, чтобы дать ему семантику диапазона, и любое разумное использование его должно тоже курс.

лично я бы просто держался подальше от него в своих API и вместо этого создал отдельный, более явный метод.

суммируя то, что другие сказали, начиная с Python 3, многоточие по существу является еще одной одноэлементной константой, подобной None, но без определенного целевого использования. Существующие виды использования включают в себя:

• в синтаксисе среза для представления полного среза в остальных измерениях
• в типе намекая указать только часть типа (Callable[..., int] или Tuple[str, ...])
• в типе заглушки файлов, чтобы указать, что есть значение по умолчанию без указания это

возможные применения могут включать:

• как значение по умолчанию для мест, где None является допустимым параметром
• как содержание для функции, которую вы еще не реализовали

его предполагаемое использование не должно быть только для этих сторонних модулей. Это не сказано в документации Python (или, может быть, я просто не мог найти), но многоточием ... фактически используется в CPython по крайней мере в одном месте.

используется для представления бесконечных структур данных в Python. Я наткнулся на эту нотацию, играя со списками.

посмотреть этот вопрос для получения дополнительной информации.

Как упоминалось @no .zɐɹɔ и @Phoenix - вы действительно можете использовать его в стаб-файлах. например,

class Foo: bar: Any = ... def __init__(self, name: str=...) -> None: ...

дополнительную информацию и примеры использования этого многоточия можно найти здесь https://www.python.org/dev/peps/pep-0484/#stub-files