array_get_index

此函数用于获取给定数组中特定值的索引。

可选地,可以向该函数提供偏移量和长度参数,以定义要搜索的数组的范围。

如果没有找到该值,则返回 -1。

提示 如果您要查找满足条件的第一个数组元素的索引,请使用 array_find_index

 

语法:

array_get_index(array, value, [offset], [length]);

参数类型描述
arrayArray要在其中查找值的数组
valueAny要寻找的值
offsetReal可选 数组中的偏移量或起始索引。设置负值将从数组的末尾开始计数。然后,起始索引将是 array_length(array)+offset。请参阅: 偏移量和长度
lengthReal可选 要遍历的元素数。负值将向后遍历数组(即以索引的降序,例如 2、1、0 而不是2、3、4)。请参阅:偏移量和长度

 

返回:

Real (the index of the first occurrence of the value if found or -1 if it isn't found)

 

示例1:

var _array = array_create(100, 1);
_array[7] = 13;
var _index = array_get_index(_array, 13);
show_debug_message("The value 13 was found at index {0}", _index);

上面的代码首先创建一个大小为 100 的临时数组 _ARRAY,并将索引 7 处的值设置为 13。然后使用 array_get_index 查找该值 13 的索引。最后,将显示一条调试消息,显示该索引。

 

示例2:

var _array = ["a", "b", "c", "d", "e", "d", "c", "b", "a"];
var _pos1 = array_get_index(_array, "d");                 // 3
var _pos2 = array_get_index(_array, "d", 6);              // -1
var _pos3 = array_get_index(_array, "d", -1, -infinity);  // 5

在上面的代码中,数组 _array 用一组字母进行了初始化。然后,使用不同的偏移量和长度值来查找字母 "d" 的位置三次。对 array_get_index 的调用结果显示在注释中。