Admin: 1 revision imported

2026-04-01T09:59:05Z

1 revision imported

1>Admin: Created page with "{{infobox function |name=GlobalStringsAdd |object=Функции общего назначения |caption=Глобальные строки-массивы |type=1 |statu..."

2025-12-28T09:09:10Z

Created page with "{{infobox function |name=GlobalStringsAdd |object=Функции общего назначения |caption=Глобальные строки-массивы |type=1 |statu..."

New page

{{infobox function
|name=GlobalStringsAdd
|object=[[Функции общего назначения]]
|caption=Глобальные строки-массивы
|type=1
|status=2
|db=0
|exception=Неверные агрументы, системная ошибка сервера, не найден массив.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция выполняет поиск произвольного количества строк, заданных в списке или в одной строке с разделителями, в массиве по его наименованию или идентификатору. Режим функции задает условие поиска, а также формат ответа (последний может быть как числовым, так и в виде списка).
== Синтаксис ==
<code>
'''GlobalStringsFind'''(''<Имя или идентификатор массива (STRING,INT)>'',''<Значения (STRING,LIST)>''{{Optional|,''<Режим (INT)>''{{Default|{{Eq}}0}}}}):''<Статус или результат (INT,LIST)>''
</code>
==== Аргументы ====
* <code>''<Имя или идентификатор массива (STRING,INT)>''</code> - Параметр задает имя массива (строка) или идентификатор массива (число) для поиска значений.
* <code>''<Значения (STRING,LIST)>''</code> - Значения для поиска могут быть в списке или в строке. Каждое значение может содержать префикс, отделенный от основной строки разделителем префикса (см. [[GlobalStringsHeapsAdd]]). Если аргумент строка, каждое значение (с префиксом) должно быть разделено разделителем значений (см. [[GlobalStringsHeapsAdd]]).
* <code>''<Режим (INT)>''</code> - {{Optional}} Аргумент задает режим поиска и является битовой маской. На данный момент доступны следующие биты:
** '''бит 0''' -- если установлен, функция возвращает список уже найденных в массиве значений, иначе статус будет числом (см. ниже).
** '''бит 3''' -- если установлен (и не установлен бит 0), функция возвращает только 0 (все значения найдены) или 1 (некоторые значения найдены). Вместо статуса 2 (все значения найдены) также возвращается число 1, что позволяет выполнить операцию немного быстрее.
==== Возвращаемое значение ====
Если бит 0 аргумента режима сброшен (по умолчанию), возвращает следующее числовое значение: '''0''' -- все значения были найдены в массиве, '''1''' -- некоторые значения были найдены в массиве, '''2''' -- все значения были найдены в массиве. Если бит 0 аргумента режима установлен, функция возвращает список найденных значений.

== Примеры ==
<pre>
//СтрКоды -- значения для поиска дублей
//СпМассивыМарок -- список массивов, где производится поиск дублей
СпДубли:=List.Create();
For i:=1 To СпМассивыМарок.Size() Do
Try
//Возвратить список и добавить его содержимое к списку СпДубли
GlobalStringsFind(СпМассивыМарок[i],СтрКоды,1).CopyTo(СпДубли);
Except
//Возможно, один из старых массивов был удален до этой операции другим пользователем
EndTry;
EndDo;
//СпДубли -- список найденных дублей для вывода
</pre>

← Older revision	Revision as of 09:59, 1 April 2026
(No difference)

GlobalStringsFind - Revision history

Admin: 1 revision imported

1>Admin: Created page with "{{infobox function |name=GlobalStringsAdd |object=Функции общего назначения |caption=Глобальные строки-массивы |type=1 |statu..."