Struct StringTable 

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

String table for zero-copy parsing of string data

This struct wraps a byte slice containing null-terminated UTF-8 strings. Strings can be extracted by offset and length without copying.

Examples

use aion_context::string_table::StringTable;

let data = b"Genesis\0Version 2\0";
let table = StringTable::new(data).unwrap();

let s1 = table.get(0, 7).unwrap();
assert_eq!(s1, "Genesis");

let s2 = table.get(8, 9).unwrap();
assert_eq!(s2, "Version 2");

Implementations

impl<'a> StringTable<'a>

pub fn new(data: &'a [u8]) -> Result<Self>

Create a new string table from byte data

Errors

Returns an error if:

• The data contains invalid UTF-8 sequences
• The data is not properly null-terminated

Examples

use aion_context::string_table::StringTable;

let data = b"Hello\0World\0";
let table = StringTable::new(data).unwrap();

pub fn get(&self, offset: u64, length: u32) -> Result<&'a str>

Get a string by offset and length

Arguments

• offset - Byte offset to the first character of the string
• length - Length of the string in bytes (excluding null terminator)

Errors

Returns an error if:

• Offset + length exceeds table bounds
• The extracted bytes are not valid UTF-8
• The string is not properly null-terminated

Examples

use aion_context::string_table::StringTable;

let data = b"First\0Second\0Third\0";
let table = StringTable::new(data).unwrap();

assert_eq!(table.get(0, 5).unwrap(), "First");
assert_eq!(table.get(6, 6).unwrap(), "Second");
assert_eq!(table.get(13, 5).unwrap(), "Third");

pub const fn len(&self) -> usize

Get total size of the string table in bytes

Examples

use aion_context::string_table::StringTable;

let data = b"Alpha\0Beta\0";
let table = StringTable::new(data).unwrap();
assert_eq!(table.len(), 11);

pub const fn is_empty(&self) -> bool

Check if the string table is empty

Examples

use aion_context::string_table::StringTable;

let empty = StringTable::new(b"").unwrap();
assert!(empty.is_empty());

let non_empty = StringTable::new(b"Test\0").unwrap();
assert!(!non_empty.is_empty());

pub const fn as_bytes(&self) -> &'a [u8]

Get the raw byte data

Examples

use aion_context::string_table::StringTable;

let data = b"Hello\0";
let table = StringTable::new(data).unwrap();
assert_eq!(table.as_bytes(), b"Hello\0");

Trait Implementations

impl<'a> Clone for StringTable<'a>

fn clone(&self) -> StringTable<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for StringTable<'a>

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

Formats the value using the given formatter.

impl<'a> Copy for StringTable<'a>