| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475 |
- ''' Byteorder utilities for system - numpy byteorder encoding
- Converts a variety of string codes for little endian, big endian,
- native byte order and swapped byte order to explicit NumPy endian
- codes - one of '<' (little endian) or '>' (big endian)
- '''
- import sys
- __all__ = [
- 'aliases', 'native_code', 'swapped_code',
- 'sys_is_le', 'to_numpy_code'
- ]
- sys_is_le = sys.byteorder == 'little'
- native_code = sys_is_le and '<' or '>'
- swapped_code = sys_is_le and '>' or '<'
- aliases = {'little': ('little', '<', 'l', 'le'),
- 'big': ('big', '>', 'b', 'be'),
- 'native': ('native', '='),
- 'swapped': ('swapped', 'S')}
- def to_numpy_code(code):
- """
- Convert various order codings to NumPy format.
- Parameters
- ----------
- code : str
- The code to convert. It is converted to lower case before parsing.
- Legal values are:
- 'little', 'big', 'l', 'b', 'le', 'be', '<', '>', 'native', '=',
- 'swapped', 's'.
- Returns
- -------
- out_code : {'<', '>'}
- Here '<' is the numpy dtype code for little endian,
- and '>' is the code for big endian.
- Examples
- --------
- >>> import sys
- >>> from scipy.io.matlab._byteordercodes import to_numpy_code
- >>> sys_is_le = (sys.byteorder == 'little')
- >>> sys_is_le
- True
- >>> to_numpy_code('big')
- '>'
- >>> to_numpy_code('little')
- '<'
- >>> nc = to_numpy_code('native')
- >>> nc == '<' if sys_is_le else nc == '>'
- True
- >>> sc = to_numpy_code('swapped')
- >>> sc == '>' if sys_is_le else sc == '<'
- True
- """
- code = code.lower()
- if code is None:
- return native_code
- if code in aliases['little']:
- return '<'
- elif code in aliases['big']:
- return '>'
- elif code in aliases['native']:
- return native_code
- elif code in aliases['swapped']:
- return swapped_code
- else:
- raise ValueError(
- f'We cannot handle byte order {code}')
|
