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)