fast-excel 1.0.0

通用 Excel 导入导出工具:流式读写(百万级)、动态表头适配、多 sheet、单元格图片、批量落库(纯 Rust,对标 EasyExcel)
Documentation
//! 列值表达式:导出计算列的闭包入参 [`RowValues`] 与类型别名 [`CellExpr`]
//!
//! 「表达式」= 业务侧写的 Rust 闭包;本模块只提供统一入参,方便按表头或下标取值。
//! 常用计算请配合 [`crate::funcs`] 里的内置函数方法。

use std::sync::Arc;

use crate::column::ColumnDef;
use crate::value::CellValue;

/// 导出表达式入参:当前行「已映射的单元格值」+ 列定义(两者下标对齐)
#[derive(Debug, Clone, Copy)]
pub struct RowValues<'a> {
    /// 与 `columns` 下标对齐的单元格值
    pub cells: &'a [CellValue],
    /// 列定义
    pub columns: &'a [ColumnDef],
}

impl<'a> RowValues<'a> {
    pub fn new(cells: &'a [CellValue], columns: &'a [ColumnDef]) -> Self {
        Self { cells, columns }
    }

    /// 按列下标取值
    pub fn at(&self, index: usize) -> Option<&CellValue> {
        self.cells.get(index)
    }

    /// 按表头取值(未匹配到返回 `None`)
    pub fn get(&self, header: &str) -> Option<&CellValue> {
        let index = self.columns.iter().position(|c| c.header == header)?;
        self.cells.get(index)
    }

    /// 按表头取显示文本(取不到返回空串)
    pub fn text(&self, header: &str) -> String {
        self.get(header).map(|v| v.to_text()).unwrap_or_default()
    }

    /// 整行值
    pub fn list(&self) -> &[CellValue] {
        self.cells
    }
}

/// 导出列表达式:`Arc<dyn Fn(&RowValues) -> CellValue>`
pub type CellExpr = Arc<dyn for<'a> Fn(&RowValues<'a>) -> CellValue + Send + Sync>;