mf_expression/functions/
mod.rs

1//! 函数模块
2//!
3//! 提供表达式中可用的各种函数类型，包括内置函数、自定义函数、方法和已废弃函数
4
5pub use crate::functions::date_method::DateMethod;
6pub use crate::functions::defs::FunctionTypecheck;
7pub use crate::functions::deprecated::DeprecatedFunction;
8pub use crate::functions::internal::InternalFunction;
9pub use crate::functions::method::{MethodKind, MethodRegistry};
10pub use crate::functions::registry::FunctionRegistry;
11pub use crate::functions::custom::CustomFunction;
12pub use crate::functions::state_guard::{StateGuard, with_state_async};
13
14use std::fmt::Display;
15use strum_macros::{Display, EnumIter, EnumString, IntoStaticStr};
16
17pub mod arguments; // 函数参数处理
18pub mod custom;
19mod date_method; // 日期方法
20pub mod defs; // 函数定义接口
21mod deprecated; // 已废弃函数
22pub mod internal; // 内置函数
23mod method; // 方法注册表
24pub(crate) mod registry; // 函数注册表
25pub mod state_guard; // State 守卫模块
26
27/// 函数类型枚举
28///
29/// 定义了表达式系统中所有可用的函数类型
30#[derive(Debug, PartialEq, Eq, Clone)]
31pub enum FunctionKind {
32    /// 内置函数：系统预定义的标准函数
33    Internal(InternalFunction),
34    /// 已废弃函数：为向后兼容保留的旧函数
35    Deprecated(DeprecatedFunction),
36    /// 闭包函数：用于数组操作的特殊函数
37    Closure(ClosureFunction),
38    /// 自定义函数：用户定义的扩展函数
39    Custom(CustomFunction),
40}
41
42impl TryFrom<&str> for FunctionKind {
43    type Error = strum::ParseError;
44
45    /// 从字符串解析函数类型
46    ///
47    /// 按优先级顺序尝试匹配：内置函数 > 已废弃函数 > 闭包函数 > 自定义函数
48    fn try_from(value: &str) -> Result<Self, Self::Error> {
49        InternalFunction::try_from(value)
50            .map(FunctionKind::Internal)
51            .or_else(|_| {
52                DeprecatedFunction::try_from(value)
53                    .map(FunctionKind::Deprecated)
54            })
55            .or_else(|_| {
56                ClosureFunction::try_from(value).map(FunctionKind::Closure)
57            })
58            .or_else(|_| {
59                CustomFunction::try_from(value).map(FunctionKind::Custom)
60            })
61    }
62}
63
64impl Display for FunctionKind {
65    fn fmt(
66        &self,
67        f: &mut std::fmt::Formatter<'_>,
68    ) -> std::fmt::Result {
69        match self {
70            FunctionKind::Internal(i) => write!(f, "{i}"),
71            FunctionKind::Deprecated(d) => write!(f, "{d}"),
72            FunctionKind::Closure(c) => write!(f, "{c}"),
73            FunctionKind::Custom(c) => write!(f, "{c}"),
74        }
75    }
76}
77
78/// 闭包函数枚举
79///
80/// 定义了用于数组操作的特殊闭包函数
81#[derive(
82    Debug,
83    PartialEq,
84    Eq,
85    Hash,
86    Display,
87    EnumString,
88    EnumIter,
89    IntoStaticStr,
90    Clone,
91    Copy,
92)]
93#[strum(serialize_all = "camelCase")]
94pub enum ClosureFunction {
95    /// 全部匹配：检查数组中所有元素是否都满足条件
96    All,
97    /// 无匹配：检查数组中是否没有元素满足条件
98    None,
99    /// 存在匹配：检查数组中是否有元素满足条件
100    Some,
101    /// 唯一匹配：检查数组中是否只有一个元素满足条件
102    One,
103    /// 过滤：返回满足条件的元素组成的新数组
104    Filter,
105    /// 映射：对每个元素应用函数，返回结果数组
106    Map,
107    /// 扁平映射：对每个元素应用函数并展平结果
108    FlatMap,
109    /// 计数：统计满足条件的元素数量
110    Count,
111}
mf_expression/functions/mod.rs

mf_expression/functions/
mod.rs
