all

모든 배열 요소가 0이 아닌 값 또는 true인지 확인

구문

B = all(A)

B = all(A,'all')

B = all(A,dim)

B = all(A,vecdim)

설명

B = all(A)는 A에서 크기가 1이 아닌 첫 번째 배열 차원에 따라 테스트하고 요소가 모두 0이 아닌 값이거나 논리값 1(true)인지를 확인합니다. 사실상 all은 논리 연산자 AND의 확장된 개념이라고 할 수 있습니다.

• A가 벡터인 경우 all(A)은 모든 요소가 0이 아니면 논리값 1(true)을 반환하고 요소 중 하나 이상이 0이면 논리값 0(false)을 반환합니다.

• A가 비어 있지 않은 행렬인 경우 all(A)는 A의 열을 벡터로 취급하고 논리값 1과 0으로 구성된 행 벡터를 반환합니다.

• A가 빈 0×0 행렬인 경우 all(A)은 논리값 1(true)을 반환합니다.

• A가 다차원 배열인 경우 all(A)은 크기가 1이 아닌 첫 번째 배열 차원을 따라 동작을 수행하고 논리값으로 구성된 배열을 반환합니다. 이 차원의 크기는 1이 되고 다른 모든 차원의 크기는 변경되지 않습니다.

B = all(A,'all')은 A의 모든 요소를 테스트합니다. 이 구문은 MATLAB^® 버전 R2018b 이상에서 유효합니다.

B = all(A,dim)은 차원 dim을 따라 요소를 테스트합니다. dim 입력값은 양의 정수 스칼라입니다.

B = all(A,vecdim)은 벡터 vecdim에 지정된 차원을 기준으로 요소를 테스트합니다. 예를 들어, A가 행렬인 경우 all(A,[1 2])는 1번째 차원과 2번째 차원으로 정의된 배열 슬라이스가 행렬의 모든 요소를 포함하므로, 결국 A의 모든 요소를 테스트하게 됩니다.

예제

행렬 열 테스트

3×3 행렬을 만든 다음, 각 열의 요소가 모두 0이 아닌지를 테스트합니다.

A = [0 0 3;0 0 3;0 0 3]

A = 3×3

     0     0     3
     0     0     3
     0     0     3

B = all(A)

B = 1×3 logical array

   0   0   1

논리형 벡터를 단일 조건으로 축소

소수로 구성된 벡터를 만들어 어느 값이 0.5보다 작은지를 테스트합니다.

A = [0.53 0.67 0.01 0.38 0.07 0.42 0.69];
B = (A < 0.5)

B = 1×7 logical array

   0   0   1   1   1   1   0

출력값은 논리값으로 구성된 벡터입니다. all 함수는 이러한 논리값으로 구성된 벡터를 단일 조건으로 축소합니다. 이 경우 B = all(A < 0.5)는 논리값 0을 생성합니다.

따라서 all은 if 문에 특히 유용합니다.

if all(A < 0.5)

%do something

else

%do something else

end

상충할 수 있는 여러 조건의 벡터가 아니라 단일 조건에 따라 코드가 실행됩니다.

모든 차원의 배열 테스트

3×7×5 다차원 배열을 만들어 모든 요소가 3보다 작은지를 테스트합니다.

A = rand(3,7,5) * 5;
B = all(A(:) < 3)

B = logical
   0

또한 배열의 요소가 0보다 큰지를 테스트할 수도 있습니다.

B = all(A(:) > 0)

B = logical
   1

구문 A(:)은 A의 요소를 단일 열 벡터로 바꾸어 이 유형의 명령문을 크기에 관계없이 모든 배열에 사용할 수 있게 합니다.

행렬 행 테스트

3×3 행렬을 만듭니다.

A = [0 0 3;0 0 3;0 0 3]

A = 3×3

     0     0     3
     0     0     3
     0     0     3

dim = 2를 지정하여 A의 행에서 모든 요소가 0이 아닌지를 테스트합니다.

B = all(A,2)

B = 3×1 logical array

   0
   0
   0

배열 페이지의 0이 아닌 요소

3차원 배열을 만들고 데이터의 각 페이지(행과 열)의 모든 요소가 0인지 여부를 확인합니다.

A(:,:,1) = [2 1; 3 5];
A(:,:,2) = [0 0; 0 0];
A(:,:,3) = [-2 9; 4 1];
B = all(A,[1 2])

B = 1×1×3 logical array
B(:,:,1) =

   1


B(:,:,2) =

   0


B(:,:,3) =

   1

입력 인수

A — 입력 배열

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

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

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

dim — 연산을 수행할 차원

양의 정수 스칼라

연산을 수행할 차원으로, 양의 정수 스칼라로 지정됩니다. 차원을 지정하지 않을 경우, 디폴트 값은 크기가 1이 아닌 첫 번째 배열 차원이 됩니다.

2차원 입력 배열 A가 있다고 가정하겠습니다.

• all(A,1)은 A의 열에 있는 연속된 요소에 대해 동작을 수행하고 논리값으로 구성된 행 벡터를 반환합니다.

• all(A,2)는 A의 행에 있는 연속된 요소에 대해 동작을 수행하고 논리값으로 구성된 열 벡터를 반환합니다.

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

vecdim — 차원의 벡터

양의 정수로 구성된 벡터

차원의 벡터로, 양의 정수로 구성된 벡터로 지정됩니다. 각 요소는 입력 배열의 차원을 나타냅니다. 지정된 연산 차원의 출력값의 길이는 1이고, 다른 모든 차원의 길이는 변경되지 않습니다.

2×3×3 입력 배열 A가 있다고 가정하겠습니다. all(A,[1 2])는 1×1×3 배열을 반환하는데 이 배열의 요소는 A의 각 페이지에서 0이 아닌 값을 나타냅니다.

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

출력 인수

B — 논리형 배열

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

논리형 배열로, 스칼라, 벡터, 행렬, 다차원 배열 중 하나로 반환됩니다. all이 동작을 수행하는 A의 차원 크기는 B에 1로 지정되어 있습니다.

확장 기능

tall형 배열

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

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

C/C++ 코드 생성

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

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

• 입력 인수 A에 대해 다음이 적용됩니다.

  • 차원을 지정하지 않을 경우 코드 생성기는 입력 배열에서 가변 크기이거나 크기가 1이 아닌 첫 번째 차원을 따라 연산을 수행합니다. 이 차원이 코드 생성 시점에 가변 크기이고 런타임에 1인 경우, 런타임 오류가 발생할 수 있습니다. 이 오류를 피하려면 차원을 지정하십시오.

  • 코드 생성 시 입력 배열의 모든 차원이 가변 크기이면 이 배열은 런타임에 비어 있을 수 없습니다.

• dim 인수가 사용될 경우, 이 인수는 코드 생성 시 상수여야 합니다.

HDL 코드 생성

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

double 데이터형은 지원되지 않습니다.

스레드 기반 환경

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

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

GPU 배열

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

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

분산 배열

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

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

버전 내역

R2006a 이전에 개발됨

참고 항목

any | and | allunique | colon | prod | sum

도움말 항목

• 논리형 배열을 단일 값으로 축소