---
title: "列表 List"
description: "动态数值/字符串列表"
---
---
title: 列表 List
description: 动态数值/字符串列表
---
`sa` · 扩展 `CLEO+` · 需 CLEO + CLEO+
动态列表（数值 / 字符串）。写法见 [Lua](/docs/cleo/syntax) / [Redux](/docs/cleo/syntax-redux)。
## 生命周期
按 `ListType` 建列表。
```text
0E72 CREATE_LIST
in: type
out: handle
```
```lua
local list = createList(listType)
```
```js
const handle = List.create(type)
```
删列表。
```text
0E73 DELETE_LIST
in: self
```
```lua
deleteList(list)
```
```js
List.delete(self)
```
## 数值项
追加数值项。
```text
0E74 LIST_ADD
in: self, value
```
```lua
listAdd(list, 42)
```
```js
List.add(self, value)
```
按数值移除一项。
```text
0E75 LIST_REMOVE_VALUE
in: self, value
```
```lua
listRemoveValue(list, 42)
```
```js
List.removeValue(self, value)
```
按下标移除。
```text
0E76 LIST_REMOVE_INDEX
in: self, index
```
```lua
listRemoveIndex(list, 0)
```
```js
List.removeIndex(self, index)
```
元素个数。
```text
0E77 GET_LIST_SIZE
in: self
out: entries
```
```lua
local n = getListSize(list)
```
```js
const entries = List.getSize(self)
```
按下标取数值。
```text
0E78 GET_LIST_VALUE_BY_INDEX
in: self, index
out: value
```
```lua
local v = getListValueByIndex(list, 0)
```
```js
const value = List.getValueByIndex(self, index)
```
清空所有项。
```text
0E79 RESET_LIST
in: self
```
```lua
resetList(list)
```
```js
List.reset(self)
```
## 字符串项
按下标取字符串。
```text
0E7A GET_LIST_STRING_VALUE_BY_INDEX
in: self, index
out: string
```
```lua
local s = getListStringValueByIndex(list, 0)
```
```js
const string = List.getStringValueByIndex(self, index)
```
追加字符串。
```text
0E7B LIST_ADD_STRING
in: self, string
```
```lua
listAddString(list, "hi")
```
```js
List.addString(self, string)
```
按字符串内容移除。
```text
0E7C LIST_REMOVE_STRING_VALUE
in: self, string
```
```lua
listRemoveStringValue(list, "hi")
```
```js
List.removeStringValue(self, string)
```
## 区间 / 反转
按下标区间移除 `[start, stop)`。
```text
0E7D LIST_REMOVE_INDEX_RANGE
in: self, start, stop
```
```lua
listRemoveIndexRange(list, 0, 2)
```
```js
List.removeIndexRange(self, start, stop)
```
反转顺序。
```text
0E7E REVERSE_LIST
in: self
```
```lua
reverseList(list)
```
```js
List.reverse(self)
```
## 替换 / 插入
按下标替换数值项。
```text
0F06 REPLACE_LIST_VALUE_BY_INDEX
in: self, index, value
```
```lua
replaceListValueByIndex(list, 0, 99)
```
```js
List.replaceValueByIndex(self, index, value)
```
按下标替换字符串项。
```text
0F07 REPLACE_LIST_STRING_VALUE_BY_INDEX
in: self, index, string
```
```lua
replaceListStringValueByIndex(list, 0, "new")
```
```js
List.replaceStringValueByIndex(self, index, string)
```
按下标插入数值。
```text
0F08 INSERT_LIST_VALUE_BY_INDEX
in: self, index, value
```
```lua
insertListValueByIndex(list, 0, 1)
```
```js
List.insertValueByIndex(self, index, value)
```
按下标插入字符串。
```text
0F09 INSERT_LIST_STRING_VALUE_BY_INDEX
in: self, index, string
```
```lua
insertListStringValueByIndex(list, 0, "hi")
```
```js
List.insertStringValueByIndex(self, index, string)
```