ドキュメンテーション センター

  • 評価版
  • 製品アップデート

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

any

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

構文

  • B = any(A)
  • B = any(A,dim)

説明

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

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

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

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

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

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

すべて展開する

行列の列のテスト

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

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

     0     0     3
     0     0     3
     0     0     3

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

B = any(A)
B =

     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 = 

0   0   1   1   1   1   0

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

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

if any(A < 0.5)
    %do something
else
    %do something else
end

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

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

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

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

     1

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

B = any(A(:) < 0)
B =

     0

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

行列の行のテスト

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

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

     0     0     3
     0     0     3
     0     0     3

dim = 2 を指定して、A の行の非ゼロ要素をテストします。

B = any(A,2)
B =

     1
     1
     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

出力引数

すべて展開する

B - 論理配列スカラー | ベクトル | 行列 | 多次元配列

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

参考

| | | | | | |

この情報は役に立ちましたか?