Руководство разработчика

Функция XML_СОЗДАТЬ_ФАЙЛ

Создает новый XML-документ и добавляет туда заданную инструкцию и корневой узел. Возвращаемая строка является курсором, связанным с корневым узлом.

ФУНКЦИЯ ТИП_СТРОКА: XML_СОЗДАТЬ_ФАЙЛ(ТИП_СТРОКА: файл,
                                                 инструкция,
                                                 имя_корня
                                                 [, опции])

Параметры

файл
Имя XML-файла.
инструкция
Текст инструкции xml, добавляемой в новый документ, а также набор дополнительных инструкций. Например:
"version=""1.0"" encoding=""windows-1251"""
Инструкция xml определяет кодировку XML-файла. Если указана пустая строка, то добавляется стандартная инструкция xml: <?xml version="1.0"?>, подразумевающая кодировку utf-8.
имя_корня
Имя корневого узла документа.

Имя корневого узла может содержать префикс пространства имен (namespace). Например, "myns:Root", где myns – имя пространства имен. Для корневого узла определение пространства имен должно быть указано как атрибут этого же узла. URI пространства имен необходимо указать в имени узла через пробел.
Например, "myns:Root http://schemas.mysample.com/123".
В результате будет создан узел следующего вида:
<myns:Root xmlns:myns="http://schemas.mysample.com/123" />
опции
Необязательный параметр. Дополнительные опции работы с XML:
  • "" – упрощенный режим (по умолчанию);
  • "t" – дополнительная поддержка текстовых узлов (типы PCDATA и CDATA).

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

Курсор, связанный с корневым узлом созданного файла.

Добавление дополнительных инструкций

Для добавления дополнительных инструкций используется разделитель "?". Указывается имя инструкции и, если необходимо, список атрибутов.
Например:

"version=""1.0"" encoding=""utf-8""?MyInstruction?AnotherInstruction someattr=""someval"""

В файле будут добавлены следующие инструкции:

<?xml version="1.0" encoding="utf-8"?>
<?MyInstruction ?>
<?AnotherInstruction someattr="someval"?>

См. также: