struct2table

구조체형 배열을 테이블로 변환

구문

T = struct2table(S)

T = struct2table(S,Name=Value)

설명

T = struct2table(S)는 구조체형 배열을 테이블로 변환합니다. 입력 구조체의 각 필드는 출력 테이블에서 변수가 됩니다.

입력값에 따른 동작:

• 필드 n개가 포함된 스칼라 구조체고 이 필드 모두가 m개 행을 가지는 경우 출력값은 m×n 테이블이 됩니다.

  (필드의 행 개수가 서로 다른 스칼라 구조체의 경우, 다음 구문에서 AsArray 이름-값 인수를 사용합니다.)

• 필드 n개가 포함된 m×1 또는 1×m 구조체형 배열이면 출력값은 m×n 테이블이 됩니다. 각 구조체는 출력 테이블의 대응하는 행에 대한 값을 제공합니다.

T = struct2table(S,Name=Value)는 위에 열거된 구문에 나와 있는 입력 인수 외에, 이름-값 인수를 하나 이상 사용하여 옵션을 지정합니다.

예를 들어, AsArray를 true로 설정하여 struct2table이 입력값을 구조체형 배열로 처리하도록 강제할 수 있습니다. 입력값이 스칼라 구조체이면 출력값은 행이 한 개 있는 테이블입니다.

예제

스칼라 구조체를 테이블로 변환하기

디폴트 옵션을 사용하여 스칼라 구조체를 테이블로 변환합니다.

구조체형 배열 S를 만듭니다.

S.Name = ["Chang";"Brown";"Ruiz"];
S.Smoker = ["Y";"N";"Y"];
S.SystolicBP = [124;122;130];
S.DiastolicBP = [93;80;92];

스칼라 구조체 S에는 4개의 필드가 있으며 각 필드는 3개의 행으로 구성되어 있습니다.

구조체형 배열을 테이블로 변환합니다.

T = struct2table(S)

T=3×4 table
     Name      Smoker    SystolicBP    DiastolicBP
    _______    ______    __________    ___________

    "Chang"     "Y"         124            93     
    "Brown"     "N"         122            80     
    "Ruiz"      "Y"         130            92     

S의 구조체 필드 이름은 출력 테이블의 변수 이름이 됩니다. T의 크기는 3×4입니다.

테이블 속성 T.Properties.RowNames를 수정한 다음, 변수 Name을 삭제하여 Name을 변수에서 행 이름으로 변경합니다.

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

T

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

    Chang     "Y"         124            93     
    Brown     "N"         122            80     
    Ruiz      "Y"         130            92     

비 스칼라 구조체형 배열을 테이블로 변환하기

비 스칼라 구조체형 배열 S를 만듭니다.

S(1,1).Name = "Chang";
S(1,1).Smoker = "Y";
S(1,1).SystolicBP = 124;
S(1,1).DiastolicBP = 93;

S(2,1).Name = "Brown";
S(2,1).Smoker = "N";
S(2,1).SystolicBP = 122;
S(2,1).DiastolicBP = 80;

S(3,1).Name = "Ruiz";
S(3,1).Smoker = "Y";
S(3,1).SystolicBP = 130;
S(3,1).DiastolicBP = 92;

S

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

S는 필드가 4개인 3×1 구조체형 배열입니다.

구조체형 배열을 테이블로 변환합니다.

T = struct2table(S)

T=3×4 table
     Name      Smoker    SystolicBP    DiastolicBP
    _______    ______    __________    ___________

    "Chang"     "Y"         124            93     
    "Brown"     "N"         122            80     
    "Ruiz"      "Y"         130            92     

S의 구조체 필드 이름은 출력 테이블의 변수 이름이 됩니다. T의 크기는 3×4입니다.

스칼라 구조체를 구조체형 배열로 처리하기

필드의 행 개수가 서로 다른 스칼라 구조체에서 테이블을 만들려면 스칼라 구조체를 구조체형 배열로 처리합니다.

name 필드, billing 필드, test 필드를 가진 스칼라 구조체를 만듭니다.

S.name = "John Doe";
S.billing = 127.00;
S.test = [79 75 73; 180 178 177.5; 220 210 205]

S = struct with fields:
       name: "John Doe"
    billing: 127
       test: [3×3 double]

이 경우, 필드의 행 개수가 서로 다르므로 struct2table(S)는 사용할 수 없습니다.

대신 AsArray 이름-값 인수를 설정하여 입력값을 구조체형 배열로 처리합니다. 이 구문을 사용하면 필드의 행 개수가 서로 다른 경우에도 스칼라 구조체를 행이 한 개 있는 테이블로 변환할 수 있습니다.

T = struct2table(S,AsArray=true)

