Различия

Здесь показаны различия между двумя версиями данной страницы.

--- help:arrays [2024/10/14 10:39]
aleks_versus
+++ help:arrays [2025/09/28 06:39] (текущий)
aleks_versus [Многомерные массивы]
@@ Строка 50: / Строка 50: @@
   * написать имя массива
   * затем без пробелов, не отступая от имени массива, в квадратных скобках написать номер ячейки, в которую хотим поместить значение
-  * затем поставить знак ''%%=%%'' (операция присваивания)
+  * затем поставить знак ''**=**'' (операция присваивания)
   * и уже после знака равно написать нужное значение.
@@ Строка 86: / Строка 86: @@
 То же самое и в случае, когда мы хотим получить значение из ячейки массива: если мы хотим получить строковое значение, нужно поставить символ ''%%$%%'' перед именем массива.
-И точно так же это работает для числовых значений и кортежей: - Если нам нужно присвоить ячейке массива, или получить из неё, числовое значение, никаких символов мы перед именем массива не ставим (без префикса типа). - Если нам нужно присвоить ячейке массива, или получить из неё, кортеж, ставим символ ''%'' перед именем массива (указываем префикс типа).
+И точно так же это работает для числовых значений и кортежей:
+  * Если нам нужно присвоить ячейке массива, или получить из неё, числовое значение, никаких символов мы перед именем массива не ставим (без префикса типа).
+  * Если нам нужно присвоить ячейке массива, или получить из неё, кортеж, ставим символ ''%'' перед именем массива (указываем префикс типа).
 Примеры:
@@ Строка 175: / Строка 177: @@
   * Плеер создаёт новую ячейку с новым числовым индексом, следующим по порядку. Например, если в массиве уже были созданы три ячейки, создаётся ячейка с числовым индексом ''%%3%%''.
-  * Затем плеер "прикрепляет" указанный строковый индекс к числовому.
+  * Затем плеер "прикрепляет" указанный строковый индекс к этой ячейке.
 Поэтому, если вы создаёте ячейку со строковым индексом, вы можете получать из неё значения в том числе и по числовому индексу:
@@ Строка 233: / Строка 235: @@
   * Плеер создаёт новую ячейку с новым **числовым** индексом, следующим по порядку. Например, если в массиве уже были созданы семь ячеек, создаётся ячейка с числовым индексом ''%%7%%''.
-  * Затем плеер "прикрепляет" указанный многомерный индекс к числовому.
+  * Затем плеер "прикрепляет" указанный многомерный индекс к ячейке.
 Поэтому, если вы создаёте ячейку с многомерным индексом, вы можете получать из неё значения в том числе и по числовому индексу:
@@ Строка 253: / Строка 255: @@
 %coords = [120, 450, -37]
 $map[%coords] = 'Alien'
-</sxh> - Запись с дополнительным набором скобок эквивалентна записи с одним набором скобок при указании индекса ячейки массива: <sxh qsp>
+</sxh>
+  * Запись с дополнительным набором скобок эквивалентна записи с одним набором скобок при указании индекса ячейки массива: <sxh qsp>
 $array[1, 2, 137]
 ! эквивалентно
@@ Строка 300: / Строка 303: @@
 ===== Функции и операторы для работы с массивами =====
-  * ''%%KILLVAR [$имя_массива], [индекс_элемента]%%'' - удаление элемента с индексом ''%%[индекс_элемента]%%'' из массива с названием ''%%[$имя_массива]%%''. Название массива всегда нужно писать в кавычках. Пример: <sxh qsp>
+  * ''**KILLVAR** [$имя_массива], [индекс_элемента]'' - удаление элемента с индексом ''%%[индекс_элемента]%%'' из массива с названием ''%%[$имя_массива]%%''. Название массива всегда нужно писать в кавычках. Пример: <sxh qsp>
 ! удаление по числовому индексу
 killvar 'яблоко',3
@@ Строка 327: / Строка 330: @@
 a[2]=15
 </sxh>
