pandas.Index.view#

Index.view(cls=None)[源代码][源代码]#

返回具有指定 dtype 的 Index 视图或新的 Index 实例。

如果没有提供参数,此方法返回调用 Index 对象的视图。如果通过 cls 参数指定了 dtype,它会尝试返回具有指定 dtype 的 Index 视图。请注意,将 Index 视为不同的 dtype 会重新解释基础数据,这可能会导致非数字或不兼容 dtype 转换的意外结果。

参数:
cls数据类型或 ndarray 子类,可选

返回视图的数据类型描述符,例如 float32 或 int16。省略它会导致视图具有与 self 相同的数据类型。此参数也可以指定为 ndarray 子类,例如 np.int64 或 np.float32,这指定了返回对象的类型。

返回:
索引或ndarray

索引视图。如果 cls 为 None,返回的对象是与调用对象具有相同 dtype 的索引视图。如果指定了数值 cls,则返回具有新 dtype 的 ndarray 视图。

引发:
ValueError

如果尝试以与原始 dtype 的内存布局不兼容的方式更改 dtype,例如,将 ‘int64’ Index 视为 ‘str’。

参见

Index.copy

返回 Index 的副本。

numpy.ndarray.view

返回数组的新视图,数据相同。

例子

>>> idx = pd.Index([-1, 0, 1])
>>> idx.view()
Index([-1, 0, 1], dtype='int64')
>>> idx.view(np.uint64)
array([18446744073709551615,                    0,                    1],
  dtype=uint64)

以 ‘int32’ 或 ‘float32’ 查看会重新解释内存,这可能会导致意外行为:

>>> idx.view("float32")
array([   nan,    nan, 0.e+00, 0.e+00, 1.e-45, 0.e+00], dtype=float32)