Return the array with the same data viewed with a different byte order.

Equivalent to:


Changes are also made in all fields and sub-arrays of the array data type.

Parameters :

new_order : string, optional

Byte order to force; a value from the byte order specifications above. new_order codes can be any of:

* 'S' - swap dtype from current to opposite endian
* {'<', 'L'} - little endian
* {'>', 'B'} - big endian
* {'=', 'N'} - native order
* {'|', 'I'} - ignore (no change to byte order)

The default value (‘S’) results in swapping the current byte order. The code does a case-insensitive check on the first letter of new_order for the alternatives above. For example, any of ‘B’ or ‘b’ or ‘biggish’ are valid to specify big-endian.

Returns :

new_arr : array

New array object with the dtype reflecting given change to the byte order.