numpy.ndarray.tobytes — NumPy v2.6.dev0 Manual

method

ndarray.tobytes(order='C')

#

Construct Python bytes containing the raw data bytes in the array.

Constructs Python bytes showing a copy of the raw contents of data memory. The bytes object is produced in C-order by default. This behavior is controlled by the order parameter.

Parameters:order{‘C’, ‘F’, ‘A’}, optionalControls the memory layout of the bytes object. ‘C’ means C-order, ‘F’ means F-order, ‘A’ (short for Any) means ‘F’ if a is Fortran contiguous, ‘C’ otherwise. Default is ‘C’.

Returns:sbytesPython bytes exhibiting a copy of a’s raw data.

See also

frombuffer

Inverse of this operation, construct a 1-dimensional array from Python bytes.

Examples

>>> importnumpyasnp>>> x=np.array([[0,1],[2,3]],dtype='<u2')>>> x.tobytes()b'\x00\x00\x01\x00\x02\x00\x03\x00'>>> x.tobytes('C')==x.tobytes()True>>> x.tobytes('F')b'\x00\x00\x02\x00\x01\x00\x03\x00'