Crate ntex_bytes
source · [−]Expand description
Provides abstractions for working with bytes.
This is fork of bytes crate
The ntex-bytes crate provides an efficient byte buffer structure
(Bytes) and traits for working with buffer
implementations (Buf, BufMut).
Bytes
Bytes is an efficient container for storing and operating on contiguous
slices of memory. It is intended for use primarily in networking code, but
could have applications elsewhere as well.
Bytes values facilitate zero-copy network programming by allowing multiple
Bytes objects to point to the same underlying memory. This is managed by
using a reference count to track when the memory is no longer needed and can
be freed.
A Bytes handle can be created directly from an existing byte store (such as &[u8]
or Vec<u8>), but usually a BytesMut is used first and written to. For
example:
use ntex_bytes::{BytesMut, BufMut};
let mut buf = BytesMut::with_capacity(1024);
buf.put(&b"hello world"[..]);
buf.put_u16(1234);
let a = buf.split();
assert_eq!(a, b"hello world\x04\xD2"[..]);
buf.put(&b"goodbye world"[..]);
let b = buf.split();
assert_eq!(b, b"goodbye world"[..]);
assert_eq!(buf.capacity(), 1030);In the above example, only a single buffer of 1024 is allocated. The handles
a and b will share the underlying buffer and maintain indices tracking
the view into the buffer represented by the handle.
See the struct docs for more details.
Modules
Utilities for working with buffers.
Structs
An immutable UTF-8 encoded string with Bytes as a storage.
A reference counted contiguous slice of memory.
A unique reference to a contiguous slice of memory.
A unique reference to a contiguous slice of memory.