numpy.dtype.newbyteorder

方法

dtype.newbyteorder(new_order='S', /)

返回一个具有不同字节序的新 dtype。

更改也反映在数据类型的所有字段和子数组中。

参数：

new_order字符串，可选

要强制使用的字节序；来自以下字节序规范的值。默认值（'S'）会导致交换当前字节序。new_order 代码可以是以下任何一种

• 'S' - 将 dtype 从当前字节序交换到相反的字节序

• {‘<’, ‘little’} - 小端字节序

• {‘>’, ‘big’} - 大端字节序

• {‘=’, ‘native’} - 本机字节序

• {‘|’, ‘I’} - 忽略（不更改字节序）

返回值：

new_dtypedtype

具有对字节序的给定更改的新 dtype 对象。

注释

更改也反映在数据类型的所有字段和子数组中。

示例

>>> import sys
>>> sys_is_le = sys.byteorder == 'little'
>>> native_code = '<' if sys_is_le else '>'
>>> swapped_code = '>' if sys_is_le else '<'
>>> import numpy as np
>>> native_dt = np.dtype(native_code+'i2')
>>> swapped_dt = np.dtype(swapped_code+'i2')
>>> native_dt.newbyteorder('S') == swapped_dt
True
>>> native_dt.newbyteorder() == swapped_dt
True
>>> native_dt == swapped_dt.newbyteorder('S')
True
>>> native_dt == swapped_dt.newbyteorder('=')
True
>>> native_dt == swapped_dt.newbyteorder('N')
True
>>> native_dt == native_dt.newbyteorder('|')
True
>>> np.dtype('<i2') == native_dt.newbyteorder('<')
True
>>> np.dtype('<i2') == native_dt.newbyteorder('L')
True
>>> np.dtype('>i2') == native_dt.newbyteorder('>')
True
>>> np.dtype('>i2') == native_dt.newbyteorder('B')
True