List.Contains - Revision history

Admin: 1 revision imported

2025-01-22T06:54:17Z

1 revision imported

1>Admin at 08:16, 2 January 2025

2025-01-02T08:16:26Z

Admin: 1 revision imported

2023-04-25T09:30:23Z

1 revision imported

1>Admin at 16:57, 16 April 2023

2023-04-16T16:57:37Z

Admin: 1 revision imported

2021-03-04T14:55:09Z

1 revision imported

Admin at 09:47, 12 February 2021

2021-02-12T09:47:25Z

Admin: 1 revision imported

2021-02-07T06:51:40Z

1 revision imported

Admin: /* Примеры */

2020-08-12T06:37:22Z

‎Примеры

New page

{{infobox function
|name=Contains
|object=[[Список]]
|caption=Вхождение объекта в список
|type=1
|status=2
|db=2
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Список]]}}
Функция проверяет, является ли указанный элемент подмножеством списка. Проверяются только элементы[[Объект базы данных|-объекты базы данных]]. Если требуется проверить объект иного типа, нужно использовать функцию [[List.Find|'''Find''']]. Список может содержать папки и отдельные значения. При наличии папок в списке, элемент проверяется на вхождение внутрь каждой из папок. Подобный процесс может занять некотрое время, в зависимости от загруженности и готовности базы данных, поэтому, после первого обращения, функция сохраняет промежуточные результаты запроса, последующие обращения происходят без хапросов к базе данных, тем самым ускоряя выполнение, однако, возможные изменения в данных при этом не учитываются. Чтобы форсировать запрос к базе данных, используйте функцию [[List.ClearContainsCache|'''ClearContainsCache''']] перед вызовом.

== Синтаксис ==
<code>
{{Grey|List.}}'''Contains'''(''<Значение>''):''<0 или 1 (INT)>''
</code>
==== Аргументы ====
* <code>''<Значение>''</code> - Элемент-объект базы данных для проверки.
==== Возвращаемое значение ====
Возвращает 1, если объект входит в список, 0 если не входит или не является объектом базы данных.

== Примеры ==
<pre>
//Пример нельзя проверить в рабочей базе данных, как указаны конкретные коды объектов, он используется только для демонстрации
//Список содержит два объекта базы данных, один из которых является папкой.
a:=List.Create(DB("Ref.Номенклатура","Code","000000003661"),DB("Ref.Номенклатура","Code","000000007561"));
//Переменная содержит объект, родительской папкой которого является объект с кодом "000000003661"
b:=DB("Ref.Номенклатура","Code","000000003669");
//Выводит "Да"
Message(?(a.Contains(b),"Да","Нет"));
</pre>

@@ Line 23: / Line 23: @@
 * <code>''<Режим функции (INT)>''</code> - Режим поиска элементов, возможны следующие значения:
 ** '''0''' (по умолчанию) -- при первом вызове функция создает сортированный буфер, в котором содержатся внутренние коды всех элементов, входящих в подпапки всех элементов списка. Последущие вызовы уже не будут вызывать обращения к базе данных и будут проходить очень быстро. Если элементов, вошедших в запрос, очень много, первый возов может занять продолжительное время. Особенно это может стать проблемой, если во включаемых элементах присутствует большое количество папок, и СУБД не имеет возможности использования временных функций (к примеру, SQLite). Оригинальный список может содержать элементы разных справочников.
