列表类拼图参考 - Soft8Soft
Description: 此类拼图提供了在场景中对列表进行各种操作的方法。

# 列表 | List

列表是一个有序的项目集合，如"待办事项"列表或购物清单。列表中的项目可以是任何类型的，同一个值可以在列表中出现多次。

## 内容

- 简介
- 拼图参考
  - create
  - length
  - get / remove
  - set / insert
  - create empty
  - create with item repeated
  - reverse
  - is empty
  - find
  - check item
  - get sub-list
  - sort
  - list from text / text from list
- 另请参阅

#

## 简介

当您需要批量处理多个项目，如对象时，列表非常有用。除此之外，您可以在列表中存储任何类型的信息，比如可配置的选项、类似HTML元素的属性、RGB值、坐标等等。

#

## 拼图参考

#

### create

此拼图用于创建一个新的列表并指定初始值。从左边的灰色工具箱中拖动一个 item 块到 list 块中来添加新的插槽。

下面的例子中，一旦用户点击立方体，就会隐藏列表中指定的所有3个对象。

列表可以是嵌套的（例如，列表的子列表），也可以将所有位置留空。如果留空，会在留空的位置自动放置一个 null 值。

#

### length

此拼图用于计算指定列表中的项目数量。在留空的位置自动插入的 null 值也会被计算在内。

示例：

#

### get / remove

此拼图从指定的位置获取（并/或移除）项目（列表中的项目是从0开始索引的）。

示例：

如果指定位置没有项目，此拼图返回 `undefined`。

#

### set / insert

此拼图允许您向列表中添加项目。set 变体是用一个不同的项目替换列表中指定位置上的项目（列表的长度保持不变）。insert 变体在列表的指定位置添加一个新的项目，并将之前在该位置的项目移位（从而增加列表的长度）。记住，列表中的项目是从0开始索引的。

示例：

#

### create empty

此拼图创建了一个新的空白列表，以便以后填充项目。

示例：

#

### create with item repeated

此拼图创建了一个在所有的位置上都有相同的项目的新列表。与 create empty 变体的主要区别在于，这个列表被初始化为一个预定义的长度，以及一些初始值。

示例：

#

### reverse

此拼图使用原列表项目创建了一个新的列表，但顺序相反。原始列表不会被改变。

示例：

#

### is empty

此拼图检查一个指定的列表是否不包含任何项目，如果是，则返回 `true`，否则返回 `false`。与 逻辑 拼图一起使用。

示例：

#

### find

此拼图可以用来检查一个项目是否在一个列表中，以及位置信息。如果该项目被找到，它将返回其位置（列表中的项目从0开始索引）。如果没有找到这个项目，拼图返回 -1。

示例：

#

### check item

此拼图可以用来检查一个项目是否包含在列表中。如果找到了这个项目，它会返回布尔值 true。如果没有找到这个项目，拼图返回 false。

#

### get sub-list

此拼图可将列表中两个指定位置之间的区域提取为新的列表（列表中的项目从0开始索引）。原始列表不会被改变。

示例：

#

### sort

此拼图使用原列表项目创建了一个新的列表，但采用了升序或降序排列。原始列表不会被改变。

示例：

#

### list from text / text from list

此拼图允许您通过拆分一些文本来创建一个列表，或者做相反的事情——将列表中的项目连接成一行文本。

将文本分割成列表的示例：

列表连接成文本的示例：

#

## 另请参阅

列表通过数字索引存储元素。如果您需要一个带有命名元素的存储，请参考字典。

## 在使用拼图时遇到困难？

欢迎您随时在 论坛上提问！您还可以加入中文用户社区QQ群(171678760)，在线寻求帮助。