XML.DoesExist

From SunFlurry wiki
Jump to: navigation, search
  DoesExist (Обход структуры документа XML)
Объект:Объект XML
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в строку.
Визуальность:Нет

Функция используется совместно с объектом XML или объектом ветки XML и проверяет, существует ли указанный путь для дочерних веток текущей. Путь записывается в виде последовательности наименований веток с возможным дополнительным номером, указывающим на индекс ветки среди веток текущего уровня с таким же наименованием: <Ветка1>{[<Индекс1>]}{<Ветка2>...} (к примеру <Setup><Options><Option>[2]).

Синтаксис

XML.DoesExist(<Путь XML относительный к текущему объекту (STRING)>):<Существует ли путь (INT)>

Аргументы

  • <Путь XML относительный к текущему объекту (STRING)> - Аргумент задает путь для проверки.

Возвращаемое значение

Возвращает 1, если путь существует, 0 в ином случае.

Примеры

aObject:=XML.Create();

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

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

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

//Изменение значения текущей ветки (data)
//Значение может содержать подчиненные ветки
aNode.Text:="<data var1='value1'><subdata>text goes here...</subdata></data>";

//Функция возвратит 1
Message(aObject.DoesExist("<data><subdata>"));

//Функция возвратит 1 (aNode позиционирована на ветке <data>)
Message(aNode.DoesExist("<subdata>"));

//Функция возвратит 0, так как второй ветки <data> не существует.
Message(aObject.DoesExist("<data>[2]<subdata>"));