Struct WriteBuf 

pub struct WriteBuf<'a> { /* private fields */ }

Cursor over a mutable byte slice with a tracked write position.

Example

use wire_codec::WriteBuf;

let mut storage = [0u8; 4];
let mut buf = WriteBuf::new(&mut storage);
buf.write_u16_be(0xDEAD).unwrap();
buf.write_u16_be(0xBEEF).unwrap();
assert_eq!(buf.position(), 4);
assert_eq!(&storage, &[0xDE, 0xAD, 0xBE, 0xEF]);

Implementations

impl<'a> WriteBuf<'a>

pub fn new(bytes: &'a mut [u8]) -> Self

Wrap bytes in a new cursor positioned at offset zero.

pub fn capacity(&self) -> usize

Total capacity of the backing slice.

pub fn position(&self) -> usize

Current write offset within the backing slice.

pub fn remaining(&self) -> usize

Number of bytes still available for writing.

pub fn written(&self) -> &[u8]

Borrow the prefix that has been written so far.

pub fn write_bytes(&mut self, src: &[u8]) -> Result<()>

Append src to the buffer and advance the cursor.

Errors

Returns Error::BufferFull if fewer than src.len() bytes remain.

pub fn write_u8(&mut self, value: u8) -> Result<()>

Write a single byte.

Errors

Returns Error::BufferFull if no capacity remains.

pub fn write_u16_be(&mut self, value: u16) -> Result<()>

Write a big-endian u16.

Errors

Returns Error::BufferFull if fewer than 2 bytes remain.

pub fn write_u16_le(&mut self, value: u16) -> Result<()>

Write a little-endian u16.

Errors

Returns Error::BufferFull if fewer than 2 bytes remain.

pub fn write_u32_be(&mut self, value: u32) -> Result<()>

Write a big-endian u32.

Errors

Returns Error::BufferFull if fewer than 4 bytes remain.

pub fn write_u32_le(&mut self, value: u32) -> Result<()>

Write a little-endian u32.

Errors

Returns Error::BufferFull if fewer than 4 bytes remain.

pub fn write_u64_be(&mut self, value: u64) -> Result<()>

Write a big-endian u64.

Errors

Returns Error::BufferFull if fewer than 8 bytes remain.

pub fn write_u64_le(&mut self, value: u64) -> Result<()>

Write a little-endian u64.

Errors

Returns Error::BufferFull if fewer than 8 bytes remain.

pub fn into_written(self) -> &'a mut [u8]

Consume the cursor and return the prefix that has been written.

Trait Implementations

impl<'a> Debug for WriteBuf<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.