Difference between revisions of "Tree.Find"
(Created page with "{{infobox function |name=Find |object=Дерево |caption=Функции поиска |type=1 |status=2 |db=0 |exception=Невозможно превратить в ч...") |
m (1 revision imported) |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 17: | Line 17: | ||
== Синтаксис == | == Синтаксис == | ||
<code> | <code> | ||
| − | {{Grey|Tree.}}'''Find'''(''<Объект для поиска>''{{Optional|,<Включать дочерние ветки в поиск (INT)>{{Default|{{Eq}}0}}}}):''<Найденная ветка (BRANCH)>'' | + | {{Grey|Tree.}}'''Find'''(''<Объект для поиска>''{{Optional|,<Включать дочерние ветки в поиск (INT)>{{Default|{{Eq}}0}},<Начинать поиск после ветки (BRANCH)>}}):''<Найденная ветка (BRANCH)>'' |
</code> | </code> | ||
| Line 23: | Line 23: | ||
* <code>''<Объект для поиска>''</code> - Аргумент задает объект, который необходимо найти. | * <code>''<Объект для поиска>''</code> - Аргумент задает объект, который необходимо найти. | ||
* <code>''<Включать дочерние ветки в поиск (INT)>''</code> - {{Optional}} Режим позволяет искать по всей структуре веток, а не только среди дочерних веток текущего объекта. | * <code>''<Включать дочерние ветки в поиск (INT)>''</code> - {{Optional}} Режим позволяет искать по всей структуре веток, а не только среди дочерних веток текущего объекта. | ||
| + | * <code>''<Начинать поиск после ветки (BRANCH)>''</code> - {{Optional}} Если аргумент указан, поиск продолжается после указанной ветки (чтобы найти следующую ветку после найденной ранее предыдущей). | ||
==== Возвращаемое значение ==== | ==== Возвращаемое значение ==== | ||
Latest revision as of 08:15, 29 September 2025
| Find (Функции поиска) | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||
Применимо к объектам ветки и дерева. Функция производит поиск указанного объекта среди значений дочерних веток текущего объекта (с возможностью поиска во вложенных ветках). Если ветка найдена, функция возвращает ее в виде объекта, иначе возвращается пустое значение.
Синтаксис
Tree.Find(<Объект для поиска>,<Включать дочерние ветки в поиск (INT)>=0,<Начинать поиск после ветки (BRANCH)>):<Найденная ветка (BRANCH)>
Аргументы
<Объект для поиска>- Аргумент задает объект, который необходимо найти.<Включать дочерние ветки в поиск (INT)>- (необязательный аргумент) Режим позволяет искать по всей структуре веток, а не только среди дочерних веток текущего объекта.<Начинать поиск после ветки (BRANCH)>- (необязательный аргумент) Если аргумент указан, поиск продолжается после указанной ветки (чтобы найти следующую ветку после найденной ранее предыдущей).
Возвращаемое значение
Возвращает первую найденную ветку, которая содержит объект поиска, либо пустое значение, если ветка не найдена.
Примеры
aTree:=Tree.Create();
aBranch1:=aTree.Add(1,"Ветка 1");
aBranch1.Add(2,"Ветка 1.1");
aTree.Add(3,"Ветка 2");
aTree.Insert(1,0,"Ветка 0");
Message("Значение 2 "+?(isEmpty(aTree.Find(2)),"не ")+"найдено среди верхних веток дерева");
Message("Значение 2 "+?(isEmpty(aTree.Find(2,1)),"не ")+"найдено среди всех веток дерева");
//Пример выведет:
//"Значение 2 не найдено среди верхних веток дерева"
//"Значение 2 найдено среди всех веток дерева"
