xorbits.numpy.copyto#

xorbits.numpy.copyto(dst, src, casting='same_kind', where=True)[source]#

Copies values from one array to another, broadcasting as necessary.

Raises a TypeError if the casting rule is violated, and if where is provided, it selects which elements to copy.

New in version 1.7.0(numpy).

Parameters

  • dst (ndarray) – The array into which values are copied.

  • src (array_like) – The array from which values are copied.

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

    Controls what kind of data casting may occur when copying.

    • ’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.

  • where (array_like of bool, optional) – A boolean array which is broadcasted to match the dimensions of dst, and selects elements to copy from src to dst wherever it contains the value True.

Examples

>>> A = np.array([4, 5, 6])  
>>> B = [1, 2, 3]  
>>> np.copyto(A, B)  
>>> A  
array([1, 2, 3])

>>> A = np.array([[1, 2, 3], [4, 5, 6]])  
>>> B = [[4, 5, 6], [7, 8, 9]]  
>>> np.copyto(A, B)  
>>> A  
array([[4, 5, 6],
       [7, 8, 9]])

This docstring was copied from numpy.