XMLNodeFromPath()

Синтаксис

*Result = XMLNodeFromPath(*ParentNode , Path$)

Описание

Возвращает узел XML внутри узла *ParentNode, отношение которого к ParentNode описывается с помощью Path$. Чтобы получить такой путь до узла, воспользуйтесь функцией XMLNodePath().

Параметры

*ParentNode

Родительский узел XML.

Path$

Этот параметр содержит список имён узлов, разделённых символом '/', чтобы указать путь следования от родителя к целевому узлу. Например, "childtag/subchildtag" задаёт первый узел с именем "subchildtag" внутри первого узла с именем "childtag" внутри узла *ParentNode. Имя узла может содержать индекс (начинающийся с единицы) чтобы указать, какой из нескольких дочерних тегов с тем же именем следует выбрать. "childtag/subchildtag[3]" задаёт 3-й узел "subchildtag" внутри первого узла "childtag" в узле *ParentNode. Другие правила: - Если путь начинается с символа '/', он задан относительно корня дерева. Какой узел задаёт параметр *ParentNode, не имеет значения. - Подстановочный символ "*" можно использовать вместо имени тега, указывая тем самым, что выбирается любой тег. - У узла Комментария имя тега "#comment" - У узла CData имя тега "#cdata" - У узла DTD имя тега "#dtd" - У узла Инструкции Обработки (Processing Instruction) имя тега "#instruction" Некоторые примеры корректных путей: "/mainnode/#comment[4]" - 4-й комментарий внутри узла "mainnode" внутри корня дерева "*[10]" - 10-й узел (любого типа) внутри узла *ParentNode "*/*/*" - 1-й узел 3-мя уровнями ниже узла *ParentNode независимо от его типа "node[3]/*[3]/#cdata" - первая секция CData внутри 3-го узла любого вида внутри 3-го узла "node" внутри узла *ParentNode Примечание: Эта команда не является реализацией спецификации XPath. Используемый и понимаемый этой командой синтаксис это лишь небольшое подмножество XPath. Это означает, что путь, возвращаемый из функции XMLNodePath(), является корректным запросом XPath, но эта команда понимает только описанный здесь синтаксис, не вообще любой запрос XPath.

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

Возвращает указатель на целевой узел или нуль, если путь не ведет к корректному узлу.

См. также

XMLNodePath()

Поддерживаемые OS

Все