Как работает функция arrayAdd в AutoIt?

Функция _ArrayAdd в AutoIt добавляет указанное значение в конец существующего одномерного или двумерного массива. www.autoitscript.com

Некоторые особенности работы функции:

• Параметры: массив для изменения, добавляемое значение (может быть одиночным элементом, строкой с разделителями или массивом). www.autoitscript.com autoit-script.ru
• Дополнительные параметры: столбец, с которого будет начинаться добавление (только для двумерных массивов), разделители для разделения строки (для строк, которые нужно разделить на элементы или строки, которые нужно разделить на строки). www.autoitscript.com
• Поведение при недостатке элементов: если в добавляемом значении недостаточно элементов, добавляется пустая строка. www.autoitscript.com Избыточные элементы игнорируются. www.autoitscript.com
• Изменение типа данных для добавленных элементов: параметр iForce позволяет изменить поведение вставки по умолчанию или изменить тип данных для добавленных элементов. www.autoitscript.com

Возвращаемое значение: при успешном выполнении функция возвращает индекс последней добавленной ячейки. autoit-script.ru В случае ошибки возвращается -1 и устанавливается переменная @error. autoit-script.ru

Важно учитывать, что функция не перезаписывает первый элемент массива, если он уже присутствует. forum.hpc.name