Struct WriteBuffer 

pub struct WriteBuffer { /* private fields */ }

A buffer for writing TNS protocol data

Implementations

impl WriteBuffer

pub fn new() -> Self

Create a new WriteBuffer with default capacity

pub fn with_capacity(capacity: usize) -> Self

Create a new WriteBuffer with specified capacity

pub fn with_max_capacity(capacity: usize, max_capacity: usize) -> Self

Create a new WriteBuffer with a maximum capacity limit

pub fn len(&self) -> usize

Get the current length of data in the buffer

pub fn is_empty(&self) -> bool

Check if the buffer is empty

pub fn capacity(&self) -> usize

Get the capacity of the buffer

pub fn remaining_capacity(&self) -> usize

Get the remaining writable space

pub fn clear(&mut self)

Clear the buffer

pub fn reserve(&mut self, additional: usize)

Reserve additional capacity

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

Get the buffer contents as a byte slice

pub fn into_inner(self) -> BytesMut

Consume the buffer and return the underlying BytesMut

pub fn freeze(self) -> Bytes

Freeze the buffer into immutable Bytes

pub fn inner_mut(&mut self) -> &mut BytesMut

Get mutable access to the underlying BytesMut

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

Write a single byte

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

Write raw bytes

pub fn write_zeros(&mut self, n: usize) -> Result<()>

Write zeros

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

Write a 16-bit unsigned integer in big-endian format

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

Write a 16-bit unsigned integer in little-endian format

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

Write a 32-bit unsigned integer in big-endian format

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

Write a 64-bit unsigned integer in big-endian format

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

Write a TNS UB1 (unsigned byte)

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

Write a TNS UB2 (unsigned 2-byte, variable length encoded)

TNS UB2 uses a length-prefixed encoding where:

• 0: write 0x00
• 1-255: write 0x01 + 1 byte
• 256-65535: write 0x02 + 2 bytes (big-endian)

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

Write a TNS UB4 (unsigned 4-byte, variable length encoded)

TNS UB4 uses a variable-length encoding where:

• 0: write 0x00
• 1-255: write 0x01 + 1 byte
• 256-65535: write 0x02 + 2 bytes (big-endian)

• 65535: write 0x04 + 4 bytes (big-endian)

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

Write a TNS UB8 (unsigned 8-byte, variable length encoded)

TNS UB8 uses a variable-length encoding where:

• 0: write 0x00
• 1-255: write 0x01 + 1 byte
• 256-65535: write 0x02 + 2 bytes (big-endian)
• 65536-4294967295: write 0x04 + 4 bytes (big-endian)

• 4294967295: write 0x08 + 8 bytes (big-endian)

pub fn write_bytes_with_length(&mut self, bytes: Option<&[u8]>) -> Result<()>

Write a TNS length-prefixed byte sequence

If bytes is None, writes NULL_INDICATOR (255). For data > 252 bytes, uses chunked encoding:

• Write LONG_INDICATOR (254)
• For each chunk up to 32767 bytes: write ub4(chunk_len) + raw bytes
• Write ub4(0) to terminate

pub fn write_string_with_length(&mut self, s: Option<&str>) -> Result<()>

Write a TNS length-prefixed string (UTF-8)

pub fn write_oracle_int(&mut self, value: i64) -> Result<()>

Write an Oracle-encoded integer

Oracle encodes integers with a length prefix indicating the number of bytes. Negative numbers have the high bit set in the length byte.

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

Write an Oracle-encoded unsigned integer

pub fn truncate(&mut self, len: usize)

Set the current position (for patching previously written data)

Note: This truncates the buffer to the given position

pub fn patch_u16_be(&mut self, pos: usize, value: u16) -> Result<()>

Patch a u16 at a specific position (big-endian)

This allows writing a placeholder and then patching it later (e.g., for packet length fields)

pub fn patch_u32_be(&mut self, pos: usize, value: u32) -> Result<()>

Patch a u32 at a specific position (big-endian)

Trait Implementations

impl AsRef<[u8]> for WriteBuffer

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl Debug for WriteBuffer

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

Formats the value using the given formatter.

impl Default for WriteBuffer

fn default() -> Self

Returns the “default value” for a type.