Load array

Описание

Загружает данные в массив из указанного файла на диске

Синтаксис

Привязка к окну: нет.
Работа со свернутым окном: да.

 load_array %array [#array_x #array_y [#start_file_x #start_file_y [#count_x #count_y]]] $filename

Где:
%array - массив, в который будет происходить считывание данных
[#array_x #array_y] - начальные координаты в массиве, это если нужно загрузить не в начало массива
[#start_file_x #start_file_y] - начальные координаты в файле, это если нужно загрузить не с начала файла
[#count_x #count_y] - количество загружаемых столбцов и строк
$filename - путь к текстовому файлу, откуда считываются данные

Отсутствовать может любое количество операндов, начиная с конца и до имени массива. Последний из оставшихся операндов считается именем файла, им может являться имя массива.
Значения по умолчанию, начиная со второго операнда: 1,1,1,1,0,0. Они же являются минимально допустимыми. Если указано меньшее значение, то оно заменяется значением по умолчанию.
Массивы хранятся в виде [строка, столбец]. Элементы массива отделены друг от друга символом с кодом #9 (Tab).

Примеры

// Пример 1
load_array %arr D:\UOPilot\mas.txt
log %arr [1]   // первая строка из файла
log %arr [2]   // вторая
end_script

// Пример 2
// если в файле элементы отделены табуляцией
load_array %arr D:\UOPilot\mas.txt
log %arr [1 1]   // первая элемент первой строки
log %arr [1 2]   // второй элемент первой строки
log %arr [2 1]   // первая элемент второй строки
end_script

Смотрите также

Массивы
Save_array
Sort_array
Init_arr

История развития

2.00
Добавил возможность загружать массивы из файла. по-умолчанию файл ищется в каталоге со скриптами:

load_array %array #array_x #array_y #start_file_x #start_file_y #count_x #count_y $filename

2.20
При ошибке чтения массива командой 'load_array' скрипт продолжит работу с выводом сообщения в лог. Размер загруженного массива будет зависеть от того на каком этапе произошла ошибка.

2.21.1
Исправил ошибку в команде 'load_array' внесенную в версии 2.20.

2.29
Добавил вывод в лог сообщения об ошибке открытия файла в команде 'load_array'.
Добавил проверку на остановку скрипта в команде 'load_array'.
Добавил вывод в лог размера массива после загрузки файла в команде 'load_array'.

2.35
Добавил в команды 'save_array' и 'load_array' проверку на занятость файла другими скриптами. Ждут пока не освободится.
Убрал пока вывод в лог размера массива в 'load_array'.

2.38
Исправил ошибку подгрузки массива с частично пустыми значениями в команде 'load_array'.
Исправил усечение существующего массива при подгрузке нового в команде 'load_array'.