Struct CsvFile 

pub struct CsvFile {
    pub headers: Vec<String>,
    pub records: Vec<CsvRecord>,
}

An in-memory representation of a CSV file with headers.

Fields

headers: Vec<String>

Column header names.

records: Vec<CsvRecord>

All data records.

Implementations

impl CsvFile

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

Create a new CsvFile with the given headers and no records.

pub fn add_record(&mut self, fields: Vec<String>)

Append a record from string fields.

pub fn add_record_f64(&mut self, values: &[f64])

Append a record from f64 values (formatted with full precision).

pub fn record_count(&self) -> usize

Return the number of data records (excluding header).

pub fn column_count(&self) -> usize

Return the number of columns (header count).

pub fn get_column_f64(&self, col_idx: usize) -> Result<Vec<f64>, String>

Extract all values from a column by index as f64.

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

Return the column index of a header name, or None if not found.

pub fn to_string(&self) -> String

Serialize the CSV file to a String (header + records, comma-separated).

pub fn to_string_with_delimiter(&self, delim: char) -> String

Serialize the CSV file using a custom delimiter character.

pub fn from_str(s: &str) -> Result<Self, String>

Parse a CSV string (first line = header, comma delimiter).

pub fn from_str_with_delimiter(s: &str, delim: char) -> Result<Self, String>

Parse a CSV string with a specified delimiter.

pub fn filter_rows(&self, col_idx: usize, pred: impl Fn(f64) -> bool) -> CsvFile

Return a new CsvFile containing only rows where pred(value) is true for the value in col_idx. Rows where parsing fails are excluded.

pub fn infer_column_type(&self, col_idx: usize) -> ColumnType

Infer the type of a column (Integer, Float, or Text).

pub fn select_columns(&self, col_indices: &[usize]) -> CsvFile

Return a new CsvFile containing only the specified columns (by index).

pub fn select_columns_by_name(&self, names: &[&str]) -> CsvFile

Return a new CsvFile containing only columns whose headers match the given names (preserving the order of names).

pub fn normalize_headers(&mut self)

Normalize headers: lowercase, replace spaces/special chars with underscores, strip leading/trailing whitespace.

pub fn column_stats(&self, col_idx: usize) -> Option<ColumnStats>

Compute statistics (min, max, mean, sum, count) for a numeric column. Returns None if no numeric values are found.

pub fn all_column_stats(&self) -> Vec<(String, ColumnStats)>

Compute statistics for all columns that are numeric. Returns a vector of (column_name, ColumnStats).

pub fn get_column_strings(&self, col_idx: usize) -> Result<Vec<String>, String>

Extract all values from a column as strings.

pub fn get_column_i64(&self, col_idx: usize) -> Result<Vec<i64>, String>

Extract all values from a column as i64.

pub fn sort_by_column(&mut self, col_idx: usize)

Sort rows by a column (ascending, numeric).