numpy.astype#

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

複製陣列到指定的資料型別。

此函數是與 Array API 相容的 numpy.ndarray.astype 替代方案。

參數:
xndarray

要轉換的輸入 NumPy 陣列。array_likes 在此明確地不被支援。

dtypedtype

結果的資料型別。

copybool, optional

指定當指定的 dtype 符合輸入陣列 x 的資料型別時,是否複製陣列。如果為 True,則必須始終返回新分配的陣列。如果為 False 且指定的 dtype 符合輸入陣列的資料型別,則必須返回輸入陣列;否則,必須返回新分配的陣列。預設為 True

devicestr, optional

放置返回陣列的裝置。預設值:None。僅用於 Array-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