array2table

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

구문

T = array2table(A)

T = array2table(A,Name,Value)

설명

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

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

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   

입력 인수

A — 입력 배열

행렬

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

데이터형: 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에 사용합니다.

RowNames — 행 이름

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

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

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

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

VariableNames — 변수 이름

문자형 벡터로 구성된 셀형 배열 | string형 배열

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

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

DimensionNames — 차원 이름

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

R2021a 이후

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

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

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

출력 인수

T — 출력 테이블

테이블

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

팁

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

확장 기능

tall형 배열

메모리에 담을 수 없을 정도로 많은 행을 가진 배열을 계산할 수 있습니다.

이 함수는 tall형 배열을 지원하지만 다음과 같은 제한 사항이 있습니다.

'RowNames' 이름-값 쌍은 지원되지 않습니다.

자세한 내용은 tall형 배열 항목을 참조하십시오.

C/C++ 코드 생성

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

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

• 생성된 코드에서 이 함수를 사용할 때는 'VariableNames' 이름-값 쌍의 인수를 지정해야 합니다. 자세한 내용은 Code Generation for Tables (MATLAB Coder) 항목과 Table Limitations for Code Generation (MATLAB Coder) 항목을 참조하십시오.

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

버전 내역

R2013b에 개발됨

R2019b: 변수 이름에 선행 공백과 후행 공백 문자가 포함될 수 있음

선행 또는 후행 공백 문자가 있는 테이블 및 타임테이블 변수 이름은 수정되지 않습니다.

이전 릴리스에서는 'VariableNames' 이름-값 쌍의 인수를 사용하여 변수 이름을 지정하거나 VariableNames 속성에 변수 이름을 할당한 경우 변수 이름에서 선행 및 후행 공백 문자가 삭제되었습니다.

이러한 문자를 직접 제거하려면, 먼저 이름에 strtrim 함수를 사용한 다음 이 이름을 테이블 또는 타임테이블에 변수 이름으로 할당하십시오.

참고 항목

table2array | cell2table | struct2table | table | isvarname

도움말 항목

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