writestruct

Запись структуры в файл

    Описание

    пример

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

    пример

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

    Примеры

    свернуть все

    Создайте структуру из текстового файла, содержащего 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>
    

    Чтение файла 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>
    

    Укажите имена полей в структуре входа для записи в качестве атрибутов в выход 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
    Амазонки S3™s3
    Windows Azure® Хранилище больших двоичных объектовwasb, 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
    Для просмотра документации необходимо авторизоваться на сайте