-  * ''%%KILLALL%%'' - оператор эквивалентен конструкции "''%%KILLVAR & KILLOBJ%%''", то есть удаляет все переменные/массивы в игре, а так же очищает Окно предметов. Обычно применяется в начале игры, чтобы при возврате в начальную локацию после неудачного прохождения какого-то этапа игры обнулить все переменные (в противном случае, может оказаться, что запертые двери уже открыты, жена похищена до свадьбы, а Баба-Яга уже отдала кому-то нужный клубочек).
+  * ''**KILLALL**'' - оператор эквивалентен конструкции "''%%KILLVAR & KILLOBJ%%''", то есть удаляет все переменные/массивы в игре, а так же очищает Окно предметов. Обычно применяется в начале игры, чтобы при возврате в начальную локацию после неудачного прохождения какого-то этапа игры обнулить все переменные (в противном случае, может оказаться, что запертые двери уже открыты, жена похищена до свадьбы, а Баба-Яга уже отдала кому-то нужный клубочек).
-  * ''%%COPYARR [$приёмник],[$источник],[#начало],[#количество]%%'' - копирование в массив-приёмник ''%%[#количество]%%'' элементов из массива-источника начиная с элемента под номером ''%%[#начало]%%''. Размер массива-приёмника при копировании не имеет значения.
+  * ''**COPYARR** [$приёмник],[$источник],[#начало],[#количество]'' - копирование в массив-приёмник ''%%[#количество]%%'' элементов из массива-источника начиная с элемента под номером ''%%[#начало]%%''. Размер массива-приёмника при копировании не имеет значения.
     * Параметр ''%%[#количество]%%'' является необязательным. По умолчанию - до конца массива-источника.
     * Параметр ''%%[#начало]%%'' является необязательным. По умолчанию - ''%%0%%''.
@@ Строка 339: / Строка 342: @@
 COPYARR 'a<<$arrname1>>','a<<$arrname2>>'
 </sxh>
-  * ''%%SORTARR [$имя_массива], [#порядок]%%'' — Данный оператор сортирует указанный массив. Параметр ''%%[#порядок]%%'' опционален. Если не указан или равен 0, то сортирует массив по возрастанию (от меньшего к большему). Если равен 1, то сортирует массив по убыванию (от большего к меньшему).
+  * ''**SORTARR** [$имя_массива], [#порядок]'' — Данный оператор сортирует указанный массив. Параметр ''%%[#порядок]%%'' опционален. Если не указан или равен 0, то сортирует массив по возрастанию (от меньшего к большему). Если равен 1, то сортирует массив по убыванию (от большего к меньшему).
     * Может сортировать массивы любых типов (числа, строки, кортежи), но не допускается смешивать значения разных типов в одном массиве.
     * Для указания типа сортируемых значений нужно указать префикс типа как часть имени массива (''%%$%%'', ''%'').
@@ Строка 352: / Строка 355: @@
 end
 </sxh>
-  * ''%%SCANSTR [$имя_массива], [$текст_для_разбора], [$регэксп], [#номер_группы]%%'' — в массив ''%%[$имя_массива]%%'' помещаются строки, соответствующие [[help:regexp|регулярному выражению]] ''%%[$регэксп]%%'', которые будут найдены в строке ''%%[$текст_для_разбора]%%''. Если указан параметр ''%%[#номер_группы]%%'', в массив будет помещаться не вся строка, соответствующая регулярному выражению, а лишь часть, соответствующая указанной группе в этом регулярном выражении. Примеры: <sxh qsp>
+  * ''**SCANSTR** [$имя_массива], [$текст_для_разбора], [$регэксп], [#номер_группы]'' — в массив ''%%[$имя_массива]%%'' помещаются строки, соответствующие [[help:regexp|регулярному выражению]] ''%%[$регэксп]%%'', которые будут найдены в строке ''%%[$текст_для_разбора]%%''. Если указан параметр ''%%[#номер_группы]%%'', в массив будет помещаться не вся строка, соответствующая регулярному выражению, а лишь часть, соответствующая указанной группе в этом регулярном выражении. Примеры: <sxh qsp>
 ! вытаскиваем из строки все слова:
 $text = 'Шла Саша по шоссе, а Грека через реку.'
@@ Строка 368: / Строка 371: @@
 !В массиве $words окажутся значения: 'first', 'second', 'third'
 </sxh>
-  * ''%%ARRSIZE([$имя_массива])%%'' - функция возвращает число элементов массива с названием ''%%[$имя_массива]%%''.
+  * ''**ARRITEM(**[$имя_массива],[индекс_элемента]**)**'' — возвращает значение элемента массива с названием ''%%[$имя_массива]%%'' по указанному индексу. То есть функция извлекает значение из указанной ячейки массива. Примеры: <sxh qsp>
-    * Не имеет значения, указываете ли вы ''%%$%%'' или ''%%%%%'' перед названием массива или нет. Подсчитывается общее число ячеек и со значениями любых типов.
-    * Примеры: <sxh qsp>
-n = ARRSIZE('a')
-n = ARRSIZE('$a')
-!Результат будет одинаковый
-</sxh>
-  * ''%%ARRITEM([$имя_массива],[индекс_элемента])%%'' — возвращает значение элемента массива с названием ''%%[$имя_массива]%%'' по указанному индексу. То есть функция извлекает значение из указанной ячейки массива. Примеры: <sxh qsp>
 ! выводим значение элемента с индексом 3
 *pl $arritem('$mass', 3)
@@ Строка 398: / Строка 394: @@
 end
 </sxh>
-  * ''%%ARRPOS([$имя_массива],[значение],[#начало])%%'' - возвращает номер элемента массива с названием ''%%[$имя_массива]%%'', равного значению ''%%[значение]%%''. Поиск начинается с элемента под номером ''%%[#начало]%%''; индексация элементов массива ведётся с нуля. Если указанное значение не найдено, функция возвращает ''%%-1%%''.<
+  * ''**SETVAR** [$имя_массива], [значение], [индекс]'' — устанавливает значение элемента массива с названием ''%%[$имя_массива]%%'' по указанному индексу. То есть оператор присваивает значение указанной ячейке массива. Префикс имени переменной указывает тип значения, которое нужно записать в элемент массива (как с обычными присваиваниями). Параметр ''[индекс]'' опционален. Если этот параметр не указан, то значение присваивается 0-му элементу. Значение и индекс могут быть любых типов. Примеры: <sxh qsp>
-    * Параметр ''%%[#начало]%%'' может отсутствовать, при этом он принимается равным ''%%0%%''.
+SETVAR 'A', 65
+SETVAR '$X', 'name', 4
+SETVAR '$X', 'name', 'string index'
+SETVAR '%Q', ['пример', 'кортежа'], 3
+SETVAR '%Q', ['пример', 'кортежа'], [x, y]
+</sxh> Данный оператор дополняет функцию ''**ARRITEM**'' и позволяет избегать использования ''DYNAMIC'' в некоторых случаях.
+  * ''**ARRSIZE(**[$имя_массива]**)**'' - функция возвращает число элементов массива с названием ''%%[$имя_массива]%%''.
+    * Не имеет значения, указываете ли вы ''%%$%%'' или ''%%%%%'' перед названием массива или нет. Подсчитывается общее число ячеек и со значениями любых типов.
     * Примеры: <sxh qsp>
-!Поиск строки 'This' в текстовом массиве "$A"
+n = ARRSIZE('a')
-ARRPOS('$A','This',0)
+n = ARRSIZE('$a')
-!Поиск числа 65 в массиве "A" (первые два элемента массива игнорируются)
+!Результат будет одинаковый
-ARRPOS('A',65,2)
-!Поиск строки 'test' среди значений массива "$B"
-ARRPOS('$B','test')
 </sxh>
-    * Функция возвращает только числовой индекс элемента. Строковый или многомерный индекс с помощью данной функции получить нельзя.
+  * ''**ARRTYPE(**[$имя_переменной], [индекс]**)**'' - получает тип значения, которое хранится в массиве ''%%[$имя_переменной]%%'' под индексом ''[индекс]''.
-  * ''%%MAX([выр1],[выр2], …)%%'' - возвращает максимальное из значений выражений-аргументов. Если передан один аргумент, то считается, что указано имя массива: <sxh qsp>
+    * Параметр ''%%[индекс]%%'' может отсутствовать, при этом он принимается равным ''0''. То есть вычисляется тип значения переменной/нулевой ячейки массива. Индекс может быть любого типа.
+    * Функция возвращает одно из следующих значений в зависимости от типа:
+      * ''%%''%%'' (пустая строка) - элемент массива не задан.
+      * ''%%'#'%%'' - элемент содержит число.
+      * ''%%'$'%%'' - элемент содержит строку.
+      * ''%%'%'%%'' - элемент содержит кортеж.
+    * Пример: <sxh qsp>
+$ddd = 'text'
+$arrtype('ddd') & ! '$'
+$g = 'text' & g = 13
+$arrtype('g') & ! '#'
+%tuple['index'] = [12, 'string']
+$arrtype('tuple', 'index') & ! '%'
+! $empty not exist
+$arrtype('$empty') & ! ''
+</sxh>
+  * ''**ARRPOS(**[$имя_массива], [значение], [#старт]**)**'' — возвращает индекс элемента массива равного указанному значению.
+    * Поиск начинается с элемента с заданным номером ''[#старт]''.
+    * Индексация элементов массива ведётся с нуля.
+    * Если указанное значение не найдено, функция возвращает -1.
+    * Пример: <sxh qsp>
+$color[0] = 'красный'
+$color[1] = 'жёлтый'
+$color[2] = 'зелёный'
+$color[3] = 'синий'
+$color[4] = 'жёлтый'
+arrpos('$color', 'жёлтый') & ! вернёт значение 1
+arrpos('$color', 'жёлтый', 2) & ! вернёт значение 4
+arrpos('$color','голубой') & ! вернёт значение -1
+</sxh>
+    * Другие примеры: <sxh qsp>
+! поиск строки 'this' в текстовом массиве "$a"
+arrpos('$a', 'this', 0)
+! поиск числа 65 в массиве "a" (два элемента массива игнорируются)
+arrpos('a', 65, 2)
+! поиск строки 'test' среди значений массива "$b"
+arrpos('$b', 'test')
+</sxh>
+    * Можно искать значения любого типа, однако:
+      * если вы ищете среди текстовых значений массива, нужно указывать префикс типа ''$'' перед названием массива;
+      * если вы ищете среди кортежей в массиве, нужно указывать префикс типа ''%''.
+      * Пример: <sxh qsp>
+$a[0] = '12'
+a[1] = 12
+%a[2] = [12]
+%a[3] = ['12']
+arrpos('$a', 12)     &  ! 0
+arrpos('a', 12)      &  ! 1
+arrpos('%a', 12)     &  ! 2
+arrpos('%a', '12')   &  ! 2 <---
+arrpos('%a', [12])   &  ! 2
+arrpos('%a', ['12']) &  ! 2 <---
+</sxh>
+  * ''**MAX(**[выр1],[выр2], …**)**'' - возвращает максимальное из значений выражений-аргументов. Если передан один аргумент, то считается, что указано имя массива: <sxh qsp>
 MAX('a') &! вернёт максимальное из числовых значений элементов массива "a"
 MAX('$b') &! вернёт максимальное из текстовых значений элементов массива "$b"
 MAX('%d') &! вернёт максимальный из кортежей в массиве '%d'
 </sxh>
-  * ''%%MIN([выр1],[выр2], …)%%'' - возвращает минимальное из значений выражений-аргументов. Если передан один аргумент, то считается, что указано имя массива: <sxh qsp>
+  * ''**MIN(**[выр1],[выр2], …**)**'' - возвращает минимальное из значений выражений-аргументов. Если передан один аргумент, то считается, что указано имя массива: <sxh qsp>
 MIN('a') &! вернёт минимальное из числовых значений элементов массива "a"
 MIN('$b') &! вернёт минимальное из текстовых значений элементов массива "$b"
 MIN('%d') &! вернёт минимальный из кортежей в массиве '%d'
 </sxh>
-  * ''%%ARRCOMP([$имя_массива],[$шаблон],[#начало])%%'' - возвращает номер элемента массива ''%%[$имя_массива]%%'', соответствующего регулярному выражению ''%%[$шаблон]%%''. Поиск начинается с элемента с номером ''%%[#начало]%%''; индексация элементов массива ведётся с нуля. Если указанное значение не найдено, функция возвращает ''%%-1%%''.<
+  * ''**ARRCOMP(**[$имя_массива],[$шаблон],[#начало]**)**'' - возвращает номер элемента массива ''%%[$имя_массива]%%'', соответствующего регулярному выражению ''%%[$шаблон]%%''. Поиск начинается с элемента с номером ''%%[#начало]%%''; индексация элементов массива ведётся с нуля. Если указанное значение не найдено, функция возвращает ''%%-1%%''.
     * Поиск работает только по текстовым массивам (символ ''%%$%%'' в названии массива можно опустить).
     * Параметр ''%%[#начало]%%'' может отсутствовать, при этом он принимается равным ''%%0%%''.
@@ Строка 434: / Строка 491: @@
 </sxh>
     * Функция возвращает только числовой индекс элемента. Строковый или многомерный индекс с помощью данной функции получить нельзя.
+Так же см. ARRPACK и UNPACKARR в разделе [[help:tuples|"Кортежи"]]
 [[help:strings|Вперёд: Строки]]

Документация QSPСайтФорум

Инструменты пользователя

Инструменты сайта

Различия

Инструменты страницы

Документация QSP
Сайт Форум