aether/builtins/trace.rs
1// src/builtins/trace.rs
2//
3// 结构化 TRACE 内置函数。
4//
5// 注意:这些函数在 evaluator 中有特殊处理,以便直接写入引擎的内存 TRACE 缓冲区。
6
7use crate::evaluator::RuntimeError;
8use crate::value::Value;
9
10/// TRACE - 基础 TRACE 函数(向后兼容)
11///
12/// 用法: TRACE(value1, value2, ...) 或 TRACE("label", value1, value2, ...)
13pub fn trace(_args: &[Value]) -> Result<Value, RuntimeError> {
14 // 在 evaluator 中有特殊处理
15 Ok(Value::Null)
16}
17
18/// TRACE_DEBUG - 调试级别 TRACE
19///
20/// 用法: TRACE_DEBUG("category", value1, value2, ...)
21pub fn trace_debug(_args: &[Value]) -> Result<Value, RuntimeError> {
22 // 在 evaluator 中有特殊处理
23 Ok(Value::Null)
24}
25
26/// TRACE_INFO - 信息级别 TRACE(默认)
27///
28/// 用法: TRACE_INFO("category", value1, value2, ...)
29pub fn trace_info(_args: &[Value]) -> Result<Value, RuntimeError> {
30 // 在 evaluator 中有特殊处理
31 Ok(Value::Null)
32}
33
34/// TRACE_WARN - 警告级别 TRACE
35///
36/// 用法: TRACE_WARN("category", value1, value2, ...)
37pub fn trace_warn(_args: &[Value]) -> Result<Value, RuntimeError> {
38 // 在 evaluator 中有特殊处理
39 Ok(Value::Null)
40}
41
42/// TRACE_ERROR - 错误级别 TRACE
43///
44/// 用法: TRACE_ERROR("category", value1, value2, ...)
45pub fn trace_error(_args: &[Value]) -> Result<Value, RuntimeError> {
46 // 在 evaluator 中有特殊处理
47 Ok(Value::Null)
48}