Exponenta Banner
exponenta event banner

writestruct

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

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

    Синтаксис

    writestruct (S, имя файла)
    writestruct (S, имя файла, имя, значение)

    Описание

    пример

    writestruct(S,filename) записывает структуру в файл с именем и расширением, указанными filename. 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" к именам полей структуры вывода, которые соответствуют атрибутам во входном 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

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

    Поддержка