ExportXML()

Синтаксис

Result = ExportXML(#XML , *Address , Size [, Flags])

Описание

Записывает дерево XML в виде разметки в указанный буфер памяти.

Параметры

#XML	Номер экспортируемого объекта XML.
*Address	Адрес записываемой области памяти.
Size	Размер (в байтах) области памяти.
Flags (дополн.)	Этот параметр может быть комбинацией следующих значений (с помощью оператора '|'): #PB_XML_StringFormat : Включает метку порядка байтов. Подробности см. в описании функции WriteStringFormat(). #PB_XML_NoDeclaration: Не включает декларацию XML. Примечание: Согласно спецификации XML, декларация XML может опускаться только если документ закодирован в UTF-8 или UTF-16, или если информация о кодировке предоставляется дополнительно, например через протокол передачи. Даже в этом случае рекомендуется оставить декларацию в документе.

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

Возвращает не нулевое значение, если указанное значение параметра 'Size' было достаточным для размещения всей разметки дерева. Чтобы определить требуемый размер этого буфера, воспользуйтесь функцией ExportXMLSize().

Комментарии

Создаваемая разметка XML не переформатируется. Она записывается так, как была первоначально разобрана/создана. Количество концов строк/пробелов, записываемых между тегами, сохраняется в атрибуте 'text' каждого узла XML. (Дополнительные сведения смотрите в описании функции GetXMLNodeText(). Чтобы переформатировать разметку XML перед сохранением, можно изменить атрибут 'text' каждого узла XML или воспользоваться функцией FormatXML() для применения к дереву некоторых общеупотребительных вариантов переформатирования.

См. также

ExportXMLSize(), FormatXML(), ComposeXML(), SaveXML()

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

Все