# 简写

### 简写

简单来说，代码块中有一些基本的简写方法，这些方法使数据管理 *更加* 容易。我们将详细介绍下面的基础知识，并讨论如何使用此简写来创建和查询数据。

| **数据类型** | **标准 Dynamo** | **等效代码块** |
| -------- | ------------- | --------- |
| 数字       | !             | !         |
| 字符串      | !             | !         |
| 序列       | !             | !         |
| 范围       | !             | !         |
| 获取索引处的项目 | !             | !         |
| 创建列表     | !             | !         |
| 连接字符串    | !             | !         |
| 条件语句     | !             | !         |

### 其他语法

|                      |             |                                    |
| -------------------- | ----------- | ---------------------------------- |
| **节点**               | **等效代码块**   | **注释**                             |
| 任何运算符（+、&&、>=、Not 等） | +、&&、>=、! 等 | 请注意，“Not”变为“!”，但该节点被称为“Not”以区分“阶乘” |
| 布尔值 True             | true;       | 注意小写                               |
| 布尔值 False            | false;      | 注意小写                               |

### 范围和序列

定义范围和序列的方法可缩减为基本简写。使用下图作为“..”语法的指导，以使用代码块定义数值数据列表。在完成此标记法后，创建数值数据是一个非常有效的过程：

!

> 1. 在本例中，数字范围会替换为定义 `beginning..end..step-size;` 的基本 **“代码块”** 语法。通过以数字表示，可以得到：`0..10..1;`
> 2. 请注意，语法 `0..10..1;` 等同于 `0..10;`，步长 1 是简写表示法的默认值。因此，`0..10;` 将给出一个从 0 到 10 的序列（步长为 1）。
> 3. *“序列”* 示例类似，除了我们使用“#”来指明我们希望列表中包含 15 个值，而不是列表中的最大值为 15。在本例中，我们将定义：`beginning..#ofSteps..step-size:`。序列的实际语法为 `0..#15..2`
> 4. 使用上一步中的 *“#”*，我们现在将其放置在语法的 *“step-size”* 部分中。现在，我们有一个 *数字范围*，从 *“beginning”* 到 *“end”*，*“step-size”* 表示法指示两者之间均匀分布多个值：`beginning..end..#ofSteps`

### 高级范围

创建高级范围后，我们即可简单地处理列表的列表。在下面的示例中，我们将隔离主要范围表示法的变量，并创建该列表的另一个范围。

!

> 1.创建嵌套范围，将带“#”的表示法与不带符号的表示法进行比较。相同逻辑在基本范围中都适用，但它稍显复杂。
>
> 2.我们可以在主范围内的任意位置处定义子范围；请注意，我们也可以有两个子范围。
>
> 3.通过控制范围中的“end”值，我们可以创建多个长度不同的的范围。

作为逻辑练习，请比较上述两个简写，并尝试解析 *“subranges”* 和 *“#”* 表示法如何驱动结果输出。

!

### 生成列表并从列表中获取项目

除了使用简写生成列表外，我们还可以即时创建列表。这些列表可以包含多种元素类型，也可以进行查询（请记住，列表本身就是对象）。总之，使用代码块时，可以创建列表，并从带括号的列表中查询项目（即“方括号”）：

!

> 1.使用字符串快速创建列表，并使用项目索引进行查询。
>
> 2.使用变量创建列表，并使用范围简写表示法进行查询。

管理嵌套列表的过程类似。请注意列表顺序，并使用多组方括号进行调用：

!

> 1.定义一列列表。
>
> 2.使用单括号表示法查询列表。
>
> 3.使用双括号表示法查询项目。

## 练习：正弦曲面

> 单击下面的链接下载示例文件。
>
> 可以在附录中找到示例文件的完整列表。

{% file src="/files/KBvoz1BIEWHAKd3ktGFU" %}

