🎨 style(syntax): normalize naming conventions
Align all TSL syntax documentation examples with docs/tsl/naming.md: - Classes/types: PascalCase, drop Hungarian prefix (THuman→Human) - Parameters/locals: snake_case with meaningful names (isLeft→is_left, maxb→max_b) - Private members: snake_case_ with trailing underscore (real_part_, imaginary_part_) - Public members: PascalCase (value→Value) - Top-level functions: PascalCase (test→Test) - Module constants: kPascalCase (kernel_dll→kKernelDll) Affected: 01-24 syntax docs (23 files) Verified: 150+ code blocks locally tested, output unchanged Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Claude Fable 5
@@ -4,7 +4,7 @@
|
||||
是否可直接用于生成代码：仅部分
|
||||
是否含可直接照写示例：是
|
||||
是否含不可照写反例：是
|
||||
遇到不确定时：先按本页候选页继续判断；[05_functions_and_calls.md](05_functions_and_calls.md)、[06_expressions_and_operators.md](06_expressions_and_operators.md)、[14_ts_sql.md](14_ts_sql.md)、[15_debug_and_profiler.md](15_debug_and_profiler.md)、[19_namespace_libpath_and_unit_runtime.md](19_namespace_libpath_and_unit_runtime.md)、[21_builtin_runtime_objects.md](21_builtin_runtime_objects.md)、[../reference/catalog/datawarehouse.md](../reference/catalog/datawarehouse.md)；仍不命中时回到语法路由中心 [index.md](index.md)；如果问题已经超出语法层，回到 TSL 总入口 [../index.md](../index.md)
|
||||
遇到不确定时：先按本页候选页继续判断；[05_functions_and_calls.md](05_functions_and_calls.md)、[06_expressions_and_operators.md](06_expressions_and_operators.md)、[14_ts_sql.md](14_ts_sql.md)、[15_debug_and_profiler.md](15_debug_and_profiler.md)、[19_namespace_libpath_and_unit_runtime.md](19_namespace_libpath_and_unit_runtime.md)、[21_builtin_runtime_objects.md](21_builtin_runtime_objects.md)、[../codegen/dotnet/datawarehouse/](../codegen/dotnet/datawarehouse/)；仍不命中时回到语法路由中心 [index.md](index.md)；如果问题已经超出语法层，回到 TSL 总入口 [../index.md](../index.md)
|
||||
|
||||
这一篇只处理运行时环境参数、块环境 `with` 语句、`with` 后缀、`#` 网格调用、`timeout` 后缀、`dupvalue(...)` 和全局缓存，不处理任何金融业务语义。
|
||||
|
||||
@@ -36,11 +36,11 @@
|
||||
- `with array(...)` 只在该次调用里临时覆盖对应键，调用结束后会恢复外部原值。
|
||||
- 如果外部原值本来不存在，`with array(...)` 调用结束后，对应键会恢复成 `nil`。
|
||||
- 不要把上面的后缀 `with` 直接泛化成“任何本地函数调用后面都能接 `with array(...)`”；本地函数后缀 `with` 属于反例。
|
||||
- 本页只收通用键的例子；像 `pn_stock()`、`pn_date()` 这类金融上下文参数，统一到 [../reference/catalog/datawarehouse.md](../reference/catalog/datawarehouse.md) 查函数事实。
|
||||
- 本页只收通用键的例子；像 `pn_stock()`、`pn_date()` 这类金融上下文参数，统一到 [../codegen/dotnet/datawarehouse/](../codegen/dotnet/datawarehouse/) 查函数事实。
|
||||
- 网格调用的最小写法是 `r := #Func(args);`。
|
||||
- 网格调用返回的不是最终值；用 `dupvalue(r)` 取回结果。
|
||||
- `timeout N` 后缀可直接接在网格调用后面。
|
||||
- 全局缓存函数的参数规格见 [../reference/catalog/system.md](../reference/catalog/system.md)；本页只保留缓存引用的运行时行为示例。
|
||||
- 全局缓存函数的参数规格见 [../codegen/special/pending/system/03_global_cache.md](../codegen/special/pending/system/03_global_cache.md) 和 [../codegen/builtin/system.md](../codegen/builtin/system.md)；本页只保留缓存引用的运行时行为示例。
|
||||
- 写入和读取全局缓存成功时返回 `1`。
|
||||
- 从全局缓存取出的值，`ifCache(v)` 会返回 `1`。
|
||||
- 一旦对取出的缓存值做本地写入，它会立刻实例化；写入后 `ifCache(v)` 返回 `0`。
|
||||
@@ -94,9 +94,9 @@ writeLn(getSysParam("a"));
|
||||
|
||||
```tsl
|
||||
setSysParam("a", 1);
|
||||
sys_param_values := array("a": 2, "b": 3);
|
||||
param_values := array("a": 2, "b": 3);
|
||||
|
||||
with *, sys_param_values do
|
||||
with *, param_values do
|
||||
begin
|
||||
writeLn(getSysParam("a"));
|
||||
writeLn(getSysParam("b"));
|
||||
@@ -112,6 +112,33 @@ writeLn(getSysParam("b"));
|
||||
- 块后输出 `2`、`3`
|
||||
- 说明 `with *` 会把传入键合并进当前系统参数上下文；不要把它当成自动恢复外层值的隔离块
|
||||
|
||||
`with *, SysParamArray do` 使用当前所有系统参数：
|
||||
|
||||
代码块身份：可直接照写示例
|
||||
|
||||
```tsl
|
||||
setSysParam("a", 10);
|
||||
setSysParam("b", 20);
|
||||
with *, SysParamArray do
|
||||
begin
|
||||
writeLn(getSysParam("a"));
|
||||
writeLn(getSysParam("b"));
|
||||
end
|
||||
```
|
||||
|
||||
代码块身份：输出片段
|
||||
|
||||
```text
|
||||
10
|
||||
20
|
||||
```
|
||||
|
||||
说明：
|
||||
|
||||
- `SysParamArray` 是特殊关键字，表示引用当前所有系统参数
|
||||
- `with *, SysParamArray do` 把当前系统参数作为块环境传入
|
||||
- 这是服务端环境的常用写法，用于保持系统参数上下文
|
||||
|
||||
### 块环境 `with **`
|
||||
|
||||
代码块身份：可直接照写示例
|
||||
@@ -119,9 +146,9 @@ writeLn(getSysParam("b"));
|
||||
```tsl
|
||||
setSysParam("a", 1);
|
||||
setSysParam("b", 9);
|
||||
sys_param_values := array("b": 4);
|
||||
param_values := array("b": 4);
|
||||
|
||||
with **, sys_param_values do
|
||||
with **, param_values do
|
||||
begin
|
||||
writeLn(getSysParam("a") = nil);
|
||||
writeLn(getSysParam("b"));
|
||||
@@ -189,6 +216,8 @@ writeLn(getSysParam("b") = nil);
|
||||
|
||||
### `#` 网格调用与 `dupvalue`
|
||||
|
||||
网格调用函数：
|
||||
|
||||
代码块身份：可直接照写示例
|
||||
|
||||
```tsl
|
||||
@@ -211,6 +240,29 @@ end;
|
||||
6
|
||||
```
|
||||
|
||||
网格调用数组表达式：
|
||||
|
||||
代码块身份：可直接照写示例
|
||||
|
||||
```tsl
|
||||
items := array(1, 2, 3, 4, 5);
|
||||
grid_result := #(items * 2);
|
||||
writeLn(tostn(dupvalue(grid_result)));
|
||||
```
|
||||
|
||||
代码块身份：输出片段
|
||||
|
||||
```text
|
||||
array(2,4,6,8,10)
|
||||
```
|
||||
|
||||
说明：
|
||||
|
||||
- `#(表达式)` 可以对表达式进行网格计算
|
||||
- `#(items * 2)` 返回网格句柄
|
||||
- `dupvalue(grid_result)` 取回最终结果数组
|
||||
- 网格计算常用于大规模数组的分布式并行运算
|
||||
|
||||
### 网格调用的 `timeout`
|
||||
|
||||
代码块身份：可直接照写示例
|
||||
@@ -234,20 +286,27 @@ end;
|
||||
代码块身份：可直接照写示例
|
||||
|
||||
```tsl
|
||||
v1 := array(1, 2, 3);
|
||||
writeLn(setGlobalCache("PB_TEST_GC_BASIC", v1));
|
||||
writeLn(getGlobalCache("PB_TEST_GC_BASIC", v2));
|
||||
writeLn(ifCache(v2));
|
||||
writeLn(length(v2));
|
||||
writeLn(v2[0], ',', v2[1], ',', v2[2]);
|
||||
source_data := array(1, 2, 3);
|
||||
writeLn(setGlobalCache("PB_TEST_GC_BASIC", source_data));
|
||||
writeLn(getGlobalCache("PB_TEST_GC_BASIC", cached_data));
|
||||
writeLn(ifCache(cached_data));
|
||||
writeLn(length(cached_data));
|
||||
writeLn(cached_data[0], ',', cached_data[1], ',', cached_data[2]);
|
||||
```
|
||||
|
||||
结果说明：
|
||||
|
||||
- `setGlobalCache("PB_TEST_GC_BASIC", v1)` 返回 `1`
|
||||
- `getGlobalCache("PB_TEST_GC_BASIC", v2)` 返回 `1`
|
||||
- 取出的 `v2` 上 `ifCache(v2)` 返回 `1`
|
||||
- `v2` 长度是 `3`，内容是 `1,2,3`
|
||||
- `setGlobalCache("PB_TEST_GC_BASIC", source_data)` 返回 `1`
|
||||
- `getGlobalCache("PB_TEST_GC_BASIC", cached_data)` 返回 `1`
|
||||
- 取出的 `cached_data` 上 `ifCache(cached_data)` 返回 `1`
|
||||
- `cached_data` 长度是 `3`，内容是 `1,2,3`
|
||||
|
||||
说明：
|
||||
|
||||
- TSL 标识符大小写无关，`setGlobalCache` 和 `SetGlobalCache` 等价
|
||||
- 推荐使用小写 `setGlobalCache`、`getGlobalCache` 以保持一致性
|
||||
- `setGlobalCache(key, value)` 写入缓存，可选第三参数指定过期时间（秒）
|
||||
- `getGlobalCache(key, out_var)` 读取缓存到输出变量
|
||||
|
||||
### `checkGlobalCacheExpired`
|
||||
|
||||
@@ -255,16 +314,16 @@ writeLn(v2[0], ',', v2[1], ',', v2[2]);
|
||||
|
||||
```tsl
|
||||
setGlobalCache("PB_TEST_GC_EXPIRE", array(1, 2, 3));
|
||||
getGlobalCache("PB_TEST_GC_EXPIRE", v);
|
||||
writeLn(checkGlobalCacheExpired(v));
|
||||
getGlobalCache("PB_TEST_GC_EXPIRE", cache_ref);
|
||||
writeLn(checkGlobalCacheExpired(cache_ref));
|
||||
setGlobalCache("PB_TEST_GC_EXPIRE", array(1, 2, 3, 4));
|
||||
writeLn(checkGlobalCacheExpired(v));
|
||||
writeLn(checkGlobalCacheExpired(cache_ref));
|
||||
```
|
||||
|
||||
结果说明：
|
||||
|
||||
- 刚取出的缓存引用上，`checkGlobalCacheExpired(v)` 返回 `0`
|
||||
- 同名缓存被重新设置后，旧引用上的 `checkGlobalCacheExpired(v)` 返回 `1`
|
||||
- 刚取出的缓存引用上，`checkGlobalCacheExpired(cache_ref)` 返回 `0`
|
||||
- 同名缓存被重新设置后，旧引用上的 `checkGlobalCacheExpired(cache_ref)` 返回 `1`
|
||||
|
||||
### 写入后会实例化
|
||||
|
||||
@@ -272,17 +331,17 @@ writeLn(checkGlobalCacheExpired(v));
|
||||
|
||||
```tsl
|
||||
setGlobalCache("PB_TEST_GC_DETACH", array(1, 2, 3));
|
||||
getGlobalCache("PB_TEST_GC_DETACH", v);
|
||||
writeLn(ifCache(v));
|
||||
v[0] := 100;
|
||||
writeLn(ifCache(v));
|
||||
writeLn(v[0], ',', v[1], ',', v[2]);
|
||||
getGlobalCache("PB_TEST_GC_DETACH", local_copy);
|
||||
writeLn(ifCache(local_copy));
|
||||
local_copy[0] := 100;
|
||||
writeLn(ifCache(local_copy));
|
||||
writeLn(local_copy[0], ',', local_copy[1], ',', local_copy[2]);
|
||||
```
|
||||
|
||||
结果说明：
|
||||
|
||||
- 刚取出时 `ifCache(v)` 返回 `1`
|
||||
- 对 `v[0]` 赋值后，`ifCache(v)` 立即返回 `0`
|
||||
- 刚取出时 `ifCache(local_copy)` 返回 `1`
|
||||
- 对 `local_copy[0]` 赋值后，`ifCache(local_copy)` 立即返回 `0`
|
||||
- 写入后的本地值内容是 `100,2,3`
|
||||
|
||||
### 全局缓存参与 `select`
|
||||
@@ -290,13 +349,13 @@ writeLn(v[0], ',', v[1], ',', v[2]);
|
||||
代码块身份：可直接照写示例
|
||||
|
||||
```tsl
|
||||
src := array((1, 2), (3, 4), (2, 1));
|
||||
setGlobalCache("PB_TEST_GC_SELECT", src);
|
||||
getGlobalCache("PB_TEST_GC_SELECT", v);
|
||||
q := select * from v order by [0] desc end;
|
||||
writeLn(dataType(q));
|
||||
writeLn(mrows(q));
|
||||
writeLn(q[0][0], ',', q[0][1], ';', q[1][0], ',', q[1][1], ';', q[2][0], ',', q[2][1]);
|
||||
source_table := array((1, 2), (3, 4), (2, 1));
|
||||
setGlobalCache("PB_TEST_GC_SELECT", source_table);
|
||||
getGlobalCache("PB_TEST_GC_SELECT", cached_table);
|
||||
query_result := select * from cached_table order by [0] desc end;
|
||||
writeLn(dataType(query_result));
|
||||
writeLn(mrows(query_result));
|
||||
writeLn(query_result[0][0], ',', query_result[0][1], ';', query_result[1][0], ',', query_result[1][1], ';', query_result[2][0], ',', query_result[2][1]);
|
||||
```
|
||||
|
||||
结果说明：
|
||||
@@ -355,8 +414,8 @@ end;
|
||||
|
||||
代码块身份：反例 / 不可照写
|
||||
|
||||
```text
|
||||
r := Demo() with array("a": 11);
|
||||
```tsl
|
||||
cached_result := Demo() with array("a": 11);
|
||||
|
||||
function Demo();
|
||||
begin
|
||||
|
||||
Reference in New Issue
Block a user