Tree.FindByName - Revision history

Admin: 1 revision imported

2025-09-29T07:15:02Z

1 revision imported

1>Admin at 14:16, 10 June 2025

2025-06-10T14:16:11Z

Admin: 1 revision imported

2021-02-07T06:54:50Z

1 revision imported

Admin: Created page with "{{infobox function |name=FindByName |object=Дерево |caption=Функции поиска |type=1 |status=2 |db=0 |exception=Невозможно превратить..."

2020-03-18T14:07:23Z

Created page with "{{infobox function |name=FindByName |object=Дерево |caption=Функции поиска |type=1 |status=2 |db=0 |exception=Невозможно превратить..."

New page

{{infobox function
|name=FindByName
|object=[[Дерево]]
|caption=Функции поиска
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Дерево]]}}
Применимо к объектам ветки и дерева. Функция производит поиск указанной строки среди наименований дочерних веток текущего объекта (с возможностью поиска во вложенных ветках). Если ветка найдена, функция возвращает ее в виде объекта, иначе возвращается пустое значение. Поиск осуществляется без учета регистра.

== Синтаксис ==
<code>
{{Grey|Tree.}}'''FindByName'''(''<Наименование ветки для поиска (STRING)>''{{Optional|,<Включать дочерние ветки в поиск (INT)>{{Default|{{Eq}}0}}}}):''<Найденная ветка (BRANCH)>''
</code>

==== Аргументы ====
* <code>''<Наименование ветки для поиска (STRING)>''</code> - Наименование ветки, которую необходимо найти
* <code>''<Включать дочерние ветки в поиск (INT)>''</code> - {{Optional}} Режим позволяет искать по всей структуре веток, а не только среди дочерних веток текущего объекта.

==== Возвращаемое значение ====
Возвращает первую найденную ветку, которая имеет указанное наименование, либо пустое значение, если ветка не найдена.

== Примеры ==
<pre>
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 найдена среди всех веток дерева"
</pre>

← Older revision	Revision as of 07:15, 29 September 2025
(No difference)

@@ Line 17: / Line 17: @@
 == Синтаксис ==
 <code>
-{{Grey|Tree.}}'''FindByName'''(''<Наименование ветки для поиска (STRING)>''{{Optional|,<Включать дочерние ветки в поиск (INT)>{{Default|{{Eq}}0}}}}):''<Найденная ветка (BRANCH)>''
+{{Grey|Tree.}}'''FindByName'''(''<Наименование ветки для поиска (STRING)>''{{Optional|,<Включать дочерние ветки в поиск (INT)>{{Default|{{Eq}}0}},<Начинать поиск после ветки (BRANCH)>}}):''<Найденная ветка (BRANCH)>''
 </code>
@@ Line 23: / Line 23: @@
 * <code>''<Наименование ветки для поиска (STRING)>''</code> - Наименование ветки, которую необходимо найти
 * <code>''<Включать дочерние ветки в поиск (INT)>''</code> - {{Optional}} Режим позволяет искать по всей структуре веток, а не только среди дочерних веток текущего объекта.
 ==== Возвращаемое значение ====

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