-** '''1''' -- при первом вызове функция создает сортированный буфер, в котором содержатся внутренние коды всех элементов списка и всех папок справочника, входящих в подпапки всех элементов списка. В этом режиме для проверки вхождения элемента в буфер требуется как код самого элемента, так и код папки, в которой он находится, что может создать дополнительный вызов к базе данных, если проверямый элемент не был заполнен. Плюсом такого подхода является сильное ускорение длительного первого вызова, если во включаемых элементах присутствует большое количество папок, и СУБД не имеет возможности использования временных функций (к примеру, SQLite). Оригинальный должен содержать элементы только одного справочника. Первый вызов в этом режиме может работать несколько дольше вызова в режиме 0, если в список попадает малая часть справочника с небольшим количеством папок, однако, сам справочник содержит очень много папок.
+** '''1''' -- при первом вызове функция создает сортированный буфер, в котором содержатся внутренние коды всех элементов списка и всех папок справочника, входящих в подпапки всех элементов списка. В этом режиме для проверки вхождения элемента в буфер требуется как код самого элемента, так и код папки, в которой он находится, что может создать дополнительный вызов к базе данных, если проверямый элемент не был заполнен. Плюсом такого подхода является сильное ускорение длительного первого вызова, если во включаемых элементах присутствует большое количество папок, и СУБД не имеет возможности использования временных функций (к примеру, SQLite). Оригинальный список должен содержать элементы '''только одного справочника'''. Первый вызов в этом режиме может работать несколько дольше вызова в режиме 0, если в список попадает малая часть справочника с небольшим количеством папок, однако, сам справочник содержит очень много папок, в остальных случаях он работает быстрее.
 ==== Возвращаемое значение ====
 Возвращает 1, если объект входит в список, 0 если не входит или не является объектом базы данных.

← Older revision	Revision as of 06:54, 22 January 2025
(No difference)

← Older revision	Revision as of 09:30, 25 April 2023
(No difference)

@@ Line 3: / Line 3: @@
 |object=[[Список]]
 |caption=Вхождение объекта в список
 |type=1
 |status=2
@@ Line 16: / Line 17: @@
 == Синтаксис ==
 <code>
-{{Grey|List.}}'''Contains'''(''<Значение>''):''<0 или 1 (INT)>''
+{{Grey|List.}}'''Contains'''(''<Значение>''{{Optional|,<Режим функции (INT)>{{Default|{{Eq}}0}}}}):''<0 или 1 (INT)>''
 </code>
 ==== Аргументы ====
 * <code>''<Значение>''</code> - Элемент-объект базы данных для проверки.
 ==== Возвращаемое значение ====
 Возвращает 1, если объект входит в список, 0 если не входит или не является объектом базы данных.

← Older revision	Revision as of 14:55, 4 March 2021
(No difference)

@@ Line 12: / Line 12: @@
 * [[Объекты]]
 * [[Список]]}}
-Функция проверяет, является ли указанный элемент подмножеством списка. Проверяются только элементы[[Объект базы данных|-объекты базы данных]]. Если требуется проверить объект иного типа, нужно использовать функцию [[List.Find|'''Find''']]. Список может содержать папки и отдельные значения. При наличии папок в списке, элемент проверяется на вхождение внутрь каждой из папок. Подобный процесс может занять некотрое время, в зависимости от загруженности и готовности базы данных, поэтому, после первого обращения, функция сохраняет промежуточные результаты запроса, последующие обращения происходят без хапросов к базе данных, тем самым ускоряя выполнение, однако, возможные изменения в данных при этом не учитываются. Чтобы форсировать запрос к базе данных, используйте функцию [[List.ClearContainsCache|'''ClearContainsCache''']] перед вызовом.
+Функция проверяет, является ли указанный элемент подмножеством списка. Проверяются только элементы[[Объект базы данных|-объекты базы данных]]. Если требуется проверить объект иного типа, нужно использовать функцию [[List.Find|'''Find''']]. Список может содержать папки и отдельные значения. При наличии папок в списке, элемент проверяется на вхождение внутрь каждой из папок. Подобный процесс может занять некотрое время, в зависимости от загруженности и готовности базы данных, поэтому, после первого обращения, функция сохраняет промежуточные результаты запроса, последующие обращения происходят без запросов к базе данных, тем самым ускоряя выполнение, однако, возможные изменения в данных при этом не учитываются. Чтобы форсировать запрос к базе данных, используйте функцию [[List.ClearContainsCache|'''ClearContainsCache''']] перед вызовом.
 == Синтаксис ==

← Older revision	Revision as of 06:51, 7 February 2021
(No difference)