writestruct

Запишите структуру в файл

свернуть все на странице

    Синтаксис

    writestruct(S,filename)
    writestruct(S,filename,Name,Value)

    Описание

    пример

    writestruct(S,filename) пишет структура в файл с именем и расширением, заданным filename. writestruct функционируйте автоматически пишет входную структуру в XML-файл когда .xml задан как расширение файла в filename.

    пример

    writestruct(S,filename,Name,Value) пишет структура в файл с дополнительными опциями, заданными одним или несколькими аргументами пары "имя-значение". Например, можно экспортировать содержимое входной структуры как XML-файл независимо от расширения файла, заданного в filename путем вызова writestruct(filename,"FileType","xml").

    Примеры

    свернуть все

    Скрипт Open Live Script

    Создайте структуру из текстового файла, который содержит структуру XML, затем запишите его в XML-файл.

    Файл music.txt имеет следующую структуру.

    Считайте текстовый файл music.txt как структура S. Задайте 'FileType' как 'xml' считать содержимое входа как XML-файл.

    S = readstruct("music.txt","FileType","xml")
    S = struct with fields:
     Ensemble: [1x1 struct]
    Musicians: [1x1 struct]

    Запишите S к XML-файлу под названием band.xml. Отобразите содержимое band.xml.

    writestruct(S,"band.xml")
type band.xml
    <?xml version="1.0" encoding="UTF-8"?>
<struct>
    <Ensemble>
        <Music>Jazz</Music>
        <BandName>Kool Katz</BandName>
        <Instrumentation>
            <Instrument type="wind">
                <Text>Trumpet</Text>
            </Instrument>
            <Instrument type="percussion">
                <Text>Piano</Text>
            </Instrument>
            <Instrument type="percussion">
                <Text>Drums</Text>
            </Instrument>
            <Instrument type="string">
                <Text>Bass</Text>
            </Instrument>
            <pianotype>concert grand</pianotype>
            <drumkit>Bass drum</drumkit>
            <drumkit>Floor tom</drumkit>
            <drumkit>Snare drum</drumkit>
            <drumkit>Hi-hat</drumkit>
            <drumkit>Ride cymbal</drumkit>
            <basstype>upright</basstype>
        </Instrumentation>
    </Ensemble>
    <Musicians>
        <Name role="trumpeter">
            <Text>Miles</Text>
        </Name>
        <Name role="vocalist">
            <Text>Roger</Text>
        </Name>
        <Name role="pianist">
            <Text>Diana</Text>
        </Name>
        <Name role="drummer">
            <Text>George</Text>
        </Name>
        <Name role="bassist">
            <Text>John</Text>
        </Name>
    </Musicians>
</struct>
    Скрипт Open Live Script

    Считайте файл music.xml как структура S.

    S = readstruct("music.xml")
    S = struct with fields:
     Ensemble: [1x1 struct]
    Musicians: [1x1 struct]

    Запишите S к XML-файлу под названием band.xml. Назовите корневой узел JazzBand. Отобразите содержимое band.xml.

    writestruct(S,"band.xml","StructNodeName","JazzBand")
type band.xml
    <?xml version="1.0" encoding="UTF-8"?>
<JazzBand>
    <Ensemble>
        <Music>Jazz</Music>
        <BandName>Kool Katz</BandName>
        <Instrumentation>
            <Instrument type="wind">
                <Text>Trumpet</Text>
            </Instrument>
            <Instrument type="percussion">
                <Text>Piano</Text>
                <pianotype>concert grand</pianotype>
            </Instrument>
            <Instrument type="percussion">
                <Text>Drums</Text>
                <drumkit>Bass drum</drumkit>
                <drumkit>Floor tom</drumkit>
                <drumkit>Snare drum</drumkit>
                <drumkit>Hi-hat</drumkit>
                <drumkit>Ride cymbal</drumkit>
            </Instrument>
            <Instrument type="string">
                <Text>Bass</Text>
                <basstype>upright</basstype>
            </Instrument>
        </Instrumentation>
    </Ensemble>
    <Musicians>
        <Name role="trumpeter">
            <Text>Miles</Text>
        </Name>
        <Name role="vocalist">
            <Text>Roger</Text>
        </Name>
        <Name role="pianist">
            <Text>Diana</Text>
        </Name>
        <Name role="drummer">
            <Text>George</Text>
        </Name>
        <Name role="bassist">
            <Text>John</Text>
        </Name>
    </Musicians>
