ComposeXML()

Синтаксис

Result$ = ComposeXML(#XML [, Flags])

Описание

Возвращает дерево XML как разметку в единственной строке. XML будет возвращен в строковом формате Purebasic (Unicode) независимо от установки, возвращаемой функцией GetXMLEncoding(). Для создания разметки в другой кодировке используйте функцию ExportXML().

Параметры

#XML

Номер экспортируемого объекта XML.

Flags (дополн.)

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

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

Возвращает разметку как строку.

Комментарии

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

См. также

FormatXML(), ExportXML(), SaveXML()

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

Все