Описание вспомогательной функции


_ArrayPush

Добавляет новые элементы в массив, не увеличивая его размер.
Вставляет новые значения в конец, одновременно удаляя элементы в начале или наоборот.

_ArrayPush($var_array,$var_value[,$var_idirection=0])

Параметры

$var_array Массив для изменения
$var_value Добавляемое значение(ия) (может быть в виде массива значений)
$var_idirection [необязательный] Направление сдвига существующих элементов массива:
    0 = Сдвигая влево (добавляет в конец)
    1 = Сдвигая вправо (добавляет в начало)

Возвращаемое значение

Успех:Возвращает 1
Ошибка:Возвращает 0, устанавливает @error:
@error:1 - Массив $var_array не является массивом
2 - $var_value является массивом превышающим $var_array (поэтому он не может уместится в нём)
3 - Массив $var_array не является одномерным массивом

Примечания

Эта функция используется для непрерывного обновления данных в массиве, в противном случае создаётся огромный размер массива.
Это хранит все значения внутри массива (подобно Истории), убирая первый или последний элемент, в зависимости от направления сдвига.
Это имитирует команду push в ассемблере.

Функцию можно подключить через команду exect

См. также

_ArrayAdd, _ArrayConcatenate, _ArrayDelete, _ArrayInsert, _ArrayPop

Примеры:
 Как создать кнопку?


exect=$var_aa=StringSplit('AAA|BBB|CCC|DDD','|',2)||_ArrayDisplay($var_aa)||_ArrayPush($var_aa,'EEE')||_ArrayDisplay($var_aa)||_ArrayPush($var_aa,'FFF')||_ArrayDisplay($var_aa) ;; пример добавления нового элемента в конец массива, смещая остальные вверх

exect=$var_aa=StringSplit('AAA|BBB|CCC|DDD','|',2)||_ArrayDisplay($var_aa)||_ArrayPush($var_aa,'EEE',1)||_ArrayDisplay($var_aa)||_ArrayPush($var_aa,'FFF',1)||_ArrayDisplay($var_aa) ;; пример добавления нового элемента в начало массива, смещая остальные вниз


© Аверин Андрей для Total Commander Image  Averin-And@yandex.ru