csh/playbook
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

✨ feat(tsl-api-reference): index class and unit APIs

Browse Source 
Migrate reference pages to declaration-line storage and rebuild the
13-column index.

Add qualified member lookup plus regression and end-to-end coverage.
This commit is contained in:
csh
2026-07-29 15:47:46 +08:00
parent 9edc8fc868
commit 13be5ea0aa
239 changed files with 39157 additions and 12846 deletions
Download Patch File Download Diff File Expand all files Collapse all files
skills/tsl-api-reference/references/codegen/dotnet/runtime/string.md
+166
View File
@@ -2,6 +2,8 @@
## `adjustLineBreaks(s, style)`
声明：function
字符串相关函数。
| 参数 | 类型 | 说明 |
@@ -13,6 +15,8 @@
## `ansiDequotedStr(s, aquote)`
声明：function
字符串相关函数。
| 参数 | 类型 | 说明 |
@@ -24,6 +28,8 @@
## `ansiIndexStr(a_text, a_values)`
声明：function
判定指定的字符串Atext可以匹配到的第一个由参数Avalues指定的字符串数组中元素索引号，就是数组的第几个元素（从0开始计算）。返回整数，如果没有找到匹配的字符串，就返回-1。与AnsiEndsText函数不同，字符串的匹配是大小写敏感的 注意：这种判定是基于大小写敏感
| 参数 | 类型 | 说明 |
@@ -35,6 +41,8 @@
## `ansiIndexText(a_text, a_values)`
声明：function
判定指定的字符串Atext可以匹配到的第一个由参数Avalues指定的字符串数组中元素索引号，就是数组的第几个元素（从0开始计算）。返回整数，如果没有找到匹配的字符串，就返回-1 注意：这种判定是基于大小写不敏感
| 参数 | 类型 | 说明 |
@@ -46,6 +54,8 @@
## `ansiMatchStr(a_text, avalues)`
声明：function
判定指定的字符串Atext是否可以匹配由参数Avalues指定的字符串数组中的某个字符串。返回布尔型真假值，如果Atext匹配到了Avalues数组中的某个字符串，就返回真，否则返回假。与AnsiMatchText函数不同，字符串的匹配是大小写敏感的 注意：这种判定是基于大小写敏感
| 参数 | 类型 | 说明 |
@@ -57,6 +67,8 @@
## `ansiMatchText(a_text, avalues)`
声明：function
判定指定的字符串Atext是否可以完全匹配由参数Avalues指定的字符串数组中的某个字符串。返回布尔型真假值，如果Atext匹配到了Avalues数组中的某个字符串，就返回真，否则返回假。 注意：这种判定是基于大小写不敏感。
| 参数 | 类型 | 说明 |
@@ -68,6 +80,8 @@
## `ansiQuotedStr(s, quote)`
声明：function
字符串相关函数。
| 参数 | 类型 | 说明 |
@@ -79,6 +93,8 @@
## `ansiStr2Array(value, aps)`
声明：function
常用字符串函数相关函数。
| 参数 | 类型 | 说明 |
@@ -90,6 +106,8 @@
## `boolToStr(s)`
声明：function
将布尔型转换成字符串类型并返回。参数UseBoolStrs一般为假，如果B为真，函数返回'-1',如果B为假，返回'0'。若想返回’True’与’False’的结果可用BoolToStr2实现。
| 参数 | 类型 | 说明 |
@@ -100,6 +118,8 @@
## `containsText(a_text, a_sub_text)`
声明：function
字符串相关函数。
| 参数 | 类型 | 说明 |
@@ -111,6 +131,8 @@
## `dateTimeToString(format, date_time)`
声明：function
根据参数Format给定的格式串将参数DateTime转换成字符串类型存到参数Result中，其中格式串的使用参照FormaTDateTime函数
| 参数 | 类型 | 说明 |
@@ -122,6 +144,8 @@
## `eval(exp)`
声明：function
表达式求值。返回，表达式的值。字符串表达式中支持return。TSL.EXE支持 tsl -eval "echo 100"的模式直接调用TSL语句。 表达式允许在跨函数中传导引用参数和变量
| 参数 | 类型 | 说明 |
@@ -132,18 +156,24 @@
## `fHeader()`
声明：function
字符串，TS-OPS服务注册时需要指定的头部信息，比如TS-OPS-CALL等。 类型：读写
返回：string
## `fUrl()`
声明：function
字符串，TS-OPS服务注册地址 类型：读写
返回：string
## `importjsonstring(json)`
声明：function
将json串转化为天软数据类型。 对大无符号数据会自动转换为长整型（INT64） 注意：输入的字符串应是ASCII编码的。因为JSON标准使用UTF8编码，所以请先使用天软Utf8ToAnsi将UTF8编码的字符串缓缓为ASCII编码。可参考下面的例程。
| 参数 | 类型 | 说明 |
@@ -154,6 +184,8 @@
## `leftStr(text, num_chars)`
声明：function
返回字符串从开始向左数Num_Chars个字符组成的字符串，支持多字节语言，一个汉字当成一个字符。
| 参数 | 类型 | 说明 |
@@ -165,6 +197,8 @@
## `ord(value)`
声明：function
如果是STRING类型返回value\[1\]的ASCII序号，就是value字符串的第一个字符的ASCII序号,如果为WIDESTRING，则为UNICODE码。
| 参数 | 类型 | 说明 |
@@ -175,6 +209,8 @@
## `reversebString(s)`
声明：function
字符串相关函数。
| 参数 | 类型 | 说明 |
@@ -187,6 +223,8 @@
## `rightStr(text, num_chars)`
声明：function
前N个字符；基于所指定的字符数返回文本字符串中的最后一个或后几个字符；
| 参数 | 类型 | 说明 |
@@ -198,6 +236,8 @@
## `setChar(s, index, ch)`
声明：function
设置字符串/二进制流中相应位置的字符。Char为0-255之间的整数类型
| 参数 | 类型 | 说明 |
@@ -210,6 +250,8 @@
## `setLikeFlag(flag, return_value)`
声明：function
设置Like操作符号的正则表达式默认控制状态。默认值为1。
| 参数 | 类型 | 说明 |
@@ -221,6 +263,8 @@
## `soundexWord(a_text)`
声明：function
发音相关函数相关函数。
| 参数 | 类型 | 说明 |
@@ -231,6 +275,8 @@
## `str2Array(value, aps)`
声明：function
字符串相关函数。
| 参数 | 类型 | 说明 |
@@ -242,6 +288,8 @@
## `string(value)`
声明：function
将数据转换为字符串。
| 参数 | 类型 | 说明 |
@@ -252,6 +300,8 @@
## `strSubscriptTableToNormal(t, fn)`
声明：function
字符串下标数组-->索引下标数组。
| 参数 | 类型 | 说明 |
@@ -263,6 +313,8 @@
## `strToBool(s)`
声明：function
如果S为'0'，返回假，如果是非0的数字串，则返回真
| 参数 | 类型 | 说明 |
@@ -273,6 +325,8 @@
## `strToCurr(s)`
声明：function
将数字字符串S转换成实数返回，字符串中不允许有千分号，最大有效小数位为4位，超过四位小数的处理在不同的版本处理可能存在不一致的地方。
| 参数 | 类型 | 说明 |
@@ -283,6 +337,8 @@
## `strToDate(s)`
声明：function
将字符串S转换成TDateTime类型的日期
| 参数 | 类型 | 说明 |
@@ -293,6 +349,8 @@
## `strToDateTime(s)`
声明：function
将字符串S转换成TDateTime类型的日期和时间
| 参数 | 类型 | 说明 |
@@ -303,6 +361,8 @@
## `strToFloat(s)`
声明：function
将数字字符串S转换成实数返回，字符串中不允许有千分号
| 参数 | 类型 | 说明 |
@@ -313,6 +373,8 @@
## `strToInt(s)`
声明：function
将字符串转换为整数。 支持各种进制格式字符串的转换（如二进制、十六进制等）。若只转换十进制格式字符串，可使用函数FAQ：DecToInt
| 参数 | 类型 | 说明 |
@@ -323,6 +385,8 @@
## `strToInt32(s)`
声明：function
将字符串转换为32位整数。 支持各种进制格式字符串的转换（如二进制、十六进制等）。若只转换十进制格式字符串，可使用函数FAQ：DecToInt32
| 参数 | 类型 | 说明 |
@@ -333,6 +397,8 @@
## `strToInt64(s)`
声明：function
将字符串转换为64位整数。 支持各种进制格式字符串的转换（如二进制、十六进制等）。若只转换十进制格式字符串，可使用函数FAQ：DecToInt64
| 参数 | 类型 | 说明 |
@@ -343,6 +409,8 @@
## `strToTime(s)`
声明：function
将字符串S转换成TDateTime类型的时间
| 参数 | 类型 | 说明 |
@@ -353,6 +421,8 @@
## `tryStrToTime(s)`
声明：function
将字符串S转换成TDateTime类型的时间并存到参数Value中。如果转换成功，则返回真，否则返回假
| 参数 | 类型 | 说明 |
@@ -363,6 +433,8 @@
## `unUnicodeEsc2(s)`
声明：function
字符串相关函数。
| 参数 | 类型 | 说明 |
@@ -373,6 +445,8 @@
## `unUnicodeEsc2W(s)`
声明：function
字符串相关函数。
| 参数 | 类型 | 说明 |
@@ -383,6 +457,8 @@
## `writeFile(data_type, alias, file_name, pos, length, data)`
声明：function
将数据写到本地文件。文件格式可以是字符流、整数流、实数流、字节流等。 多个线程同时写入时无需加锁等操作，仅需将位置设置为-1则可保障追加模式，如果调用失败，可检测返回值为字符串后然后重试即可。（当多线程尝试打开同一个文件写入时会返回错误）
| 参数 | 类型 | 说明 |
@@ -400,6 +476,8 @@
## `floatToStrEx(r, n)`
声明：function
浮点->字符串
| 参数 | 类型 | 说明 |
@@ -418,6 +496,8 @@ return floatToStrEx (12.6578, 2);
## `textToHtml(src)`
声明：function
将字符串转化为HTML标准格式的串
| 参数 | 类型 | 说明 |
@@ -437,6 +517,8 @@ The First LETTER won't be replaced by 'one',&
## `textToUrl(a_src)`
声明：function
将字符串转化为URL标准格式的串
| 参数 | 类型 | 说明 |
@@ -455,6 +537,8 @@ return textToUrl(a_src);
## `htmlToText(src)`
声明：function
将HTML标准格式的串转化为文本字符串
| 参数 | 类型 | 说明 |
@@ -475,6 +559,8 @@ return htmlToText(src);
## `getPyStringList()`
声明：function
汉字拼音首字母对照表
返回：tslobj
@@ -489,6 +575,8 @@ return sl.values("明");
## `sameFileName(s1, s2)`
声明：function
比较两个文件名是否相同，如果同名返回true，否则返回false。
| 参数 | 类型 | 说明 |
@@ -507,6 +595,8 @@ return sameFileName('index.tsl', "test.tsl");
## `formatFloatExt(v, dtype)`
声明：function
格式化输出－数字
| 参数 | 类型 | 说明 |
@@ -527,6 +617,8 @@ return formatFloatExt("123");
## `spaceByNumber(n)`
声明：function
生成N个空格字符串
| 参数 | 类型 | 说明 |
@@ -544,6 +636,8 @@ return write('---', spaceByNumber(2), '---');
## `tryUppercase(s)`
声明：function
将字符串S转换成大写并返回，不抛出异常，转换失败时返回""
| 参数 | 类型 | 说明 |
@@ -561,6 +655,8 @@ return tryUppercase("abc");
## `tryLowercase(s)`
声明：function
将字符串S转换成小写并返回，不抛出异常，转换失败时返回""
| 参数 | 类型 | 说明 |
@@ -578,6 +674,8 @@ return tryUppercase("ABC");
## `letters(vlaue, ul)`
声明：function
将数字与在字符串进行对照转换。基本用法同R的letters。在超出26的时候，仿excel的列名的规则提取。用于将excel数字列名转为字符串列名：1->'A'。
| 参数 | 类型 | 说明 |
@@ -596,6 +694,8 @@ return letters(1, 0);
## `decToInt64(s)`
声明：function
将字符串转换为64位整数。
| 参数 | 类型 | 说明 |
@@ -621,6 +721,8 @@ return strToInt64("0x12"); // 输出：18L
## `decToInt64Def(s, default)`
声明：function
将字符串转换为64位整数。如果转换失败，则返回Default值。
| 参数 | 类型 | 说明 |
@@ -648,6 +750,8 @@ return strToInt64Def("0x12", 1); // 输出：18L
## `tryDecToInt64(s, value)`
声明：function
将字符串转换为64位整数。若转换成功，转换值通过Value输出。
| 参数 | 类型 | 说明 |
@@ -700,6 +804,8 @@ return "转换失败！";
## `decToInt32(s)`
声明：function
将字符串转换为32位整数。
| 参数 | 类型 | 说明 |
@@ -725,6 +831,8 @@ return strToInt32("0x12"); // 输出：18
## `decToInt32Def(s, default)`
声明：function
将字符串转换为32位整数。如果转换失败，则返回Default值。
| 参数 | 类型 | 说明 |
@@ -752,6 +860,8 @@ return strToInt32Def("0x12", 1); // 输出：18
## `tryDecToInt32(s, value)`
声明：function
将字符串转换为32位整数。若转换成功，转换值通过Value输出。
| 参数 | 类型 | 说明 |
@@ -804,6 +914,8 @@ return "转换失败！";
## `decToInt(s)`
声明：function
将字符串转换为整数。
| 参数 | 类型 | 说明 |
@@ -829,6 +941,8 @@ return strToInt("0x12"); // 输出：18
## `decToIntDef(s, default)`
声明：function
将字符串转换为整数。如果转换失败，则返回Default值。
| 参数 | 类型 | 说明 |
@@ -856,6 +970,8 @@ return strToIntDef("0x12", 1); // 输出：18
## `tryDecToInt(s, value)`
声明：function
将字符串转换为整数。若转换成功，转换值通过Value输出。
| 参数 | 类型 | 说明 |
@@ -908,6 +1024,8 @@ return "转换失败！";
## `floatToStrne(value)`
声明：function
将实数转换成字符串类型。和FloatToStr的区别：在处理浮点数据时，FloatToStrne的结果不会输出为1E15等格式
| 参数 | 类型 | 说明 |
@@ -927,6 +1045,8 @@ return floatToStrne(1E15);
## `fuzzyCompare(_type, s1, s2)`
声明：function
根据指定算法，计算两字符串的相似性
| 参数 | 类型 | 说明 |
@@ -947,6 +1067,8 @@ return fuzzyCompare(fzJaccard(), "kitten", "sitting"); // 等价于FuzzyCompare(
## `fuzzyCompareEx(_type, s1, s2, n, nret)`
声明：function
根据指定算法，计算两字符串的相似性
| 参数 | 类型 | 说明 |
@@ -970,6 +1092,8 @@ return array(t, nret);
## `fzEditDistance()`
声明：function
基于编辑距离（Edit Distance）的模糊匹配算法，核心是计算将一个字符串转换为另一个字符串所需的最小编辑操作次数，允许的操作包含插入、删除、替换三类。
返回：integer
@@ -995,6 +1119,8 @@ return array(t, nret);
## `fzHammingDistance()`
声明：function
Hamming Distance（汉明距离）算法类型：计算两字符串对应位置上不同字符的数量。
返回：integer
@@ -1020,6 +1146,8 @@ return array(t, nret);
## `fzLongestSubstring()`
声明：function
Longest Substring（最长公共子串）算法类型：找出两字符串中连续出现的最长相同子串。
返回：integer
@@ -1045,6 +1173,8 @@ return array(t, nret);
## `fzLongestSequnce()`
声明：function
Longest Sequnce（最长公共子序列）算法类型：找出两字符串中顺序相同但不必连续的最长子序列
返回：integer
@@ -1070,6 +1200,8 @@ return array(t, nret);
## `fzJaccard()`
声明：function
Jaccard相似度算法类型：将字符串根据指定长度n（默认值为2）划分为两个字符集合，计算两集合交集元素个数与并集元素个数的比值。
返回：integer
@@ -1096,6 +1228,8 @@ return array(t, nret);
## `fzCosine()`
声明：function
Cosine（余弦相似度）算法类型：将字符串根据指定长度n（默认值为2）划分为两个字符集合，将字符集合转换为向量，计算两向量夹角的余弦值。
返回：integer
@@ -1121,6 +1255,8 @@ return fuzzyCompareEx(fzCosine(), "kitten", "sitting", 1, nret);
## `fzJaroWinkler()`
声明：function
Jaro-Winkler距离算法类型：先统计两字符串的匹配字符数与换位次数，并代入Jaro距离算法公式，得到相似度，再根据两字符串的公共前缀长度给予额外加权，得到最终的相似度
返回：integer
@@ -1143,6 +1279,8 @@ return fuzzyCompareEx(fzJaroWinkler(), "kitten", "sitting", n, nret);
## `fzSimHash()`
声明：function
SimHash（局部敏感哈希）算法类型：对字符串分词并计算加权哈希生成二进制指纹，比较两个指纹间的对应位置上不同字符的数量
返回：integer
@@ -1166,6 +1304,8 @@ return array(t, nret);
## `formatStrExt(s)`
声明：function
判断字符串是否是字符串，不是字符串的显示为“-”
| 参数 | 类型 | 说明 |
@@ -1185,6 +1325,8 @@ return formatStrExt(123);
## `seprateStrToTotal(s)`
声明：function
把用;分割的字符串转换为#分割
| 参数 | 类型 | 说明 |
@@ -1202,6 +1344,8 @@ return seprateStrToTotal('债券型;现金型;配置型;股票型;保本型');
## `totalStrToSeprate(s)`
声明：function
把用#分割的字符串转换为;分割
| 参数 | 类型 | 说明 |
@@ -1219,6 +1363,8 @@ return totalStrToSeprate ('债券型#现金型#配置型#股票型#保本型');
## `dateStrToArr(end_dates, sep1, sep2)`
声明：function
把日期区间字符串转换为列表
| 参数 | 类型 | 说明 |
@@ -1239,6 +1385,8 @@ return dateStrToArr('2007-9-10;2007-9-10', '$', ';'); // '$'表示结束位置
## `rDateStrToArr(rdate_list)`
声明：function
把报告期字符串转换为列表
| 参数 | 类型 | 说明 |
@@ -1259,6 +1407,8 @@ return rDateStrToArr('20070331;20070630');
## `replaceStrByReg(s, reg_from_text, to_text)`
声明：function
正则表达式快速字符串替换，大小写敏感。
| 参数 | 类型 | 说明 |
@@ -1278,6 +1428,8 @@ return replaceStrByReg("abcdeak", "A", "kkkk");
## `replaceTextByReg(s, reg_from_text, to_text)`
声明：function
正则表达式快速字符串替换，大小写不敏感。
| 参数 | 类型 | 说明 |
@@ -1297,6 +1449,8 @@ return replaceTextByReg("abcdeak", "a", "kkkk");
## `parseRegExpr3(s, reg_from_text, to_text, parse_ctrls)`
声明：function
直接返回输出的正则表达式解析。
| 参数 | 类型 | 说明 |
@@ -1317,6 +1471,8 @@ return parseRegExpr3("abcdeak", "ab", "kkkk", "ir");
## `floatToStrneW(value)`
声明：function
将实数转换成宽字节字符串类型。和FloatToStrW的区别：在处理大数量级数据（如1E15、10^15等）时，FloatToStrneW的结果不会输出为1E15等格式。
| 参数 | 类型 | 说明 |
@@ -1336,6 +1492,8 @@ return floatToStrneW(1E15);
## `hztoPy(hz)`
声明：function
汉字翻译为拼音
| 参数 | 类型 | 说明 |
@@ -1353,6 +1511,8 @@ return hztoPy("华夏盛势"); // HXCS HXSS
## `tostring(v)`
声明：function
将数值转成字符串类型
| 参数 | 类型 | 说明 |
@@ -1363,18 +1523,24 @@ return hztoPy("华夏盛势"); // HXCS HXSS
## `DT_Date()`
声明：function
返回'Date'字符串。
返回：string
## `DT_Str()`
声明：function
返回'String'字符串。
返回：string
## `DT_Real()`
声明：function
返回'Real'字符串。
返回：string