在空闲地浏览名称空间时,我注意到一个名为Ellipsis的奇怪对象,它看起来没有什么特别之处,也没有做什么特别的事情,但它是一个全局可用的内置对象。

经过搜索,我发现Numpy和Scipy在切片语法的一些模糊变体中使用了它。。。但几乎没有其他。

该对象是否专门添加到语言中以支持Numpy+Scipy?Ellipsis有任何通用的含义或用途吗?

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

当前回答

正如@noɥʇʎԀʌzɐɹƆ和@phoenix所提到的,您确实可以在存根文件中使用它。例如

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

有关如何使用此省略号的更多信息和示例,请参见此处https://www.python.org/dev/peps/pep-0484/#stub-文件

其他回答

对于在Pydantic使用量很大的代码库中工作而得出这个答案的人来说:这也是Pydantic表示需要但可以设置为None的字段的方式,他们称之为“必需的可选字段”。这就是为什么它们最终也被用于FastAPI的原因。

与Python3.5和PEP484一样,在使用类型模块时,文本省略号用于向静态类型检查器表示某些类型。

示例1:

可以使用一种类型和省略号来表示任意长度的同构元组,例如Tuple[int,…]

示例2:

通过用文字省略号(三个点)替换参数列表,可以在不指定调用签名的情况下声明可调用的返回类型:

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

__getitem_最小。。。自定义类中的示例

当神奇的语法。。。在自定义类中传递给[],__getitem__()接收Ellipse类对象。

然后,类可以对这个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)

Python内置列表类选择为其提供范围的语义,当然,任何合理的用法都应该如此。

就我个人而言,我只是在API中远离它,而是创建一个单独的、更明确的方法。

在Python 3.5.2和2.7.12中测试。

从Python文档中:

此对象通常用于切片(请参见切片)。它不支持特别行动。只有一个省略号对象,名为椭圆(内置名称)。类型(椭圆)()生成椭圆单例。它被写成椭圆或。。。。

FastAPI使用椭圆来创建所需的参数。https://fastapi.tiangolo.com/tutorial/query-params-str-validations/