# Array.insert

## 功能

在指定下标插入一个或多个元素。

## 语法

```bt
array.insert(index, value1, value2, ...)
```

## 参数

| 参数 | 类型 | 必填 | 默认值 | 说明 |
| ------ | ------ | ------ | ------ | ------ |
| index | Int | 否 | 0 | 插入位置；负数从尾部反向计数，越界会夹到数组边界。 |
| valueN | Any | 否 | 无 | 要插入的元素。 |

## 返回值

| 类型 | 说明 |
| ------ | ------ |
| Array | 返回原数组对象，便于继续链式调用。 |

## 示例

```bt
items = [1, 4]
items.insert(1, 2, 3)

// 输出：[1,2,3,4]
echo(items)
```

## 注意事项

- insert 会修改原数组。
- 只需要插入元素时，insert 比 splice(index, 0, value) 更直观。