numpy.astype#

numpy.astype(x, dtype, /, *, copy=True, device=None)[源代码]#

将数组复制到指定的数据类型.

此函数是与 numpy.ndarray.astype 兼容的数组 API 替代方案.

参数:
xndarray

输入要转换的 NumPy 数组.``array_likes`` 在这里明确不支持.

dtypedtype

结果的数据类型.

copybool, 可选

指定当指定的 dtype 与输入数组 x 的数据类型匹配时是否复制数组.如果 True,则必须始终返回新分配的数组.如果 False 并且指定的 dtype 与输入数组的数据类型匹配,则必须返回输入数组;否则,必须返回新分配的数组.默认为 True.

devicestr, 可选

返回数组放置的设备.默认:None.仅用于数组API互操作性,因此如果传递,必须为 "cpu".

在 2.1.0 版本加入.

返回:
outndarray

具有指定数据类型的数组.

参见

ndarray.astype

示例

>>> import numpy as np
>>> arr = np.array([1, 2, 3]); arr
array([1, 2, 3])
>>> np.astype(arr, np.float64)
array([1., 2., 3.])

非复制案例:

>>> arr = np.array([1, 2, 3])
>>> arr_noncpy = np.astype(arr, arr.dtype, copy=False)
>>> np.shares_memory(arr, arr_noncpy)
True
On this page