</JazzBand>
    Скрипт Open Live Script

    Задайте имена полей во входной структуре, чтобы написать как атрибуты в выходном XML-файле.

    Считайте файл music.xml как структура S. Добавьте суффиксный "_att" к именам полей структуры output, которые соответствуют атрибутам во входном XML-файле.

    S = readstruct("music.xml", "AttributeSuffix", "_att")
    S = struct with fields:
     Ensemble: [1x1 struct]
    Musicians: [1x1 struct]

    Все элементы в S это сопоставило атрибуты, будет иметь суффиксный "_att" добавленный к названиям атрибута.

    Запросите поле Musicians просмотреть его содержимое. Musicians структура, которая содержит пять структур, каждая из которых содержат поле под названием Name со связанным атрибутом под названием role. 

    S.Musicians.Name
    ans=1×5 struct array with fields:
    role_att
    Text

    Запишите S к XML-файлу под названием band.xml и отобразите его содержимое. Суффиксный "_att" был добавлен к названиям атрибута в файле.

    writestruct(S,"band.xml")
type band.xml
    <?xml version="1.0" encoding="UTF-8"?>
<struct>
    <Ensemble>
        <Music>Jazz</Music>
        <BandName>Kool Katz</BandName>
        <Instrumentation>
            <Instrument>
                <type_att>wind</type_att>
                <Text>Trumpet</Text>
            </Instrument>
            <Instrument>
                <type_att>percussion</type_att>
                <Text>Piano</Text>
                <pianotype>concert grand</pianotype>
            </Instrument>
            <Instrument>
                <type_att>percussion</type_att>
                <Text>Drums</Text>
                <drumkit>Bass drum</drumkit>
                <drumkit>Floor tom</drumkit>
                <drumkit>Snare drum</drumkit>
                <drumkit>Hi-hat</drumkit>
                <drumkit>Ride cymbal</drumkit>
            </Instrument>
            <Instrument>
                <type_att>string</type_att>
                <Text>Bass</Text>
                <basstype>upright</basstype>
            </Instrument>
        </Instrumentation>
    </Ensemble>
    <Musicians>
        <Name>
            <role_att>trumpeter</role_att>
            <Text>Miles</Text>
        </Name>
        <Name>
            <role_att>vocalist</role_att>
            <Text>Roger</Text>
        </Name>
        <Name>
            <role_att>pianist</role_att>
            <Text>Diana</Text>
        </Name>
        <Name>
            <role_att>drummer</role_att>
            <Text>George</Text>
        </Name>
        <Name>
            <role_att>bassist</role_att>
            <Text>John</Text>
        </Name>
    </Musicians>
</struct>

    writestruct(S,"band.xml","AttributeSuffix","_att")

    Запишите структуре S к XML-файлу снова, на этот раз задавая значение "AttributeSuffix" как "_att" указать который имена полей во входной структуре записать как атрибуты. Отобразите содержимое band.xml. Атрибуты в band.xml не имейте суффиксного "_att".

    type band.xml
    <?xml version="1.0" encoding="UTF-8"?>
<struct>
    <Ensemble>
        <Music>Jazz</Music>
        <BandName>Kool Katz</BandName>
        <Instrumentation>
            <Instrument type="wind">
                <Text>Trumpet</Text>
            </Instrument>
            <Instrument type="percussion">
                <Text>Piano</Text>
                <pianotype>concert grand</pianotype>
            </Instrument>
            <Instrument type="percussion">
                <Text>Drums</Text>
                <drumkit>Bass drum</drumkit>
                <drumkit>Floor tom</drumkit>
                <drumkit>Snare drum</drumkit>
                <drumkit>Hi-hat</drumkit>
                <drumkit>Ride cymbal</drumkit>
            </Instrument>
            <Instrument type="string">
                <Text>Bass</Text>
                <basstype>upright</basstype>
            </Instrument>
        </Instrumentation>
    </Ensemble>
    <Musicians>
        <Name role="trumpeter">
            <Text>Miles</Text>
        </Name>
        <Name role="vocalist">
            <Text>Roger</Text>
        </Name>
        <Name role="pianist">
            <Text>Diana</Text>
        </Name>
        <Name role="drummer">
            <Text>George</Text>
        </Name>
        <Name role="bassist">
            <Text>John</Text>
        </Name>
    </Musicians>
