Struct StringTableBuilder 

pub struct StringTableBuilder { /* private fields */ }

String table builder for constructing string tables during serialization

This builder accumulates strings and tracks their offsets/lengths. Strings are automatically null-terminated and concatenated with no padding.

Examples

use aion_context::string_table::StringTableBuilder;

let mut builder = StringTableBuilder::new();

let (offset, length) = builder.add("Hello, world!");
assert_eq!(offset, 0);
assert_eq!(length, 13);

let bytes = builder.build();
assert_eq!(bytes, b"Hello, world!\0");

Implementations

impl StringTableBuilder

pub fn new() -> Self

Create a new empty string table builder

Examples

use aion_context::string_table::StringTableBuilder;

let builder = StringTableBuilder::new();
assert_eq!(builder.len(), 0);
assert!(builder.is_empty());

pub fn with_capacity(capacity: usize) -> Self

Create a builder with pre-allocated capacity

Examples

use aion_context::string_table::StringTableBuilder;

let builder = StringTableBuilder::with_capacity(1024);
assert_eq!(builder.len(), 0);

pub fn add(&mut self, s: &str) -> (u64, u32)

Add a string to the table

Returns (offset, length) where:

• offset is the byte offset of the string’s first character
• length is the string length in bytes (excluding null terminator)

The string is automatically null-terminated and appended to the table.

Examples

use aion_context::string_table::StringTableBuilder;

let mut builder = StringTableBuilder::new();

let (offset1, len1) = builder.add("First");
assert_eq!(offset1, 0);
assert_eq!(len1, 5);

let (offset2, len2) = builder.add("Second");
assert_eq!(offset2, 6); // "First\0" = 6 bytes
assert_eq!(len2, 6);

pub fn len(&self) -> usize

Get the current total size in bytes

This includes all strings and their null terminators.

Examples

use aion_context::string_table::StringTableBuilder;

let mut builder = StringTableBuilder::new();
assert_eq!(builder.len(), 0);

builder.add("Hello");
assert_eq!(builder.len(), 6); // "Hello\0"

builder.add("World");
assert_eq!(builder.len(), 12); // "Hello\0World\0"

pub fn is_empty(&self) -> bool

Check if the table is empty

Examples

use aion_context::string_table::StringTableBuilder;

let mut builder = StringTableBuilder::new();
assert!(builder.is_empty());

builder.add("Test");
assert!(!builder.is_empty());

pub fn build(self) -> Vec<u8>

Build the final string table as a byte vector

Returns the complete string table with all null terminators.

Examples

use aion_context::string_table::StringTableBuilder;

let mut builder = StringTableBuilder::new();
builder.add("Alpha");
builder.add("Beta");

let bytes = builder.build();
assert_eq!(bytes, b"Alpha\0Beta\0");

pub fn clear(&mut self)

Clear all strings from the builder

Examples

use aion_context::string_table::StringTableBuilder;

let mut builder = StringTableBuilder::new();
builder.add("Test");
assert!(!builder.is_empty());

builder.clear();
assert!(builder.is_empty());

Trait Implementations

impl Clone for StringTableBuilder

fn clone(&self) -> StringTableBuilder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StringTableBuilder

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

Formats the value using the given formatter.

impl Default for StringTableBuilder

fn default() -> StringTableBuilder

Returns the “default value” for a type.