Struct DxSection 

pub struct DxSection {
    pub schema: Vec<String>,
    pub rows: Vec<Vec<DxLlmValue>>,
}

A data section with schema-defined columns and rows.

DxSection represents tabular data in the DX LLM format. Each section has a schema (column names) and rows of DxLlmValue data.

LLM Format Syntax

#d(id,name,active)[    // Section 'd' with schema: id, name, active
  1,Alice,+            // Row 1
  2,Bob,-              // Row 2
]

Examples

Creating a Section

use serializer::llm::{DxSection, DxLlmValue};

let mut section = DxSection::new(vec![
    "id".to_string(),
    "name".to_string(),
    "active".to_string(),
]);

// Add rows (must match schema length)
section.add_row(vec![
    DxLlmValue::Num(1.0),
    DxLlmValue::Str("Alice".to_string()),
    DxLlmValue::Bool(true),
]).unwrap();

assert_eq!(section.row_count(), 1);
assert_eq!(section.column_count(), 3);

Error Handling

use serializer::llm::{DxSection, DxLlmValue};

let mut section = DxSection::new(vec!["a".to_string(), "b".to_string()]);

// Wrong number of columns returns an error
let result = section.add_row(vec![DxLlmValue::Num(1.0)]);
assert!(result.is_err());

Thread Safety

DxSection implements Send + Sync and can be safely shared between threads.

See Also

• DxDocument - Parent container for sections
• DxLlmValue - Value type for row data

Fields

schema: Vec<String>

Column names from the schema.

Defines the structure of each row. All rows must have exactly schema.len() values.

rows: Vec<Vec<DxLlmValue>>

Row data.

Each row is a vector of DxLlmValue with length matching the schema.

Implementations

impl DxSection

pub fn new(schema: Vec<String>) -> Self

Create a new section with the given schema

pub fn add_row(&mut self, row: Vec<DxLlmValue>) -> Result<(), String>

Add a row to the section

Errors

Returns an error if the row length doesn’t match the schema length.

pub fn row_count(&self) -> usize

Get the number of rows

pub fn column_index(&self, name: &str) -> Option<usize>

Get the zero-based column index by schema name.

pub fn column_values(&self, name: &str) -> Option<Vec<&DxLlmValue>>

Return all values from a named column.

pub fn value_by_key( &self, key_column: &str, key: &str, value_column: &str, ) -> Option<&DxLlmValue>

Find a value by matching one column and returning another.

pub fn column_count(&self) -> usize

Get the number of columns

Trait Implementations

impl Clone for DxSection

fn clone(&self) -> DxSection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DxSection

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

Formats the value using the given formatter.

impl PartialEq for DxSection

fn eq(&self, other: &DxSection) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for DxSection