Що робить об’єкт Еліпсиса?

Під час неробного серфінгу в просторі імен я помітив дивний вигляд об'єкта, який називається Ellipsis, він, схоже, не робить чи нічого особливого, але це всесвітньо доступний вбудований модуль.

Після пошуку я виявив, що він використовується в якомусь незрозумілому варіанті синтаксису нарізки Numpy та Scipy ... але майже нічого іншого.

Чи додали цей об'єкт до мови спеціально для підтримки Numpy + Scipy? Чи має Еліпсіс якесь загальне значення або взагалі використовує?

D:\workspace\numpy>python
Python 2.4.4 (#71, Oct 18 2006, 08:34:43) [MSC v.1310 32 bit (Intel)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> Ellipsis
Ellipsis

Це з’явилося в іншому питанні нещодавно. Я докладу детальну відповідь :

Еліпсис - це об'єкт, який може відображатися у позначенні фрагментів. Наприклад:

myList[1:2, ..., 0]

Її інтерпретація суто залежить від того, що реалізує __getitem__функцію та бачить Ellipsisтам об’єкти, але її основне (і призначене) використання полягає в нумерованій сторонній бібліотеці, яка додає багатовимірний тип масиву. Оскільки існує більше одного виміру, нарізка стає складнішою, ніж просто індекс старту та зупинки; корисно також мати можливість нарізати в декількох вимірах. Напр., Маючи масив 4x4, верхній лівий ділянку визначатиметься зрізом [:2,:2]:

>>> a
array([[ 1,  2,  3,  4],
       [ 5,  6,  7,  8],
       [ 9, 10, 11, 12],
       [13, 14, 15, 16]])

>>> a[:2,:2]  # top left
array([[1, 2],
       [5, 6]])

Подовжуючи це далі, Ellipsis використовується тут для позначення заповнення для решти розмірів масиву, не вказаних. Подумайте про це як про те, що вказує повний зріз [:]для всіх розмірів у проміжку, на який він розміщений, тому для 3d-масиву a[...,0]такий самий, як a[:,:,0]і для 4d a[:,:,:,0], аналогічно, так a[0,...,0]як a[0,:,:,0](хоча багато колонок посередині складають повне число розмірів у масиві).

Цікаво, що в python3 буквар Ellipsis ( ...) може бути використаний поза синтаксисом зрізу, тому ви можете фактично писати:

>>> ...
Ellipsis

Крім різних числових типів, ні, я не думаю, що він використовується. Наскільки мені відомо, він доданий виключно для нумерового використання і не має основної підтримки, крім надання об’єкта та відповідного синтаксису. Об'єкт, що перебуває там, цього не потребував, але буквальна підтримка фрагментів "..." зробила.

У Python 3 ви можете використовувати літерал Ellipsis ...як заповнювач "nop" для коду:

def will_do_something():
    ...

Це не магія; будь-який вираз може бути використаний замість ..., наприклад:

def will_do_something():
    1

(Не можу вживати слово "санкціонований", але можу сказати, що це використання не було відверто відверто Гвідо.)

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

Приклад 1:

Однорідні кортежі довільної довжини можна виразити, використовуючи, наприклад, один тип та еліпсис Tuple[int, ...]

Приклад 2:

Можна оголосити тип повернення дзвінка без вказівки підпису виклику, замінивши буквальний еліпсис (три крапки) для списку аргументів:

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

Ви також можете використовувати програму Ellipsis, визначаючи очікуваний вихідний документ:

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 :

Цей об'єкт зазвичай використовується для нарізки (див. Нарізки ). Він не підтримує спеціальних операцій. Існує рівно один об’єкт еліпсису під назвою Ellipsis (вбудована назва). type(Ellipsis)()виробляє одинарний еліпсис.

Він пишеться як Ellipsisабо ....

Підсумовуючи сказане іншими, що стосується Python 3, Ellipsis є по суті ще однією однотонною постійною, подібною None, але без конкретного призначення. До існуючих цілей використання належать:

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

Можливі варіанти використання можуть включати:

• Як значення за замовчуванням для місць, де Noneє дійсним параметром
• В якості вмісту функції ви ще не реалізували

__getitem__мінімальний ...приклад у спеціальному класі

Коли магічний синтаксис ...переходить []у спеціальний клас, __getitem__()отримує об’єкт Ellipsisкласу.

Потім клас може робити все, що завгодно, з цим об'єктом Singleton.

Приклад:

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клас Python вирішує надати йому семантичний діапазон, і звичайно, будь-яке розумне використання його також повинно.

Особисто я просто тримаюсь подалі від цього у своїх API, а натомість створюю окремий, більш чіткий метод.

Випробувано в Python 3.5.2 та 2.7.12.

Ви можете використовувати Ellipsis самостійно в таких ситуаціях, як нумез, але це не використовується в будь-якому вбудованому класі.

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

Дивіться також: Як ви використовуєте синтаксис нарізки еліпсису в Python?

Як згадували @ noɥʇʎԀʎzɐɹƆ та @phoenix - Ви дійсно можете використовувати його у файлах stub. напр

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

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

Її використання не повинно бути тільки для цих сторонніх модулів. Це не згадується належним чином в документації на Python (або, можливо, я просто не міг цього знайти), але еліпсис ...насправді використовується в CPython принаймні в одному місці.

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

Дивіться це питання для отримання додаткової інформації.

Це рівнозначно.

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

...- це константа, визначена всередині built-in constants.

Еліпсис

Те саме, що буквально "...". Особливе значення використовується в основному в поєднанні з розширеним синтаксисом нарізки для визначених користувачем типів контейнерів.