Do czego służy obiekt Elipsa?

W Pythonie 3 możesz 1 używać litery Elipsa ... jako symbolu zastępczego" nop " dla kodu, który nie został jeszcze napisany:

def will_do_something():
    ...

To jest a nie magia; zamiast ... można użyć dowolnego wyrażenia, np.:

def will_do_something():
    1

(nie mogę użyć słowa "usankcjonowany" , ale mogę powiedzieć, że to użycie było nie odrzucony przez Guido.)

¹ 'can' not in {'must', 'should'}

W Pythonie 3.5 I PEP484 , literalna elipsa jest używana do oznaczania pewnych typów do statycznego kontrolera typów podczas używania modułu typing .

Przykład 1:

Krotki jednorodne o dowolnej długości można wyrazić za pomocą jednego typu i elipsy, na przykład Tuple[int, ...]

Przykład 2:

Możliwe jest zadeklarowanie typu zwracanego wywołania bez podawania sygnatury wywołania przez podstawienie literalnej elipsy (trzy kropki) dla listy argumentów:

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

Można również użyć wielokropka przy określaniu oczekiwanego wyjścia 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

Podsumowując to, co powiedzieli inni, począwszy od Pythona 3, Ellipsis jest zasadniczo kolejną stałą Singletona podobną do None, ale bez określonego zamierzonego zastosowania. Istniejące zastosowania obejmują:

• w składni slice do reprezentowania całego slice w pozostałych wymiarach
• in type hinting to indicate only part of a type (Callable[..., int] or Tuple[str, ...])
• w plikach wejściowych typu, aby wskazać domyślną wartość bez podawania jej

Możliwe zastosowania mogą include:

• jako domyślna wartość dla miejsc, w których None jest prawidłową opcją
• jako zawartość funkcji, której jeszcze nie zaimplementowałeś

Z dokumentacji Pythona :

Ten obiekt jest powszechnie używany przez krojenie (zobacz plastry). Obsługuje nie operacje specjalne. Istnieje dokładnie jeden obiekt elipsy, nazwany Elipsa (nazwa wbudowana). type(Ellipsis)() tworzy elipsę singleton.

Zapisywany jest jako Ellipsis lub ....

__getitem__ minimal ... przykład w klasie niestandardowej

Kiedy magiczna składnia ... zostanie przekazana do [] w niestandardowej klasie, __getitem__() otrzymuje obiekt klasy Ellipsis.

Klasa może wtedy robić co chce z tym pojedynczym obiektem.

Przykład:

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)

Klasa wbudowana w Pythona list decyduje się nadać jej semantyczny zakres, a każde rozsądne użycie tego zakresu również powinno być oczywiście.

Osobiście trzymałbym się od tego z daleka w moich API i tworzyłbym osobna, bardziej jednoznaczna metoda.

Testowane w Pythonie 3.5.2 i 2.7.12.

Możesz użyć elipsy samodzielnie, w niestandardowych sytuacjach krojenia, takich jak numpy, ale nie ma zastosowania w żadnej wbudowanej klasie.

Nie wiem, czy został dodany specjalnie do użytku w numpy, ale na pewno nie widziałem go używanego gdzie indziej.

Zobacz także: Jak używać składni krojenia elipsy w Pythonie?

Jak wspomniano przez @ nozz and I @ Phoenix-rzeczywiście można go używać w plikach początkowych. np.

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

Więcej informacji i przykłady użycia tej elipsy można znaleźć tutaj https://www.python.org/dev/peps/pep-0484/#stub-files

To jest równoważne.

l=[..., 1,2,3]
l=[Ellipsis, 1,2,3]

... jest stałą określoną wewnątrz built-in constants.

Elipsa

Tak samo jak literał elipsy"...". Specjalna wartość używana głównie w połączeniu z rozszerzoną składnią krojenia dla zdefiniowanych przez użytkownika typów danych kontenerów.

Jego przeznaczenie nie powinno być tylko dla tych modułów zewnętrznych. Nie jest to poprawnie wymienione w dokumentacji Pythona (a może po prostu nie mogłem tego znaleźć), ale ellipsis ... jest faktycznie używany w CPython w co najmniej jednym miejscu.

Jest używany do reprezentowania nieskończonych struktur danych w Pythonie. Natknąłem się na tę notację podczas zabawy z listami.

Zobacz to pytanie aby uzyskać więcej informacji.

W typer ... jest używany do tworzenia wymaganych parametrów: klasa Argument oczekuje wartości domyślnej, a jeśli przekażesz ... będzie narzekać, jeśli użytkownik nie przekaże określonego argumentu.

Mógłbyś użyć None do tego samego, gdyby Ellipsis nie było, ale to pozbawiłoby możliwość wyrażenia, że None jest wartością domyślną, na wypadek gdyby miało to jakikolwiek sens w twoim programie.

FastAPI używa elipsy do tworzenia wymaganych parametrów. https://fastapi.tiangolo.com/tutorial/query-params-str-validations/