T=1×3 table
       name       billing        test    
    __________    _______    ____________

    "John Doe"      127      {3×3 double}

입력 인수

S — 입력 배열

스칼라 구조체 | 구조체형 배열

입력 배열로, 스칼라 구조체 또는 구조체형 배열로 지정됩니다.

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

예: S가 스칼라 구조체이면 struct2table(S,AsArray=true)는 S를 한 행 크기의 테이블로 변환합니다.

RowNames — 행 이름

{} (디폴트 값) | string형 배열 | 문자형 벡터로 구성된 셀형 배열

행 이름으로, 비어 있지 않은 고유한 요소를 갖는 string형 배열 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 행 이름의 개수는 입력 배열의 행 개수와 같아야 합니다.

콜론 문자 :을 제외한 공백이나 비ASCII 문자를 포함하여 모든 Unicode^® 문자를 행 이름에 사용할 수 있습니다.

선행 또는 후행 공백 문자를 갖는 행 이름을 지정할 경우 struct2table은 행 이름에서 해당 공백을 제거합니다.

DimensionNames — 차원 이름

요소를 2개 가진 string형 배열 | 문자형 벡터로 구성된, 요소를 2개 가진 셀형 배열

차원 이름으로, 문자형 벡터 요소를 2개 가진 string형 배열 또는 비어 있지 않고 고유한 요소를 2개 가진 문자형 벡터로 구성된 셀형 배열로 지정됩니다.

차원 이름에는 공백 및 비ASCII 문자를 포함하여 모든 Unicode 문자를 사용할 수 있습니다. 하지만 차원 이름은 어떤 테이블 변수 이름이나 예약된 이름인 Properties, RowNames, VariableNames 또는 콜론 문자(:)와 일치할 수 없습니다.

또는 모든 릴리스에서 테이블의 DimensionNames 속성을 설정하여 차원 이름을 지정할 수 있습니다.

AsArray — 입력값을 구조체형 배열로 처리하는 플래그

true 또는 1 | false 또는 0

입력값을 구조체형 배열로 처리하는 플래그로, 숫자형 또는 논리값 1(true) 또는 0(false)으로 지정됩니다.

true 입력값이 비 스칼라 구조체형 배열인 경우 디폴트 값

구조체형 배열을 각 구조체에 대해 하나의 행을 가지고 구조체형 배열의 각 필드에 대해 하나의 변수를 가지는 테이블로 변환합니다. 필드의 크기는 서로 다를 수 있습니다. S(1:m).fieldname 필드의 값에 따라 다음 사항이 적용됩니다. 크기와 데이터형이 호환 가능하고 각 값에 하나의 행이 있는 경우, 대응 테이블 변수는 동종 배열입니다. 예: S(1).a = [1 2] S(2).a = [3 4] S(1).b = 5 S(2).b = 6 T = struct2table(S) T = 2×2 table a b ______ _ 1 2 5 3 4 6 크기가 다르거나 데이터형이 호환되지 않거나 값에 두 개 이상의 행이 있는 경우, 대응 테이블 변수는 셀형 배열입니다. 예: S(1).a = [1 2] S(2).a = [3 4 5 6] S(1).b = 7 S(2).b = 8 T = struct2table(S) T = 2×2 table a b ___________ _ {[ 1 2]} 7 {[3 4 5 6]} 8

false 입력값이 스칼라 구조체인 경우 디폴트 값

필드 n개가 포함된 스칼라 구조체를 m×n 테이블로 변환합니다. 각 필드에는 m개 행이 있어야 합니다. 예: S.a = [1;2;3] S.b = [4 5;6 7;8 9] T = struct2table(S) T = 3×2 table a b _ ______ 1 4 5 2 6 7 3 8 9

출력 인수

T — 출력 테이블

테이블

출력 테이블로, 테이블 형식으로 반환됩니다. 이 테이블에는 설명, 변수 단위, 변수 이름, 행 이름과 같은 메타데이터가 저장될 수 있습니다. 자세한 내용은 table의 속성 섹션을 참조하십시오.

확장 기능

C/C++ 코드 생성

MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 자세한 내용은 Code Generation for Tables (MATLAB Coder) 항목과 Table Limitations for Code Generation (MATLAB Coder) 항목을 참조하십시오.

GPU 코드 생성

GPU Coder™를 사용하여 NVIDIA® GPU용 CUDA® 코드를 생성할 수 있습니다.

C/C++ 코드 생성 섹션의 사용법 관련 참고 및 제한 사항을 참조하십시오. GPU 코드 생성에도 동일한 사용법 관련 참고 및 제한 사항이 적용됩니다.

스레드 기반 환경
MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

버전 내역

R2013b에 개발됨

참고 항목

table2struct | cell2table | array2table | table

도움말 항목

• 테이블의 데이터에 액세스하기