Admin: 1 revision imported

2025-06-09T11:15:12Z

1 revision imported

1>Admin at 17:15, 27 March 2025

2025-03-27T17:15:39Z

New page

{{infobox function
|name=SubPath
|object=[[Объект XML]]
|caption=Позиционирование внутри текущего пути
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число, путь не найден.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект XML]]}}
Функция используется совместно с объектом XML или объектом ветки XML и находит указанный путь для дочерних веток текущей. Путь записывается в виде последовательности наименований веток с возможным дополнительным номером, указывающим на индекс ветки среди веток текущего уровня с таким же наименованием, также принимается знак ".", позволяющая перейти на родительский уровень, относительно текущего: <code><Ветка1>{[<Индекс1>]}{.}{<Ветка2>...}</code> (к примеру <code>..<Setup><Options><Option>[2]</code>). Функция возвращает объект ветки, позиционированный на ветке в конце создаваемого пути, если путь существует, иначе возвращается пустое значение.

== Синтаксис ==
<code>
{{Grey|XML.}}'''SubPath'''(''<Путь XML относительный к текущему объекту (STRING)>''):''<Объект найденной ветки (XMLBRANCH)>''
</code>

==== Аргументы ====
* <code>''<Путь XML относительный к текущему объекту (STRING)>''</code> - Аргумент задает путь для создания. Возможно использование индексов или специального знака ".".

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

== Примеры ==
<pre>
aObject:=XML.create();
Стр:=aObject.LoadFromFile("c:\file.xml",65001);
If not IsEmpty(Стр) Then
Message("Найдены ошибки при загрузке файла:"+_NEWLINE+Стр);
Exit;
EndIf;

//Позиционирование объекта ветки
aNode:=aObject.Root;
aNode.Path:="<data><keyword><value>[5]";
//Проход по всем вложенным тегам, вывод содержимного тега name.
aNode2:=aNode.FirstChild();
While not IsEmpty(aNode2) Do
Message("Документ "+aNode2.SubPath("<document><name>").Text);
aNode2:=aNode2.Next();
EndDo;
</pre>

← Older revision	Revision as of 11:15, 9 June 2025
(No difference)

XML.SubPath - Revision history

Admin: 1 revision imported

1>Admin at 17:15, 27 March 2025