Skip to main content

fast_excel/
expr.rs

1//! 列值表达式:导出计算列的闭包入参 [`RowValues`] 与类型别名 [`CellExpr`]
2//!
3//! 「表达式」= 业务侧写的 Rust 闭包;本模块只提供统一入参,方便按表头或下标取值。
4//! 常用计算请配合 [`crate::funcs`] 里的内置函数方法。
5
6use std::sync::Arc;
7
8use crate::column::ColumnDef;
9use crate::value::CellValue;
10
11/// 导出表达式入参:当前行「已映射的单元格值」+ 列定义(两者下标对齐)
12#[derive(Debug, Clone, Copy)]
13pub struct RowValues<'a> {
14    /// 与 `columns` 下标对齐的单元格值
15    pub cells: &'a [CellValue],
16    /// 列定义
17    pub columns: &'a [ColumnDef],
18}
19
20impl<'a> RowValues<'a> {
21    pub fn new(cells: &'a [CellValue], columns: &'a [ColumnDef]) -> Self {
22        Self { cells, columns }
23    }
24
25    /// 按列下标取值
26    pub fn at(&self, index: usize) -> Option<&CellValue> {
27        self.cells.get(index)
28    }
29
30    /// 按表头取值(未匹配到返回 `None`)
31    pub fn get(&self, header: &str) -> Option<&CellValue> {
32        let index = self.columns.iter().position(|c| c.header == header)?;
33        self.cells.get(index)
34    }
35
36    /// 按表头取显示文本(取不到返回空串)
37    pub fn text(&self, header: &str) -> String {
38        self.get(header).map(|v| v.to_text()).unwrap_or_default()
39    }
40
41    /// 整行值
42    pub fn list(&self) -> &[CellValue] {
43        self.cells
44    }
45}
46
47/// 导出列表达式:`Arc<dyn Fn(&RowValues) -> CellValue>`
48pub type CellExpr = Arc<dyn for<'a> Fn(&RowValues<'a>) -> CellValue + Send + Sync>;