在本练习中，我们将调整新的简写技能，以创建由范围和公式定义的精美蛋壳曲面。在本练习中，请注意我们如何串联使用代码块和现有 Dynamo 节点：我们将代码块用于繁重的数据提升，而 Dynamo 节点以可视方式布局来使定义清晰易读。

首先，通过连接上述节点创建曲面。请勿使用数字节点定义宽度和长度，而是双击画布并在代码块中键入 `100;`

!

!

> 1. 通过在 **“代码块”** 中键入 `0..1..#50`，定义一个介于 0 和 1 之间的范围（其中包含 50 个划分）。
> 2. 将该范围连接到 **“Surface.PointAtParameter”**，它会在曲面上提取介于 0 和 1 之间的 u 和 v 值。请记得通过在 **“Surface.PointAtParameter”** 节点上单击鼠标右键，将“连缀”更改为“叉积”。

在此步骤中，我们会使用第一个函数以在 Z 方向上向上移动点栅格。此栅格将基于底层函数驱动生成的曲面。添加新节点，如下图所示

!

> 1. 我们使用带有以下行的**码块**：`(0..Math.Sin(x*360)..#50)*5;`。为了对该内容快速详细介绍，我们定义了一个内部带有公式的范围。此公式为正弦函数。在 Dynamo 中，正弦函数接收度数输入，因此为了获得完整正弦波，我们将x 值（这一范围输入介于 0 到 1 之间）乘以 360。接下来，我们希望每行都具有与控制栅格点相同数量的划分，因此我们用 #50 定义了 50 个细分。最后，乘数 5 只会增加平移幅度，因此我们可以在 Dynamo 预览中查看效果。

!

> 1. 虽然上一个 **“代码块”** 正常工作，但它并非完全参数化。我们希望动态驱动其参数，因此我们会将上一步中的代码行替换为 `(0..Math.Sin(x*360*cycles)..#List.Count(x))*amp;`。这使我们可以根据输入定义这些值。

通过更改滑块（范围介于 0 到 10 之间），我们会得到一些有趣的结果。

!

!

> 1. 通过对数字范围执行转置，我们会反转幕墙波的方向：`transposeList = List.Transpose(sineList);`

!

> 1. 如果添加 sineList 和 tranposeList，我们会得到一个扭曲的蛋壳曲面：`eggShellList = sineList+transposeList;`

我们会更改下面指定的滑块值，以“平静地控制”该算法。

!

最后，让我们使用“代码块”查询数据的隔离部分。要使用特定范围的点重新生成曲面，请在 **“Geometry.Translate”** 和 **“NurbsSurface.ByPoints”** 节点之间添加上述代码块。这包含以下文本行：`sineStrips[0..15..1];`。这将选择前 16 行点（共 50 行）。通过重新创建曲面，可以看到我们已生成点栅格的隔离部分。

!

!

> 1. 在最后一步中，为了提高此 **“代码块”** 的参数化，我们使用介于 0 到 1 之间的滑块来驱动查询。我们使用以下代码行来执行此操作：`sineStrips[0..((List.Count(sineStrips)-1)*u)];`。这看起来可能会令人困惑，但代码行提供的方法让我们可以快速地将列表的长度缩放为 0 到 1 之间的乘数。

滑块上的值 `0.53` 会创建刚好经过栅格中点的曲面。

!

如预期的一样，值为 `1` 的滑块会基于完整的栅格点创建曲面。

!

通过查看可视图形，我们可以亮显代码块并查看其每个函数。

!

> 1.第一个 **“代码块”** 替换 **“Number”** 节点。
>
> 2.第二个 **“代码块”** 替换 **“Number Range”** 节点。
>
> 3.第三个**代码块**替换 **List.Transpose**、**List.Count** 和 **Number Range** 节点。
>
> 4.第四个 **“代码块”** 查询一列列表，以便替换 **“List.GetItemAtIndex”** 节点。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://primer2.dynamobim.org/zh-cn/8_coding_in_dynamo/8-1_code-blocks-and-design-script/3-shorthand.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.