dpnp.astype

dpnp.astype(x1, dtype, order='K', casting='unsafe', copy=True, device=None)[source]

Copy the array with data type casting.

Parameters:

  • x1 ({dpnp.ndarray, usm_ndarray}) -- Array data type casting.

  • dtype (dtype) -- Target data type.

  • order ({'C', 'F', 'A', 'K'}) -- Row-major (C-style) or column-major (Fortran-style) order. When order is A, it uses F if a is column-major and uses C otherwise. And when order is K, it keeps strides as closely as possible.

  • copy ({bool}, optional) -- If it is False and no cast happens, then this method returns the array itself. Otherwise, a copy is returned.

  • casting ({'no', 'equiv', 'safe', 'same_kind', 'unsafe'}, optional) --

    Controls what kind of data casting may occur. Defaults to unsafe for backwards compatibility.

    • 'no' means the data types should not be cast at all.

    • 'equiv' means only byte-order changes are allowed.

    • 'safe' means only casts which can preserve values are allowed.

    • 'same_kind' means only safe casts or casts within a kind, like float64 to float32, are allowed.

    • 'unsafe' means any data conversions may be done.

  • copy -- By default, astype always returns a newly allocated array. If this is set to False, and the dtype, order, and subok requirements are satisfied, the input array is returned instead of a copy.

  • device ({None, string, SyclDevice, SyclQueue}, optional) -- An array API concept of device where the output array is created. The device can be None (the default), an OneAPI filter selector string, an instance of dpctl.SyclDevice corresponding to a non-partitioned SYCL device, an instance of dpctl.SyclQueue, or a Device object returned by dpnp.dpnp_array.dpnp_array.device property. Default: None.

Returns:

arr_t -- Unless copy is False and the other conditions for returning the input array are satisfied, arr_t is a new array of the same shape as the input array, with dtype, order given by dtype, order.

Return type:

dpnp.ndarray