mirror of
https://gitee.com/zlgopen/awtk.git
synced 2024-12-02 20:18:22 +08:00
540 lines
8.4 KiB
Markdown
540 lines
8.4 KiB
Markdown
## array 扩展函数
|
||
|
||
array 是一个通用的数组，里面可以放混合数据类型的数据。
|
||
|
||
array 有以下属性：
|
||
|
||
* size 元素的个数
|
||
* capacity 元素的最大个数
|
||
|
||
### 1.array\_create
|
||
|
||
> 创建 array 对象。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_create() => object
|
||
array_create(elem1, elem2, elem3, ...) => object
|
||
```
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create();
|
||
var b = array_create(123, 456, 789);
|
||
```
|
||
|
||
### 2.array\_create\_with\_str
|
||
|
||
> 创建 array 对象。以指定的分隔符把字符串拆开，并转换为指定类型的数据，放入数组中。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_create_with_str(str, sep, type) => object
|
||
```
|
||
|
||
type 为可选参数，可选取值为：
|
||
|
||
* int 表示整数。
|
||
* double 表示浮点数。
|
||
* 其它或默认为字符串。
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("a2,a1,a3", ",");
|
||
a = array_create_with_str("2,1,3", ",", "int");
|
||
a = array_create_with_str("2,1,3", ",", "double");
|
||
```
|
||
|
||
### 3.array\_create\_repeated
|
||
|
||
> 创建 array 对象。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_create_repeated(value, nr) => object
|
||
```
|
||
|
||
* value 为初始化的值。
|
||
* nr 为值的个数。
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_repeated(123, 3);
|
||
```
|
||
|
||
### 4.array\_dup
|
||
|
||
> 创建 array 对象。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_dup(arr, start, end) => object
|
||
```
|
||
|
||
> 1. start 为开始的位置，默认为 0。
|
||
> 2. end 为结束的位置（不包含）
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
var b = array_dup(a);
|
||
var c = array_dup(a, 1);
|
||
var d = array_dup(a, 1, 2);
|
||
```
|
||
|
||
### 5.array\_push
|
||
|
||
> 追加一个或多个数据，并返回写入数据的个数。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_push(array, v, ...) => uint32_t
|
||
```
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create();
|
||
array_push(a, "123");
|
||
array_push(a, "456", "789");
|
||
```
|
||
|
||
### 6.array\_pop
|
||
|
||
> 弹出最后一个元素
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_pop(array) => value
|
||
```
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
var b = array_pop(a);
|
||
```
|
||
|
||
### 7.array\_shift
|
||
|
||
> 弹出第一个元素
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_shift(array) => value
|
||
```
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
var b = array_shift(a);
|
||
```
|
||
|
||
### 8.array\_get
|
||
|
||
> 获取指定位置的元素
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_get(array, index) => value
|
||
```
|
||
|
||
> index 为负数时，从后往前取。比如-1 表示最后一个元素。
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
var b = array_get(a, 0);
|
||
var c = array_get(a, -1);
|
||
```
|
||
|
||
### 9.array\_set
|
||
|
||
> 修改指定位置的元素
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_set(array, index, value) => bool
|
||
```
|
||
|
||
> index 为负数时，从后往前取。比如-1 表示最后一个元素。
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
array_set(a, 0, 4);
|
||
array_set(a, -1, 5);
|
||
```
|
||
|
||
### 10.array\_insert
|
||
|
||
> 插入元素到指定位置
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_insert(array, index, value) => bool
|
||
```
|
||
|
||
> index 为负数时，从后往前取。比如-1 表示最后一个元素。
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
array_insert(a, 0, 4);
|
||
array_insert(a, -1, 5);
|
||
```
|
||
|
||
### 11.array\_index\_of
|
||
|
||
> 获取元素首次出现的位置。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_index_of(array, value) => index
|
||
```
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
var b = array_index_of(a, 1);
|
||
```
|
||
|
||
### 12.array\_last\_index\_of
|
||
|
||
> 获取元素最后出现的位置。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_last_index_of(array, value) => index
|
||
```
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
var b = array_last_index_of(a, 1);
|
||
```
|
||
|
||
### 13.array\_remove
|
||
|
||
> 删除指定位置的元素
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_remove(array, index) => bool
|
||
```
|
||
|
||
> index 为负数时，从后往前取。比如-1 表示最后一个元素。
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
array_remove(a, 0);
|
||
array_remove(a, -1);
|
||
```
|
||
|
||
### 14.array\_get\_and\_remove
|
||
|
||
> 删除指定位置的元素，并返回该元素。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_get_and_remove(array, index) => value
|
||
```
|
||
|
||
> index 为负数时，从后往前取。比如-1 表示最后一个元素。
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
array_get_and_remove(a, 0);
|
||
array_get_and_remove(a, -1);
|
||
```
|
||
|
||
### 15.array\_clear
|
||
|
||
> 删除全部元素
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_clear(array) => bool
|
||
```
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
array_clear(a);
|
||
```
|
||
|
||
### 16.array\_join
|
||
|
||
> 连接全部元素成一个字符串。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_join(array, sep) => str
|
||
```
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
var b = array_join(a, ",");
|
||
```
|
||
|
||
### 17.array\_sort
|
||
|
||
> 根据当前的数据类型排序，以第一个元素类型为准。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_sort(array, ascending, ignore_case) => bool
|
||
```
|
||
|
||
> 1. ascending 是否为升序，默认是。
|
||
> 2. ignore_case 是否忽略大小写，仅用于字符串，默认为否。
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
assert(array_sort(a));
|
||
var d = array_join(a, ":");
|
||
assert(d == "1:2:3")
|
||
|
||
assert(array_sort(a, false));
|
||
d = array_join(a, ":");
|
||
assert(d == "3:2:1")
|
||
```
|
||
|
||
### 18.array\_min
|
||
|
||
> 获取最小值。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_min(array) => double
|
||
```
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
var b = array_min(a);
|
||
```
|
||
|
||
### 19.array\_max
|
||
|
||
> 获取最大值。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_max(array) => double
|
||
```
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
var b = array_max(a);
|
||
```
|
||
|
||
### 20.array\_avg
|
||
|
||
> 求平均值。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_avg(array) => double
|
||
```
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
var b = array_avg(a);
|
||
```
|
||
|
||
### 21.array\_sum
|
||
|
||
> 求和。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_sum(array) => double
|
||
```
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
var b = array_sum(a);
|
||
```
|
||
|
||
### 22.array\_clone\_and\_sort
|
||
|
||
> clone一份数据，根据当前的数据类型排序，以第一个元素类型为准。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_clone_and_sort(array, ascending, ignore_case) => array
|
||
```
|
||
|
||
> 1. ascending 是否为升序，默认是。
|
||
> 2. ignore_case 是否忽略大小写，仅用于字符串，默认为否。
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
var b = array_clone_and_sort(a);
|
||
var c = array_join(b, ":");
|
||
assert(c == "1:2:3")
|
||
```
|
||
|
||
### 23.array\_reverse
|
||
|
||
> 反向。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_reverse(array) => bool
|
||
```
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
array_reverse(a);
|
||
```
|
||
|
||
### 24.array\_is\_empty
|
||
|
||
> 判断数组是否为空。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_is_empty(array) => bool
|
||
```
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create();
|
||
assert(array_is_empty(a));
|
||
```
|
||
|
||
### 25.array\_size
|
||
|
||
> 获取数组中属性的个数。
|
||
----------------------------
|
||
|
||
#### 原型
|
||
|
||
```js
|
||
array_size(array) => size
|
||
```
|
||
|
||
#### 示例
|
||
|
||
```js
|
||
var a = array_create_with_str("2,1,3", ",", "int");
|
||
var b = array_size(a);
|
||
```
|
||
|
||
### 更多示例
|
||
|
||
```js
|
||
var a = array_create()
|
||
assert(array_push(a,1,2,3) == 3)
|
||
assert(array_push(a,"a","b","c") == 3)
|
||
assert(array_pop(a), "c")
|
||
assert(array_pop(a), "b")
|
||
assert(array_pop(a), "a")
|
||
assert(array_pop(a), "3")
|
||
assert(array_pop(a), "2")
|
||
assert(array_pop(a), "1")
|
||
assert(value_is_valid(array_pop(a)))
|
||
assert(array_clear(a))
|
||
assert(a.size == 0)
|
||
|
||
assert(array_insert(a, 0, 'a'))
|
||
assert(array_insert(a, 1, 'b'))
|
||
assert(array_insert(a, 2, 'c'))
|
||
assert(array_insert(a, 3, 'd'))
|
||
assert(a.size == 4)
|
||
assert(array_remove(a, 0))
|
||
|
||
assert(array_get(a, 0) == 'b')
|
||
assert(array_set(a, 0, 'bbb'))
|
||
assert(array_get(a, 0) == 'bbb')
|
||
assert(array_set(a, 0, 'b'))
|
||
|
||
assert(array_get(a, 1) == 'c')
|
||
assert(array_set(a, 1, 'ccc'))
|
||
assert(array_get(a, 1) == 'ccc')
|
||
assert(array_set(a, 1, 'c'))
|
||
assert(array_join(a, ',') == 'b,c,d')
|
||
print(a.size, a.capacity)
|
||
```
|