이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

array2table

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

구문

T = array2table(A)

T = array2table(A,Name,Value)

설명

T = array2table(A)는 m×n 배열 A를 m×n 테이블 T로 변환합니다. 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
복소수 지원 여부: 예

이름-값 쌍의 인수

선택적으로 Name,Value 인수가 쉼표로 구분되어 지정됩니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. Name은 따옴표 안에 표시해야 합니다. Name1,Value1,...,NameN,ValueN과 같이 여러 개의 이름-값 쌍의 인수를 어떤 순서로든 지정할 수 있습니다.

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

RowNames — T의 행 이름

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

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

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

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

VariableNames — T의 변수 이름

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

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

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

DimensionNames — 차원 이름

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

R2021a 이상

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

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

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

출력 인수

T — 출력 테이블

테이블

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

팁

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

호환성 관련 고려 사항

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

R2019b에서 동작이 변경됨

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

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

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

확장 기능

tall형 배열

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

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

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

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

C/C++ 코드 생성

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

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

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

참고 항목

table2array | cell2table | struct2table | table | isvarname

도움말 항목

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

R2013b에 개발됨

×

예제 열기

이 예제의 수정된 버전이 있습니다. 사용자가 편집한 내용을 반영하여 이 예제를 여시겠습니까?

아니요, 수정된 버전을 덮어씁니다. 예