Admin: 1 revision imported

2021-06-28T07:06:21Z

1 revision imported

1>Admin at 07:58, 22 June 2021

2021-06-22T07:58:12Z

New page

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

== Синтаксис ==
<code>
{{Grey|XML.}}'''CreatePath'''(''<Путь XML относительный к текущему объекту (STRING)>''{{Optional|,''<Использовать форматирование (INT)>''{{Default|{{Eq}}1}}}}):''<Объект созданной ветки (XMLBRANCH)>''
</code>

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

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

== Примеры ==
<pre>
aObject:=XML.Create();

//Добавление особой ветки
aObject.Text:="<?xml version=""1.0"" encoding=""UTF-8"" ?>";

//Позиционирование объекта ветки
aNode:=aObject.Root;

//Добавление обычной ветки
aNode:=aNode.AddNode("data",,"var1='value1'",0);

//Создание подчиненного пути.
aNode:=aNode.CreatePath("<subdata><data2>",0);

//Изменение значения последней ветки
aNode.Value:="text goes here...";

//Будет выведено "<?xml version="1.0" encoding="UTF-8" ?><data var1='value1'><subdata><data2>text goes here...</data2></subdata></data>"
Message(aObject.Text);
</pre>

← Older revision	Revision as of 07:06, 28 June 2021
(No difference)

XML.CreatePath - Revision history

Admin: 1 revision imported

1>Admin at 07:58, 22 June 2021