size

배열 크기

구문

sz = size(A)

szdim = size(A,dim)

szdim = size(A,dim1,dim2,...,dimN)

[sz1,...,szN] = size(___)

설명

sz = size(A)는 A의 각 차원 길이를 요소로 갖는 행 벡터를 반환합니다. 예를 들어 A가 3×4 행렬이면 size(A)는 벡터 [3 4]를 반환합니다.

A가 테이블이나 타임테이블인 경우 size(A)는 테이블의 행 개수와 변수 개수로 구성된, 요소를 2개 가진 행 벡터를 반환합니다.

szdim = size(A,dim)은 dim이 양의 정수 스칼라인 경우 차원 dim의 길이를 반환합니다. dim을 양의 정수로 구성된 벡터로 지정하여 한 번에 여러 개의 차원 길이를 쿼리할 수도 있습니다. 예를 들어, size(A,[2 3])은 A의 두 번째 차원과 세 번째 차원의 길이를 1×2 행 벡터 szdim으로 반환합니다.

szdim = size(A,dim1,dim2,...,dimN)은 차원 dim1,dim2,...,dimN의 길이를 행 벡터 szdim으로 반환합니다.

[sz1,...,szN] = size(___)는 A의 쿼리 차원의 길이를 개별적으로 반환합니다.

예제

4차원 배열의 크기

4차원 랜덤 배열을 만들고 크기를 반환합니다.

A = rand(2,3,4,5);
sz = size(A)

sz = 1×4

     2     3     4     5

A의 두 번째 차원의 길이를 쿼리합니다.

szdim2 = size(A,2)

szdim2 = 
3

A의 마지막 차원의 길이를 쿼리합니다.

szdimlast = size(A,ndims(A))

szdimlast = 
5

차원 인수를 벡터로 지정하여 한 번에 여러 개의 차원 길이를 쿼리할 수 있습니다. 예를 들어, A의 첫 번째 차원과 세 번째 차원의 길이를 구합니다.

szdim13 = size(A,[1 3])

szdim13 = 1×2

     2     4

A의 두 번째 차원부터 네 번째 차원까지 각 차원의 길이를 구합니다.

szdim23 = size(A,2:4)

szdim23 = 1×3

     3     4     5

또는, 쿼리 차원을 개별 입력 인수로 나열할 수 있습니다.

szdim23 = size(A,2,3,4);

테이블의 크기

5개의 행과 4개의 변수를 가진 테이블을 생성합니다.

LastName = {'Smith';'Johnson';'Williams';'Jones';'Brown'};
Age = [38;43;38;40;49];
Height = [71;69;64;67;64];
Weight = [176;163;131;133;119];
BloodPressure = [124 93; 109 77; 125 83; 117 75; 122 80];

A = table(Age,Height,Weight,BloodPressure,'RowNames',LastName)

A=5×4 table
                Age    Height    Weight    BloodPressure
                ___    ______    ______    _____________

    Smith       38       71       176       124     93  
    Johnson     43       69       163       109     77  
    Williams    38       64       131       125     83  
    Jones       40       67       133       117     75  
    Brown       49       64       119       122     80  

테이블의 크기를 구합니다. BloodPressure 변수에는 열이 두 개 있지만 size는 변수 개수만 셉니다.

sz = size(A)

sz = 1×2

     5     4

개별 인수로 차원 길이 반환하기

확률 행렬을 만들고 행 개수와 열 개수를 개별적으로 반환합니다.

A = rand(4,3);
[numRows,numCols] = size(A)

numRows = 
4

numCols = 
3

입력 인수

A — 입력 배열

스칼라 | 벡터 | 행렬 | 다차원 배열

입력 배열로, 스칼라, 벡터, 행렬 또는 다차원 배열로 지정됩니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | struct | function_handle | cell | categorical | datetime | duration | calendarDuration | table | timetable

복소수 지원 여부: 예

dim — 쿼리 차원

양의 정수 스칼라 | 양의 정수 스칼라로 구성된 벡터 | 빈 배열

쿼리 차원으로, 양의 정수 스칼라, 양의 정수 스칼라로 구성된 벡터 또는 크기가 0×0, 0×1, 1×0인 빈 배열로 지정됩니다. dim의 요소가 ndims(A)보다 크면 size는 출력값의 대응하는 요소에 1을 반환합니다. dim이 빈 배열이면 size는 1×0 빈 배열을 반환합니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

dim1,dim2,...,dimN — 쿼리 차원 목록

양의 정수 스칼라

쿼리 차원 목록으로, 쉼표로 구분된 양의 정수 스칼라로 지정됩니다. 목록의 요소가 ndims(A)보다 크면 size는 출력값의 대응하는 요소에 1을 반환합니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

출력 인수

sz — 배열 크기

음이 아닌 정수로 이루어진 행 벡터

