Main Content

array2table

동종 배열(Homogeneous Array)을 테이블로 변환

설명

예제

T = array2table(A)m×n 배열 Am×n 테이블 T로 변환합니다. A의 각 열은 T에서 변수가 됩니다.

array2table은 열 번호가 추가된 입력 배열 이름을 테이블의 변수 이름으로 사용합니다. 이 이름들이 유효한 MATLAB® 식별자가 아닌 경우 'Var1',...,'VarN' 형식의 이름이 array2table에 사용됩니다. 여기서 NA의 열 개수입니다.

예제

T = array2table(A,Name,Value)는 하나 이상의 Name,Value 쌍 인수를 추가 옵션으로 지정하여 배열 A에서 테이블을 만들고자 할 때 사용합니다.

예를 들어, 테이블에 포함할 행 이름 또는 변수 이름을 지정할 수 있습니다.

예제

모두 축소

숫자형 데이터로 구성된 배열을 만듭니다.

A = [1 4 7; 2 5 8; 3 6 9]
A = 3×3

     1     4     7
     2     5     8
     3     6     9

배열 A를 테이블로 변환합니다.

T = array2table(A)
T=3×3 table
    A1    A2    A3
    __    __    __

    1     4     7 
    2     5     8 
    3     6     9 

이 테이블에는 입력 배열 이름 A에 열 번호를 추가한 변수 이름이 포함되어 있습니다.

숫자형 데이터로 구성된 배열을 만듭니다.

A = [1 12 30.48; 2 24 60.96; 3 36 91.44]
A = 3×3

    1.0000   12.0000   30.4800
    2.0000   24.0000   60.9600
    3.0000   36.0000   91.4400

배열 A를 테이블로 변환하고 변수 이름을 포함시킵니다.

T = array2table(A,...
    'VariableNames',{'Feet','Inches','Centimeters'})
T=3×3 table
    Feet    Inches    Centimeters
    ____    ______    ___________

     1        12         30.48   
     2        24         60.96   
     3        36         91.44   

입력 인수

모두 축소

입력 배열로, 행렬로 지정됩니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | struct | cell
복소수 지원 여부:

이름-값 인수

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

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: 'RowNames',{'row1','row2','row3'}은 행 이름 row1, row2, row3을 테이블 T에 사용합니다.

T의 행 이름으로, 'RowNames'와 함께 비어 있지 않은 고유한 요소를 갖는 문자형 벡터로 구성된 셀형 배열 또는 string형 배열이 쉼표로 구분되어 지정됩니다. 이름 개수는 행 개수 size(A,1)과 같아야 합니다.

공백이나 비ASCII 문자를 포함하여 모든 Unicode® 문자를 행 이름에 사용할 수 있습니다.

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

T의 변수 이름으로, 'VariableNames'와 함께 비어 있지 않은 고유한 요소를 갖는 문자형 벡터로 구성된 셀형 배열 또는 string형 배열이 쉼표로 구분되어 지정됩니다. 이름 개수는 변수의 개수 size(A,2)와 같아야 합니다.

변수 이름에는 공백과 비ASCII 문자를 포함하여 모든 Unicode 문자를 사용할 수 있습니다.

R2021a 이상

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

차원 이름에는 공백 및 비ASCII 문자를 포함하여 모든 Unicode 문자를 사용할 수 있습니다.

R2021a 이전 릴리스에서는 차원 이름을 지정하려면 출력값의 DimensionNames 속성을 설정하는 방법밖에 없었습니다.

출력 인수

모두 축소

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

  • A가 셀형 배열인 경우 cell2table(A)를 사용하여 A의 셀에 있는 내용으로 테이블을 만듭니다. 이 테이블의 각 변수는 숫자형이거나 문자형 벡터로 구성된 셀형 배열입니다. array2table(A)는 각 변수가 셀로 구성된 열인 테이블을 만듭니다.

확장 기능

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

버전 내역

R2013b에 개발됨

모두 확장