_ArrayInsert
Добавить новую ячейку со значением в указанной позиции.
#include <Array.au3>
_ArrayInsert(ByRef $avArray, $iElement [, $vValue = ""])
Параметры
| $avArray | Массив для изменения |
| $iElement |
Позиция (будущий индекс) добавляемой ячейки. Позиция не должна превышать размер массива, т.е. максимальная позиция добавляет в конец массива, иначе вызывает ошибку. |
| $vValue |
[необязательный] Значение вставляемое в ячейку |
Возвращаемое значение
| Успех: | Возвращает новый размер массива |
| Ошибка: | Возвращает 0, устанавливает @error |
| @error: | 1 - Массив $avArray не является массивом |
| 2 - Массив $avArray не является одномерным массивом |
См. также
_ArrayAdd, _ArrayDelete, _ArrayPop, _ArrayPushПример
#include <Array.au3>
Local $avArray[10]
$avArray[0] = "JPM"
$avArray[1] = "Holger"
$avArray[2] = "Jon"
$avArray[3] = "Larry"
$avArray[4] = "Jeremy"
$avArray[5] = "Valik"
$avArray[6] = "Cyberslug"
$avArray[7] = "Nutster"
$avArray[8] = "JdeB"
$avArray[9] = "Tylo"
_ArrayDisplay($avArray, "$avArray ПЕРЕД _ArrayInsert()")
_ArrayInsert($avArray, 4, "= Вставленный =")
_ArrayDisplay($avArray, "$avArray ПОСЛЕ _ArrayInsert()")