Apa yang dilakukan objek Ellipsis?

Sementara berselancar di namespace saya melihat sebuah objek aneh yang disebut Ellipsis, tampaknya tidak menjadi atau melakukan sesuatu yang istimewa, tapi itu adalah builtin yang tersedia secara global.

Setelah pencarian saya menemukan bahwa itu digunakan dalam beberapa varian sintak slicing oleh Numpy dan Scipy ... tetapi hampir tidak ada yang lain.

Apakah objek ini ditambahkan ke bahasa khusus untuk mendukung Numpy + Scipy? Apakah Ellipsis memiliki makna generik atau penggunaan sama sekali?

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

Ini muncul dalam pertanyaan lain baru-baru ini. Saya akan menguraikan jawaban saya dari sana:

Ellipsis adalah objek yang dapat muncul dalam irisan notasi. Sebagai contoh:

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

Penafsirannya murni untuk apa pun yang mengimplementasikan __getitem__fungsi dan melihat Ellipsisobjek di sana, tetapi penggunaan utamanya (dan yang dimaksudkan) adalah di perpustakaan pihak ketiga yang numpy , yang menambahkan tipe array multidimensi. Karena ada lebih dari satu dimensi, mengiris menjadi lebih kompleks dari sekadar indeks awal dan berhenti; itu berguna untuk dapat memotong dalam berbagai dimensi juga. Misalnya, diberikan array 4x4, area kiri atas akan ditentukan oleh slice [: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]])

Memperluas ini lebih lanjut, Ellipsis digunakan di sini untuk menunjukkan placeholder untuk sisa dimensi array yang tidak ditentukan. Anggap saja menunjukkan irisan penuh [:]untuk semua dimensi di celah itu ditempatkan, jadi untuk array 3d, a[...,0]sama dengan a[:,:,0]dan untuk 4d a[:,:,:,0], sama halnya, a[0,...,0]adalah a[0,:,:,0](dengan bagaimanapun banyak titik dua di tengah membuat angka penuh dimensi dalam array).

Menariknya, dalam python3, literal Ellipsis ( ...) dapat digunakan di luar sintaks slice, sehingga Anda dapat benar-benar menulis:

>>> ...
Ellipsis

Selain berbagai jenis numerik, tidak, saya tidak berpikir itu digunakan. Sejauh yang saya ketahui, itu ditambahkan murni untuk penggunaan numpy dan tidak memiliki dukungan inti selain menyediakan objek dan sintaks yang sesuai. Objek yang ada di sana tidak memerlukan ini, tetapi dukungan "..." literal memang diperlukan.

Dalam Python 3, Anda bisa menggunakan Ellipsis literal ...sebagai pengganti "nop" untuk kode:

def will_do_something():
    ...

Ini bukan sihir; ekspresi apa pun dapat digunakan sebagai ganti ..., misalnya:

def will_do_something():
    1

(Tidak dapat menggunakan kata "sanksi", tetapi saya dapat mengatakan bahwa penggunaan ini tidak langsung ditolak oleh Guido.)

Pada Python 3.5 dan PEP484 , elipsis literal digunakan untuk menunjukkan tipe tertentu ke pemeriksa tipe statis saat menggunakan modul mengetik .

Contoh 1:

Tupel homogen yang panjangnya sewenang-wenang dapat diekspresikan menggunakan satu jenis dan elipsis, misalnya Tuple[int, ...]

Contoh 2:

Dimungkinkan untuk menyatakan tipe kembalinya callable tanpa menentukan tanda tangan panggilan dengan mengganti ellipsis literal (tiga titik) untuk daftar argumen:

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

Anda juga dapat menggunakan Ellipsis ketika menentukan output dokumen yang diharapkan :

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

Dari dokumentasi Python :

Objek ini biasa digunakan dengan mengiris (lihat Irisan ). Ini tidak mendukung operasi khusus. Tepat ada satu objek elipsis, bernama Ellipsis (nama bawaan). type(Ellipsis)()menghasilkan Ellipsis singleton.

Itu ditulis sebagai Ellipsisatau ....

Meringkas apa yang dikatakan orang lain, pada Python 3, Ellipsis pada dasarnya adalah konstanta singleton lain yang serupa None, tetapi tanpa tujuan penggunaan khusus. Penggunaan yang ada meliputi:

• Dalam sintaks irisan untuk mewakili irisan penuh dalam dimensi yang tersisa
• Dalam tip, isyarat untuk mengindikasikan hanya sebagian dari tipe ( Callable[..., int]atauTuple[str, ...] )
• Dalam jenis file rintisan untuk menunjukkan ada nilai default tanpa menentukannya

Kemungkinan penggunaan dapat meliputi:

• Sebagai nilai default untuk tempat-tempat yang Nonemerupakan opsi yang valid
• Sebagai konten untuk fungsi yang belum Anda terapkan

__getitem__...contoh minimal di kelas khusus

Ketika sintaks sihir ...dilewatkan ke []dalam kelas khusus, __getitem__()menerima Ellipsisobjek kelas.

Kelas kemudian dapat melakukan apa pun yang diinginkan dengan objek Singleton ini.

Contoh:

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)

Python bawaan list memilih untuk memberikan semantik suatu range, dan setiap penggunaan warasnya tentu saja juga.

Secara pribadi, saya tinggal menjauhinya di API saya, dan membuat metode terpisah yang lebih eksplisit.

Diuji dalam Python 3.5.2 dan 2.7.12.

Anda dapat menggunakan Ellipsis sendiri, dalam situasi pemotongan kustom seperti yang dilakukan numpy, tetapi tidak ada gunanya di kelas builtin.

Saya tidak tahu apakah itu ditambahkan khusus untuk digunakan dalam numpy, tapi saya pasti belum melihatnya digunakan di tempat lain.

Lihat juga: Bagaimana Anda menggunakan sintaks slicing ellipsis di Python?

Seperti disebutkan oleh @ noɥʇʎԀʎzɐɹƆ dan @ phoenix - Anda memang dapat menggunakannya dalam file rintisan. misalnya

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

Informasi lebih lanjut dan contoh cara menggunakan elipsis ini dapat ditemukan di sini https://www.python.org/dev/peps/pep-0484/#stub-files

Penggunaan yang dimaksudkan seharusnya tidak hanya untuk modul pihak ke-3 ini. Itu tidak disebutkan dengan benar dalam dokumentasi Python (atau mungkin saya tidak bisa menemukannya) tetapi ellipsis ...sebenarnya digunakan dalam CPython di setidaknya satu tempat.

Ini digunakan untuk mewakili struktur data tak terbatas dalam Python. Saya menemukan notasi ini sambil bermain-main dengan daftar.

Lihat pertanyaan ini untuk info lebih lanjut.

Ini setara.

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

...adalah konstanta yang didefinisikan di dalam built-in constants.

Elipsis

Sama dengan ellipsis literal "...". Nilai khusus yang digunakan sebagian besar bersama dengan sintaks slicing yang diperluas untuk tipe data kontainer yang ditentukan pengguna.