any

任意の配列要素が非ゼロかどうかを判断

構文

B = any(A)

B = any(A,'all')

B = any(A,dim)

B = any(A,vecdim)

説明

B = any(A) は、サイズが 1 ではない A の最初の配列の次元をテストし、非ゼロの数値か logical 1 (true) である要素が存在するかどうかを判断します。実際、any は論理 OR 演算子を自然に拡張したものです。

• A がベクトルのとき、A の任意の要素が非ゼロの数値または logical 1 である場合、B = any(A) は logical 1 (true) を返します。すべての要素がゼロの場合、logical 0 (false) を返します。

• A が空でない非ベクトル行列である場合、B = any(A) は A の列をベクトルとして取り扱い、logical 1 および 0 の行ベクトルを返します。

• A が空の 0 行 0 列の場合、any(A) は logical 0 (false) を返します。

• A が多次元配列の場合、any(A) は、サイズが 1 でない最初の配列次元に沿って機能し、logical 値からなる配列を返します。この次元のサイズは 1 になりますが、他のすべての次元のサイズは同じままです。

B = any(A,'all') は A のすべての要素にわたってテストします。この構文は、MATLAB^® R2018b 以降で有効です。

B = any(A,dim) は、次元 dim に沿って要素をテストします。dim の入力は、正の整数のスカラーです。

B = any(A,vecdim) はベクトル vecdim に指定された次元に基づいて要素をテストします。たとえば、A が行列の場合、any(A,[1 2]) は A のすべての要素をテストします。これは、次元 1 と次元 2 で定義された配列スライスに行列内のすべての要素が含まれるためです。

例

行列の列のテスト

3 行 3 列の行列を作成します。

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

A = 3×3

     0     0     3
     0     0     3
     0     0     3

各列で非ゼロ要素をテストします。

B = any(A)

B = 1×3 logical array

   0   0   1

論理ベクトルの単一条件への縮小

10 進数の値のベクトルを作成し、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

出力は、論理値のベクトルです。関数 any は、このような logical 値のベクトルを 1 つの条件にまとめます。この例の B = any(A < 0.5) は、logical 1 を返します。

このため、any は特に if ステートメントで便利です。

if any(A < 0.5)

%do something

else

%do something else

end

コードは、矛盾する条件を取る可能性のあるベクトルでなく、単一条件に従って実行されます。

任意の次元の配列のテスト

3×7×5 の多次元配列を作成し、その要素のすべてが 3 を超えるかどうかテストします。

A = rand(3,7,5) * 5;
B = any(A(:) > 3)

B = logical
   1

ゼロ未満の要素の配列もテストできます。

B = any(A(:) < 0)

B = logical
   0

構文 A(:) は、A の要素を 1 つの列ベクトルに変換するため、このタイプのステートメントは任意のサイズの配列で使用できます。

行列の行のテスト

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 の各行に非ゼロ要素があるかどうかをテストします。

B = any(A,2)

B = 3×1 logical array

   1
   1
   1

配列ページの非ゼロ要素

3 次元配列を作成し、データの各ページに非ゼロ要素 (行と列) があるかどうかを判別します。

A(:,:,1) = [2 0; 0 0];
A(:,:,2) = [0 0; 0 0];
A(:,:,3) = [0 0; 0 1];
B = any(A,[1 2])

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

   1


B(:,:,2) =

   0


B(:,:,3) =

   1

入力引数

A — 入力配列

スカラー | ベクトル | 行列 | 多次元配列

入力配列。スカラー、ベクトル、行列または多次元配列として指定します。関数 any は、NaN (非数) である A の要素を無視します。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char
複素数のサポート: あり

dim — 演算の対象の次元

正の整数スカラー

演算の対象の次元。正の整数のスカラーとして指定します。次元を指定しない場合、既定値はサイズが 1 でない最初の配列次元です。

2 次元の入力配列 A について考えます。

• any(A,1) は、A の列の連続する要素に作用し、論理値の行ベクトルを返します。

• any(A,2) は、A の行の連続する要素に対して有効で、論理値の列ベクトルを返します。

データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

vecdim — 次元のベクトル

正の整数のベクトル

次元のベクトル。正の整数のベクトルとして指定します。各要素は入力配列の次元を表します。指定された操作次元の出力の長さは 1 で、その他は同じままです。

2×3×3 の入力配列 A を考えます。この場合、any(A,[1 2]) は、A の各ページの非ゼロ値を示す要素をもつ 1×1×3 の配列を返します。

データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

出力引数

B — logical 配列

スカラー | ベクトル | 行列 | 多次元配列

スカラー、ベクトル、行列または多次元配列として返される logical 配列。any により動作する A の次元のサイズは、B では 1 です。

拡張機能

tall 配列

メモリの許容量を超えるような多数の行を含む配列を計算します。

any 関数は 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) 上で実行することにより、コードを高速化します。

any 関数は、GPU 配列を完全にサポートします。GPU 上で関数を実行するには、入力データを gpuArray (Parallel Computing Toolbox) として指定します。詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

この関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2006a より前に導入

参考

all | colon | or | prod | sum | nnz

トピック

• logical 配列を 1 つの値にする