struct2table

Преобразуйте массив структур в таблицу

Описание

пример

T = struct2table(S) преобразует массив структур, S, к таблице, T. Каждое поле S становится переменной в T.

пример

T = struct2table(S,Name,Value) создает таблицу из массива структур, S, с дополнительными опциями, заданными одним или несколькими Name,Value аргументы в виде пар.

Для примера можно задать имена строк, которые будут включены в таблицу.

Примеры

свернуть все

Преобразовать скалярную структуру в таблицу можно используя опции по умолчанию.

Создайте массив структур, S.

S.Name = {'CLARK';'BROWN';'MARTIN'};
S.Gender = {'M';'F';'M'};
S.SystolicBP = [124;122;130];
S.DiastolicBP = [93;80;92];

S
S = struct with fields:
           Name: {3x1 cell}
         Gender: {3x1 cell}
     SystolicBP: [3x1 double]
    DiastolicBP: [3x1 double]

Скалярная структура, S, имеет четыре поля, каждый с тремя строками.

Преобразуйте массив структуры в таблицу.

T = struct2table(S)
T=3×4 table
       Name       Gender    SystolicBP    DiastolicBP
    __________    ______    __________    ___________

    {'CLARK' }    {'M'}        124            93     
    {'BROWN' }    {'F'}        122            80     
    {'MARTIN'}    {'M'}        130            92     

Имена структурных полей в S стать именами переменных в выход таблице. Размер T 3 на 4.

Изменение Name от переменной до имен строк путем изменения свойства таблицы, T.Properties.RowNames, а затем удаление переменной Name.

T.Properties.RowNames = T.Name;
T.Name = [];

T
T=3×3 table
              Gender    SystolicBP    DiastolicBP
              ______    __________    ___________

    CLARK     {'M'}        124            93     
    BROWN     {'F'}        122            80     
    MARTIN    {'M'}        130            92     

Создайте нескалярный массив структур, S.

S(1,1).Name = 'CLARK';
S(1,1).Gender = 'M';
S(1,1).SystolicBP = 124;
S(1,1).DiastolicBP = 93;

S(2,1).Name = 'BROWN';
S(2,1).Gender = 'F';
S(2,1).SystolicBP = 122;
S(2,1).DiastolicBP = 80;

S(3,1).Name = 'MARTIN';
S(3,1).Gender = 'M';
S(3,1).SystolicBP = 130;
S(3,1).DiastolicBP = 92;

S
S=3×1 struct array with fields:
    Name
    Gender
    SystolicBP
    DiastolicBP

S представляет собой массив структур 3 на 1 с четырьмя полями.

Преобразуйте массив структуры в таблицу.

T = struct2table(S)
T=3×4 table
       Name       Gender    SystolicBP    DiastolicBP
    __________    ______    __________    ___________

    {'CLARK' }    {'M'}        124            93     
    {'BROWN' }    {'F'}        122            80     
    {'MARTIN'}    {'M'}        130            92     

Имена структурных полей в S стать именами переменных в выход таблице. Размер T 3 на 4.

Использование 'AsArray',true чтобы создать таблицу из скалярной структуры, поля которой имеют разное количество строк.

Создайте скалярную структуру, S, с полями name, billing, и test.

S.name = 'John Doe';
S.billing = 127.00;
S.test = [79, 75, 73; 180, 178, 177.5; 220, 210, 205];
S
S = struct with fields:
       name: 'John Doe'
    billing: 127
       test: [3x3 double]

Поля имеют разное количество строк. Поэтому вы не можете использовать struct2table(S), который использует 'AsArray',false по умолчанию.

Обработайте скалярную структуру как массив и преобразуйте ее в таблицу.

T = struct2table(S,'AsArray',true)
T=1×3 table
        name        billing        test    
    ____________    _______    ____________

    {'John Doe'}      127      {3x3 double}

T содержит одну строку.

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

свернуть все

Массив структур, заданный как скалярный массив структур.

  • Если S является скалярной структурой с n полей, все из которых имеют m строки, затем T является m-by- n таблица.

  • Если S является нескалярным m-by- 1 массив структур с n поля, затем T является m-by- n таблица.

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

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

Пример: 'RowNames',{'row1','row2','row3'} использует имена строк, row1, row2, и row3 для таблицы, T.

Имена строк, заданные как разделенная разделенными запятой парами, состоящая из 'RowNames' и массив ячеек из векторов символов или строковых массивов, элементы которого непусты и различимы.

Имена строк могут иметь любой Юникод® символы, включая пространства и символы, отличные от ASCII.

Если вы задаете имена строк, которые имеют начальные или конечные пробелы, то struct2table удаляет их из имен строк.

Начиная с R2021a

Имена размерностей, заданные как двухэлементный массив ячеек из векторов символов или двухэлементные строковые массивы, элементы которого непусты и различны.

Имена размерностей могут иметь любые символы Юникода, включая пространства и символы, отличные от ASCII.

Перед R2021a можно задать имена размерностей только путем установки DimensionNames свойство выхода.

Индикатор того, как обработать скалярную структуру, заданный как разделенная разделенными запятой парами, состоящая из 'AsArray' и любой из них false, true, 0, или 1.

true

struct2table преобразует S к таблице с одной строкой и n переменные. Переменные могут быть различными размерами.

false

struct2table преобразует скалярный массив структур с n поля в m-by- n таблица. Каждое поле должно иметь m строки. Это поведение по умолчанию

Выходные аргументы

свернуть все

Выходная таблица, возвращенная как таблица. Таблица может хранить такие метаданные, как описания, переменные модули, имена переменных и имена строк. Для получения дополнительной информации смотрите раздел « Свойства» table.

Расширенные возможности

.
Введенный в R2013b