Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

le, <=

以下かどうかの判別

ページ内をすべて折りたたむ

構文

A <= B
le(A,B)

説明

例

A <= B は logical 配列を返します。この配列の要素は、A が B 以下である場合には logical 1 (true) に設定され、そうでない場合は logical 0 (false) になります。テストでは、数値配列の実数部のみが比較されます。le は、A または B が NaN または未定義の categorical 要素をもつ場合には、logical 0 (false) を返します。

le(A,B) は A <= B の代替方法として実行できますが、まれにしか使われません。これにより、クラスの演算子のオーバーロードが可能です。

例

すべて折りたたむ

ライブ スクリプトを開く

指定された値以下のベクトル要素を見つけます。

数値ベクトルを作成します。 

A = [1 12 18 7 9 11 2 15];

ベクトルをテストし、12 以下の要素を見つけます。 

A <= 12
ans = 1x8 logical array

   1   1   0   1   1   1   1   0

結果は、A の要素が式を満たす場合には、logical 1 (true) を含むベクトルです。

logical 値のベクトルをインデックスとして使用して、12 以下の A の値を表示します。

A(A <= 12)
ans = 1×6

     1    12     7     9    11     2

結果は、A の要素のサブセットです。

ライブ スクリプトを開く

行列を作成します。 

A = magic(4)
A = 4×4

    16     2     3    13
     5    11    10     8
     9     7     6    12
     4    14    15     1

9 以下の値をすべて値 10 に置き換えます。 

A(A <= 9) = 10
A = 4×4

    16    10    10    13
    10    11    10    10
    10    10    10    12
    10    14    15    10

結果は、最小の要素が 10 である新しい行列です。

ライブ スクリプトを開く

順序 categorical 配列を作成します。 

A = categorical({'large' 'medium' 'small'; 'medium' ...
'small' 'large'},{'small' 'medium' 'large'},'Ordinal',1)
A = 2x3 categorical
     large       medium      small 
     medium      small       large

この配列には、'small'、'medium' および 'large' の 3 つのカテゴリがあります。

カテゴリ 'medium' 以下の値をすべて見つけます。 

A <= 'medium'
ans = 2x3 logical array

   0   1   1
   1   1   0

logical 1 (true) は、カテゴリ 'medium' 以下の値を示します。

A の行を比較します。 

A(1,:) <= A(2,:)
ans = 1x3 logical array

   0   0   1

関数は、最初の行のカテゴリ値が 2 番目の行以下である場合には、logical 1 (true) を返します。

ライブ スクリプトを開く

複素数のベクトルを作成します。 

A = [1+i 2-2i 1+3i 1-2i 5-i];

3 以下の値を見つけます。 

A(A <= 3)
ans = 1×4 complex

   1.0000 + 1.0000i   2.0000 - 2.0000i   1.0000 + 3.0000i   1.0000 - 2.0000i

le は、A の要素の実数部のみを比較します。

abs を使用して、原点から 3 の半径の内部にある要素を見つけます。

A(abs(A) <= 3)
ans = 1×3 complex

   1.0000 + 1.0000i   2.0000 - 2.0000i   1.0000 - 2.0000i

その結果、要素が 1 つ少なくなりました。要素 1.0000 + 3.0000i は、原点から 3 の半径内にありません。

ライブ スクリプトを開く

duration 配列を作成します。

d = hours(21:25) + minutes(75)
d = 1x5 duration
   22.25 hr   23.25 hr   24.25 hr   25.25 hr   26.25 hr

配列をテストし、1 標準日以下の要素を見つけます。

d <= 1
ans = 1x5 logical array

   1   1   0   0   0

入力引数

すべて折りたたむ

オペランド。スカラー、ベクトル、行列または多次元配列として指定します。入力 A と B は、同じサイズであるか、互換性のあるサイズでなければなりません (たとえば、A が M 行 N 列の行列で、B がスカラーまたは 1 行 N 列の行ベクトル)。詳細については、基本的な演算で互換性のある配列サイズを参照してください。

任意の型の数値入力を比較でき、比較は型変換による精度低下の悪影響を受けません。

  • 一方の入力が順序 categorical 配列である場合、他方の入力には順序 categorical 配列、文字ベクトルの cell 配列または単一の文字ベクトルを指定できます。単一の文字ベクトルは、他方の入力と同じサイズの文字ベクトルの cell 配列に拡張されます。両方の入力が順序 categorical 配列である場合は、順序を含めて同じカテゴリ セットでなければなりません。詳細については、categorical 配列の要素の比較を参照してください。

  • 一方の入力が datetime 配列である場合、他方の入力には datetime 配列、文字ベクトル、または文字ベクトルの cell 配列を指定できます。

  • 一方の入力が duration 配列である場合、他方の入力には duration 配列または数値配列を指定できます。この演算子は各数値を標準日 (24 時間) の数として扱います。

  • 一方の入力が string 配列の場合、他方の入力には string 配列、文字ベクトル、または文字ベクトルの cell 配列を指定できます。A と B の対応する要素は、辞書順に比較されます。

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

ヒント

  • 一部の浮動小数点数は、バイナリ形式で正確に表現できません。これにより、<= 演算子が反映する結果に若干の違いが生じます。詳細については、浮動小数点演算によくある問題の回避を参照してください。

拡張機能

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。

GPU コード生成
GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

HDL コード生成
HDL Coder™ を使用して FPGA 設計および ASIC 設計のための Verilog および VHDL のコードを生成します。

バージョン履歴

R2006a より前に導入

すべて展開する

参考

| | | |

トピック