np.frombuffer()
frombuffer builds an array straight from raw bytes in memory, without copying.
In this page:
Syntax
arr = np.frombuffer(buffer, dtype=dtype)np.frombuffer()
np.frombuffer interprets a bytes-like object as a 1-D array of the dtype you name. It shares memory with the source buffer, so it is fast. The buffer must be large enough for whole elements. Results from immutable bytes are read-only.
Note:
Make a writable copy with .copy() if you need to modify the data.
Example: np.frombuffer()
import numpy as np
raw = b"\x01\x02\x03\x04"
a = np.frombuffer(raw, dtype=np.uint8)
print(a)
print(a.flags.writeable)
b = np.arange(3, dtype=np.int16).tobytes()
print(b)
print(np.frombuffer(b, dtype=np.int16))
# Output:
# [1 2 3 4]
# False
# b'\x00\x00\x01\x00\x02\x00'
# [0 1 2]Related Topics
Common Mistakes
- Forgetting to specify dtype
- Passing a buffer whose length is not a multiple of itemsize
- Trying to modify a read-only array
Chapter Summary
- frombuffer wraps raw bytes
- It does not copy data
- dtype defines the interpretation
- Bytes input gives read-only arrays
🔒
Chapter Quiz — Complete all 5 topics to unlock
0/5 topics done
Complete these topics first: