array_insert

此函数用于将一个值(或多个值)插入到数组中的任何给定位置。

您可以提供数组、数组中要插入的索引(位置)以及至少要插入的一个值,但您可以选择提供更多参数,并且它们都将从给定索引开始按连续顺序插入到数组中。

注意 如果给定的索引超出了数组的长度,则将在给定的索引处添加值,并且数组中最后一个值和插入的值之间的任何空槽都将设置为默认值0。

 

语法:

array_insert(variable, index, value, [value], [value], [etc...]);

参数类型描述
variableArray保存数组的变量。
indexReal数组中要插入值的索引(位置)。支持负索引,从数组末尾开始计数。偏移量-1表示数组的最后一个元素,偏移量-2表示最后一个元素之前的一个元素,依此类推(参见偏移量和长度)
valueAny要插入的值
[value], [value], [etc...]Any可选 要插入数组的其他值

 

返回:

N/A

 

示例1:插入单个值

array = [1, 2, 3, 5];
var _missing_value = 4;
array_insert(array, 3, _missing_value);
show_debug_message(array);

上面的代码将缺少的值插入到索引为3的数组数组中。插入该值后,调试消息会显示数组的内容。

 

示例2:插入多个值

var _array = ["G", "a", "k", "e", "r"];
array_insert(_array, 2, "m", "e", "M", "a");
show_debug_message(string_join_ext("", _array));

上面的代码创建了一个临时数组 _array,然后使用 array_insert 在索引 6 处插入几个值。之后,调用 string_join_ext 将数组中的字母连接起来,并将结果字符串作为调试消息输出。