Difference between revisions of "Tree.FindByName"
m (1 revision imported) |
m (1 revision imported) |
||
| (One intermediate revision by one other user not shown) | |||
| Line 17: | Line 17: | ||
== Синтаксис == | == Синтаксис == | ||
<code> | <code> | ||
| − | {{Grey|Tree.}}'''FindByName'''(''<Наименование ветки для поиска (STRING)>''{{Optional|,<Включать дочерние ветки в поиск (INT)>{{Default|{{Eq}}0}}}}):''<Найденная ветка (BRANCH)>'' | + | {{Grey|Tree.}}'''FindByName'''(''<Наименование ветки для поиска (STRING)>''{{Optional|,<Включать дочерние ветки в поиск (INT)>{{Default|{{Eq}}0}},<Начинать поиск после ветки (BRANCH)>}}):''<Найденная ветка (BRANCH)>'' |
</code> | </code> | ||
| Line 23: | Line 23: | ||
* <code>''<Наименование ветки для поиска (STRING)>''</code> - Наименование ветки, которую необходимо найти | * <code>''<Наименование ветки для поиска (STRING)>''</code> - Наименование ветки, которую необходимо найти | ||
* <code>''<Включать дочерние ветки в поиск (INT)>''</code> - {{Optional}} Режим позволяет искать по всей структуре веток, а не только среди дочерних веток текущего объекта. | * <code>''<Включать дочерние ветки в поиск (INT)>''</code> - {{Optional}} Режим позволяет искать по всей структуре веток, а не только среди дочерних веток текущего объекта. | ||
| + | * <code>''<Начинать поиск после ветки (BRANCH)>''</code> - {{Optional}} Если аргумент указан, поиск продолжается после указанной ветки (чтобы найти следующую ветку после найденной ранее предыдущей). | ||
==== Возвращаемое значение ==== | ==== Возвращаемое значение ==== | ||
Latest revision as of 08:15, 29 September 2025
| FindByName (Функции поиска) | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||
Применимо к объектам ветки и дерева. Функция производит поиск указанной строки среди наименований дочерних веток текущего объекта (с возможностью поиска во вложенных ветках). Если ветка найдена, функция возвращает ее в виде объекта, иначе возвращается пустое значение. Поиск осуществляется без учета регистра.
Синтаксис
Tree.FindByName(<Наименование ветки для поиска (STRING)>,<Включать дочерние ветки в поиск (INT)>=0,<Начинать поиск после ветки (BRANCH)>):<Найденная ветка (BRANCH)>
Аргументы
<Наименование ветки для поиска (STRING)>- Наименование ветки, которую необходимо найти<Включать дочерние ветки в поиск (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("Ветка с наименованием Ветка 1.1 "+?(isEmpty(aTree.Find(2)),"не ")+"найдена среди верхних веток дерева");
Message("Ветка с наименованием Ветка 1.1 "+?(isEmpty(aTree.Find(2,1)),"не ")+"найдена среди всех веток дерева");
//Пример выведет:
//"Ветка с наименованием Ветка 1.1 не найдена среди верхних веток дерева"
//"Ветка с наименованием Ветка 1.1 найдена среди всех веток дерева"
