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

📦 deps(tsl): sync tsl-playbook from 5d73964d

Browse Source 
Source-Commit: 5d73964db8
This commit is contained in:
ci[bot]
2026-08-14 17:15:41 +08:00
parent 5f4ca63966
commit 2f0d80da65
574 changed files with 47871 additions and 14463 deletions
Download Patch File Download Diff File Expand all files Collapse all files
skills/tsl-api-reference/references/codegen/builtin/matrix.md
+58 -24
View File
@@ -869,18 +869,18 @@ writeLn(toStn(determinant));
// 1.0
```
## `nils(size_or_rows[, cols_or_fields])`
## `nils(n_1, ...)`
声明：function
创建元素为 `nil` 的一维或二维数组。传入一个参数时创建一维数组；传入两个参数时创建二维数组。第二个参数可以是列数或列名数组
创建元素为 `nil` 的多维数组，每个维度可以使用长度或下标数组定义
<!-- tags: 矩阵 创建 生成 matrix -->
| 参数 | 类型 | 说明 |
| ---------------- | -------------- | -------------------------------------------- |
| `size_or_rows` | integer\|array | 一维长度、二维行数或行标数组 |
| `cols_or_fields` | integer\|array | 可选。二维列数或列名数组，省略时创建一维数组 |
| 参数 | 类型 | 说明 |
| ----- | -------------- | ---------------------------- |
| `n_1` | integer\|array | 第一维长度或下标数组 |
| `...` | integer\|array | 可选。后续各维长度或下标数组 |
返回：array
@@ -902,18 +902,26 @@ echo mRows(value), ",", mCols(value), ",", value[1, 2] = nil;
// 输出：2,3,1
```
## `ones(size_or_rows[, cols_or_fields])`
范例03：创建三维空值数组
```tsl
value := nils(2, 3, 4);
echo mRows(value), ",", mCols(value), ",", length(value[0, 0]), ",", value[1, 2, 3] = nil;
// 输出：2,3,4,1
```
## `ones(n_1, ...)`
声明：function
创建元素为 `1` 的一维或二维数组。传入一个参数时创建一维数组；传入两个参数时创建二维数组。第二个参数可以是列数或列名数组
创建元素为 `1` 的多维数组，每个维度由对应参数指定
<!-- tags: 矩阵 创建 生成 matrix -->
| 参数 | 类型 | 说明 |
| ---------------- | -------------- | -------------------------------------------- |
| `size_or_rows` | integer\|array | 一维长度、二维行数或行标数组 |
| `cols_or_fields` | integer\|array | 可选。二维列数或列名数组，省略时创建一维数组 |
| 参数 | 类型 | 说明 |
| ----- | -------------- | -------------------------------------------- |
| `n_1` | integer\|array | 第一维长度或行标数组 |
| `...` | integer\|array | 可选。后续各维长度，第二维也可以使用列名数组 |
返回：array
@@ -935,18 +943,28 @@ echo mRows(value), ",", mCols(value), ",", value[1, 2];
// 输出：2,3,1
```
## `rand(size_or_rows[, cols_or_fields])`
范例03：创建三维全一数组
```tsl
value := ones(2, 3, 4);
echo length(value), ",", length(value[0]), ",", length(value[0][0]);
// 输出：2,3,4
```
## `rand(n_1, n_2, rand_info, ...)`
声明：function
创建元素为随机数的一维或二维数组。传入一个参数时创建一维数组；传入两个参数时创建二维数组。随机数默认位于 `0` 到 `1` 之间。第二个参数可以是列数或列名数组
创建随机数多维数组，默认生成 `0` 到 `1` 之间的均匀分布随机数，也可以通过 `rand_info` 指定分布
<!-- tags: 矩阵 创建 生成 matrix -->
| 参数 | 类型 | 说明 |
| ---------------- | -------------- | -------------------------------------------- |
| `size_or_rows` | integer\|array | 一维长度、二维行数或行标数组 |
| `cols_or_fields` | integer\|array | 可选。二维列数或列名数组，省略时创建一维数组 |
| 参数 | 类型 | 说明 |
| ----------- | -------------- | -------------------------- |
| `n_1` | integer\|array | 第一维长度或行标数组 |
| `n_2` | integer\|array | 可选。第二维长度或列名数组 |
| `rand_info` | array | 可选。随机分布名称及其参数 |
| `...` | integer | 可选。第三维及后续各维长度 |
返回：array
@@ -960,18 +978,26 @@ echo mRows(value), ",", mCols(value), ",", value[0, 0] >= 0, ",", value[0, 0] <=
// 输出：2,3,1,1
```
## `zeros(size_or_rows[, cols_or_fields])`
范例02：创建三维正态分布随机数组
```tsl
value := rand(2, 3, array("normal", 0, 1), 4);
echo length(value), ",", length(value[0]), ",", length(value[0][0]);
// 输出：2,3,4
```
## `zeros(n_1, ...)`
声明：function
创建元素为 `0` 的一维或二维数组。传入一个参数时创建一维数组；传入两个参数时创建二维数组。第二个参数可以是列数或列名数组；第一个参数也可以使用行标数组
创建元素为 `0` 的多维数组，每个维度由对应参数指定
<!-- tags: 矩阵 创建 生成 matrix -->
| 参数 | 类型 | 说明 |
| ---------------- | -------------- | -------------------------------------------- |
| `size_or_rows` | integer\|array | 一维长度、二维行数或行标数组 |
| `cols_or_fields` | integer\|array | 可选。二维列数或列名数组，省略时创建一维数组 |
| 参数 | 类型 | 说明 |
| ----- | -------------- | -------------------------------------------- |
| `n_1` | integer\|array | 第一维长度或行标数组 |
| `...` | integer\|array | 可选。后续各维长度，第二维也可以使用列名数组 |
返回：array
@@ -1000,3 +1026,11 @@ value := zeros(array("L1", "L2"), array("F1", "F2"));
echo value["L1"]["F1"];
// 输出：0
```
范例04：创建三维全零数组
```tsl
value := zeros(2, 3, 4);
echo length(value), ",", length(value[0]), ",", length(value[0][0]);
// 输出：2,3,4
```