</struct>

    Входные параметры

    свернуть все

    Введите структуру в виде структуры MATLAB. Структура является типом данных, которым группирует связанные данные с помощью контейнеров данных, называемых полями.

    Если поле во входной структуре содержит отсутствующее значение или NaN, writestruct запишет содержимое поля как пустая строка.

    Для получения дополнительной информации о структурах смотрите struct.

    Имя файла, чтобы записать в в виде вектора символов или строкового скаляра. Если filename не существует, затем функция записи создает файл. Если filename имя существующего файла, затем функция записи перезаписывает его.

    В зависимости от местоположения вы пишете в, filename может взять одну из следующих форм.

    Местоположение

    Форма

    Текущая папка

    Чтобы записать в текущую папку, задайте имя файла в filename.

    Пример: 'myFile.xml'

    Другие папки

    Чтобы записать в папку, отличающуюся от текущей папки, задайте полное имя или относительный путь в filename.

    Пример: 'C:\myFolder\myFile.xml'

    Пример: 'myFolder\myFile.xml'

    Удаленное местоположение

    Чтобы записать в удаленное местоположение, задайте универсальный локатор ресурса (URL) формы:

    scheme_name://path_to_file/my_file.ext

    На основе вашего удаленного местоположения, scheme_name может быть одно из значений в этой таблице.

    Удаленное местоположениеscheme_name
    Amazon S3™s3
    Устройство хранения данных Windows Azure® Blobwasb, wasbs
    HDFS™hdfs

    Для получения дополнительной информации смотрите работу с Удаленными данными.

    Пример: 's3://bucketname/path_to_file/myFile.xml'

    Аргументы в виде пар имя-значение

    Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

    Пример: 'StructNodeName','RootName' задает имя, чтобы использовать для корневого узла выходного XML-файла.

    Тип файла в виде разделенной запятой пары, состоящей из 'FileType' и одно из этих значений:

    • 'auto' — Автоматически обнаружьте формат файла, чтобы записать из расширения, заданного в filename.

    • 'xml' — Экспортируйте содержимое структуры как XML-файл, независимо от расширения файла, заданного в filename.

    Если вы задаете расширение файла в filename это не .xml, можно задать значение 'FileType' как 'xml' записать содержимое входной структуры как XML.

    Пример: 'FileType','xml'

    Имя корневого узла выходного XML-файла в виде разделенной запятой пары, состоящей из 'StructNodeName' и или вектор символов или строковый скаляр, содержащий имя корневого узла, который будет использоваться в выходе. Если вы не задаете StructNodeName, именем по умолчанию корневого узла является "struct".

    Пример: 'StructNodeName','RootName'

    Суффикс атрибута в виде разделенной запятой пары, состоящей из 'AttributeSuffix' и или вектор символов или строковый скаляр, указывающий, который имена полей во входной структуре написать как атрибуты в выходном XML-файле.

    Например, для имени поля AttName_att во входной структуре можно задать 'AttributeSuffix','_att' указать на тот 'AttName' должен быть выписан как атрибут в выходном XML-файле.

    • Если вы не задаете 'AttributeSuffix', writestruct значения по умолчанию к полям записи с суффиксным 'Attribute' как приписывает в выходном XML-файле.

    • Если атрибут, заданный как значение 'AttributeSuffix' совпадает с суффиксом, добавленным к названию атрибута во входной структуре, суффикс будет исключен из названия атрибута в выходном XML-файле. Например, если вы задаете 'AttributeSuffix','_att', поле во входной структуре под названием MyField_att будет соответствовать атрибуту под названием MyField в XML-файле.

    Пример: 'AttributeSuffix','_att'

    Смотрите также

    Введенный в R2020b

    Документация MATLAB

    Поддержка

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