152 lines
9.9 KiB
HTML
152 lines
9.9 KiB
HTML
<!DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN>
|
||
<html>
|
||
<head>
|
||
<title>array</title>
|
||
</head>
|
||
<body>
|
||
<h1>array</h1>
|
||
|
||
<pre>
|
||
<strong>array</strong> <em>option</em> <em>arrayName</em> ?<em>arg</em> <em>arg</em>...?
|
||
<a href=#anymore><strong>array</strong> <strong>anymore</strong></a> <em>arrayName</em> <em>searchId</em>
|
||
<a href=#donesearch><strong>array</strong> <strong>donesearch</strong></a> <em>arrayName</em> <em>searchId</em>
|
||
<a href=#exists><strong>array</strong> <strong>exists</strong></a> <em>arrayName</em>
|
||
<a href=#get><strong>array</strong> <strong>get</strong></a> <em>arrayName</em> ?<em>pattern</em>?
|
||
<a href=#names><strong>array</strong> <strong>names</strong></a> <em>arrayName</em> ?<em>pattern</em>?
|
||
<a href=#nextelement><strong>array</strong> <strong>nextelement</strong></a> <em>arrayName</em> <em>searchId</em>
|
||
<a href=#set><strong>array</strong> <strong>set</strong></a> <em>arrayName</em> <em>list</em>
|
||
<a href=#size><strong>array</strong> <strong>size</strong></a> <em>arrayName</em>
|
||
<a href=#startsearch><strong>array</strong> <strong>startsearch</strong></a> <em>arrayName</em>
|
||
</pre>
|
||
|
||
<h2>ОПИСАНИЕ</h2>
|
||
|
||
<p> Эта команда предназначена для выполнения перечисленных ниже
|
||
операций с массивами. Если иное не оговорено специально,
|
||
<em>arrayName</em> должно быть именем существующего массива.
|
||
Аргумент <em>option</em> определяет конкретную операцию. Для
|
||
команды определены перечисленные ниже опции.</p>
|
||
<dl>
|
||
<dt><a name=anymore></a><strong>array</strong> <strong>anymore</strong>
|
||
<em>arrayName</em> <em>searchId</em></dt>
|
||
|
||
<dd> Возвращает <strong>1</strong> если при выполнении команды поиска (см.
|
||
ниже) остались невыбранные элементы массива, и <strong>0</strong> в
|
||
противном случае. <em>SearchId</em> указывает операцию поиска,
|
||
информация о которой запрашивается (величина <em> searchId</em>
|
||
возвращается при выполнении команды <a
|
||
href=#startsearch><strong>array</strong> <strong>startsearch</strong></a>). Эта
|
||
опция особенно удобна, если массив содержит элемент с пустым
|
||
именем, поскольку команда <a href=#nextelement><strong>array</strong>
|
||
<strong>nextelement</strong></a> не позволяет в таком случае определить,
|
||
закончен ли поиск.
|
||
</dd>
|
||
|
||
<dt><a name=donesearch></a><strong>array</strong>
|
||
<strong>donesearch</strong> <em>arrayName</em> <em>searchId</em></dt>
|
||
|
||
<dd> Команда прерывает поиск элементов массива и удаляет всю
|
||
связанную с поиском информацию. <em>SearchId</em> указывает
|
||
операцию поиска, информация о которой удаляется (величина
|
||
<em>searchId</em> возвращается при выполнении команды <a
|
||
href=#startsearch><strong>array</strong>
|
||
<strong>startsearch</strong></a>). Команда возвращает пустую строку.
|
||
</dd>
|
||
|
||
<dt><a name=exists></a><strong>array</strong> <strong>exists</strong>
|
||
<em>arrayName</em> </dt>
|
||
|
||
<dd> Возвращает <strong>1</strong>, если <em>arrayName</em> есть имя
|
||
массива, и <strong>0</strong>, если такой переменной не существует
|
||
или она является скалярной переменной.
|
||
</dd>
|
||
|
||
<dt><a name=get></a><strong>array</strong> <strong>get</strong>
|
||
<em>arrayName</em> ?<em>pattern</em>?</dt>
|
||
|
||
<dd> Возвращает список, содержащий пары элементов. Первый
|
||
элемент пары - имя элемента массива <em>arrayName</em>, второй
|
||
элемент пары - значение этого элемента. Порядок пар не
|
||
определен. Если шаблон не задан, то все элементы массива будут
|
||
включены в результат. Если шаблон задан, то в результат будут
|
||
включены только те элементы, чьи имена соответствуют шаблону
|
||
(используя те же правила, что и в команде <a
|
||
href=glob.html><strong>glob</strong></a>). Если <em>arrayName</em>
|
||
не является переменной массива или массив не содержит
|
||
элементов, то возвращается пустой список.
|
||
</dd>
|
||
|
||
<dt><a name=names></a><strong>array</strong> <strong>names</strong>
|
||
<em>arrayName</em> ?<em>pattern</em>? </dt>
|
||
|
||
<dd> Возвращает список, содержащий имена всех элементов массива,
|
||
соответствующих шаблону (используя те же правила, что и в
|
||
команде <a href=glob.html><strong>glob</strong></a>). Если шаблона
|
||
нет, то команда возвращает имена всех элементов массива. Если
|
||
в массиве нет элементов, соответствующих шаблону или
|
||
<em>arrayName</em> не является именем переменной массива, то
|
||
возвращается пустая строка.
|
||
</dd>
|
||
|
||
<dt><a name=nextelement></a><strong>array</strong>
|
||
<strong>nextelement</strong> <em>arrayName</em> <em>searchId</em></dt>
|
||
|
||
<dd> Возвращает имя следующего элемента массива
|
||
<em>arrayName</em>, или пустую строку, если все элементы массива
|
||
уже возвращены. <em>SearchId</em> указывает операцию поиска,
|
||
(величина <em>searchId</em> возвращается при выполнении команды
|
||
<a href=#startsearch><strong>array</strong>
|
||
<strong>startsearch</strong></a>). Предупреждение: если в массив внесен
|
||
новый элемент или из массива удален один из элементов, то все
|
||
операции поиска в этом массиве автоматически заканчиваются,
|
||
как если бы была выполнена команда <a
|
||
href=#donesearch><strong>array</strong> <strong>donesearch</strong></a>.
|
||
Соответственно, попытка выполнить после этого команду array
|
||
nextelement приведет к ошибке.
|
||
</dd>
|
||
|
||
<dt><a name=set></a><strong>array</strong> <strong>set</strong>
|
||
<em>arrayName</em> <em>list</em> </dt>
|
||
|
||
<dd> Устанавливает значение одного или нескольких элементов
|
||
массива <em>arrayName</em>. Список <em>list</em> должен иметь
|
||
такую же структуру, как список, возвращаемый командой <a
|
||
href=#get><strong>array</strong> <strong>get</strong></a>, то есть
|
||
состоять из четного числа элементов. Все нечетные элементы
|
||
списка рассматриваются как имена элементов массива
|
||
<em>arrayName</em>, а следующие за ними четные элементы - как новые
|
||
значения соответствующих элементов.
|
||
</dd>
|
||
|
||
<dt><a name=size></a><strong>array</strong> <strong>size</strong>
|
||
<em>arrayName</em> </dt>
|
||
|
||
<dd> Возвращает строку, содержащую десятичное число, равное
|
||
количеству элементов указанного массива. Если
|
||
<em>arrayName</em> не является именем массива, возвращается
|
||
<strong>0</strong>.
|
||
</dd>
|
||
|
||
<dt><a name=startsearch></a><strong>array</strong>
|
||
<strong>startsearch</strong> <em>arrayName</em></dt>
|
||
|
||
<dd> Эта команда инициализирует процесс поиска элементов
|
||
указанного массива. После этого имя каждого следующего
|
||
элемента массива можно получить с помощью команды <a
|
||
href=#nextelement><strong>array</strong> <strong>nextelement</strong></a>. По
|
||
завершении поиска необходимо выполнить команду <a
|
||
href=#donesearch> <strong>array</strong>
|
||
<strong>donesearch</strong></a>. Команда <a href=
|
||
#startsearch><strong>array</strong> <strong>startsearch</strong></a> возвращает
|
||
идентификатор процесса поиска, который должен использоваться в
|
||
командах <a href=#nextelement><strong>array</strong>
|
||
<strong>nextelement</strong></a> и <a href=#donesearch><strong>array</strong>
|
||
<strong>donesearch</strong></a>. Благодаря этому механизму возможно
|
||
проведение нескольких процессов поиска элементов одного и того
|
||
же массива одновременно.
|
||
</dd>
|
||
</dl>
|
||
</body>
|
||
</html>
|
||
|