배열 크기로, 음이 아닌 정수로 구성된 행 벡터로 반환됩니다.

• sz의 요소는 각각 대응하는 A의 차원 길이를 나타냅니다. sz의 요소 중 하나라도 0과 같으면 A는 빈 배열입니다.

• A가 스칼라이면 sz는 행 벡터 [1 1]입니다.

• A가 테이블이거나 타임테이블이면 sz는 행의 개수와 변수의 개수를 포함한, 요소를 2개 가진 행 벡터입니다. 단일 변수에 있는 여러 열은 계산되지 않습니다.

• A가 char형 문자형 벡터인 경우 size는 행 벡터 [1 M]을 반환합니다. 여기서 M은 문자 개수입니다. 그러나 A가 string형 스칼라인 경우 string형 배열의 단일 요소이므로 size는 [1 1]을 반환합니다. 예를 들어, 다음과 같이 문자형 벡터와 string형에 대해 size의 출력값을 비교합니다.

  szchar = size('mytext')

  szchar =
  
       1     6

  szstr = size("mytext")

  szstr =
  
       1     1
  

  문자열에 포함된 문자 수를 구하려면 strlength 함수를 사용하십시오.

데이터형: double

szdim — 차원 길이

음이 아닌 정수 스칼라 | 음이 아닌 정수 스칼라로 구성된 벡터 | 1×0 빈 배열

차원 길이로, dim이 양의 정수 스칼라이면 음이 아닌 정수 스칼라로 반환되고, dim이 양의 정수로 구성된 벡터이면 음이 아닌 정수 스칼라로 구성된 행 벡터로 반환되고, dim이 빈 배열이면 1×0 빈 배열로 반환됩니다. 지정된 차원 인수의 요소가 ndims(A)보다 큰 경우 size는 szdim의 대응하는 요소에 1을 반환합니다.

데이터형: double

sz1,...,szN — 개별적으로 나열되는 차원 길이

음이 아닌 정수 스칼라

개별적으로 나열되는 차원 길이로, 쉼표로 구분된 음이 아닌 정수 스칼라로 반환됩니다.

• dim을 지정하지 않고 ndims(A)보다 작은 수의 출력 인수를 나열하면 나머지 모든 차원의 길이가 축약되어 목록의 마지막 인수에 반환됩니다. 예를 들어 A가 크기 [3 4 5]의 3차원 배열인 경우 [sz1,sz2] = size(A)는 sz1 = 3, sz2 = 20을 반환합니다.

• dim을 지정하는 경우에는 출력 인수의 개수가 쿼리 차원의 개수와 같아야 합니다.

• ndims(A)보다 더 큰 수의 출력 인수를 지정하면 여분의 후행 인수가 1로 반환됩니다.

데이터형: double

팁

• 배열이 비어 있는지, 스칼라인지, 행렬인지 판별하려면 isempty, isscalar, ismatrix를 사용합니다. isrow 함수와 iscolumn 함수로 벡터 방향도 판별할 수 있습니다.

확장 기능

tall형 배열

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

size 함수는 tall형 배열을 완전히 지원합니다. 자세한 내용은 tall형 배열 항목을 참조하십시오.

C/C++ 코드 생성

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

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

• 가변 크기의 N차원 배열의 경우 size 함수는 MATLAB^®에서 생성된 결과와 다른 결과를 생성된 코드에서 반환할 수 있습니다. Incompatibility with MATLAB in Determining Size of Variable-Size N-D Arrays (MATLAB Coder) 항목을 참조하십시오.

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

HDL 코드 생성
HDL Coder™를 사용하여 FPGA 및 ASIC 설계를 위한 VHDL, Verilog 및 SystemVerilog 코드를 생성할 수 있습니다.

스레드 기반 환경

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

이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

GPU 배열

Parallel Computing Toolbox™를 사용해 GPU(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.

size 함수는 GPU 배열을 완전히 지원합니다. GPU에서 이 함수를 실행하려면 입력 데이터를 gpuArray (Parallel Computing Toolbox)로 지정하십시오. 자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

분산 배열

Parallel Computing Toolbox™를 사용하여 대규모 배열을 클러스터의 결합된 메모리에 걸쳐 분할할 수 있습니다.

이 함수는 분산 배열을 완전히 지원합니다. 자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

R2019b: 차원을 양의 정수로 구성된 벡터 또는 개별 입력 인수로 지정

dim을 양의 정수로 구성된 벡터로 지정하여 한 번에 여러 개의 차원 길이를 쿼리할 수 있습니다. 또는, 쿼리 차원을 개별 입력 인수 dim1,dim2,...,dimN으로 나열할 수 있습니다. 예제는 4차원 배열의 크기 항목을 참조하십시오.

참고 항목

length | strlength | ndims | numel | height | width