ヨーダ記法(ヨーダきほう、Yoda notation)またはヨーダ条件式(ヨーダじょうけんしき、Yoda conditions)とは、プログラミングにおけるジャーゴンのひとつで、If文などの条件式において比較するふたつの要素を一般的な順序と逆に記述するプログラミングスタイルをいう。ヨーダ記法では条件式の左辺(比較演算子の左オペランド)に定数を配置する。

映画『スター・ウォーズ』シリーズの登場人物・ヨーダが、標準的ではない英語の文法で話すことに由来する。

ヨーダ記法はWordPressやSymfonyのPHPコーディング標準の一部に採用されている。一方、CakePHPのコーディング規約では、ヨーダ記法は避けるべきとされている。

## 例

例えばC言語やC++において、`int`型の変数`value`の値を調べて分岐する`if`文は、多くの場合、以下のように記述される。

ヨーダ記法では同様の式を逆に記述する。

等値比較の演算子`==`の左オペランドと右オペランドは入れ替えても結果に変わりはないことを利用している。

定数`42`は比較演算子`==`の左側に書かれ、中身を調べようとしている変数`value`は右側に書かれるという順序を、ヨーダの独特のしゃべり方(目的語-主語-動詞、OSV型)に見立てている。(例: “When nine hundred years old you reach, look as good you will not.")

## 利点

式における定数の位置はプログラムの挙動を変更しない(ただし後述のようにfalseに評価される場合や、ユーザー定義の演算子オーバーロードが存在する場合を除く)。

Cに代表されるような、代入演算子に等号ひとつ (`=`) を使い、等値比較の演算子には`==`などの別のトークンを使うプログラミング言語では、比較式のつもりで代入式を書いてしまう間違いが見られる。

例えばC/C++では下記コードは合法であり、コンパイルエラーにならない。代入演算子`=`は左辺に格納されたものと同じ値もしくは参照(左辺値)を返すからである。結果として、プログラムの実行段階になってようやく動作異常に気づき、記述ミスの発覚が遅れる可能性がある。

上記をヨーダ記法で書き換えると、以下のようになる。

`42`は定数であり、変更されない(できない)ため、このエラーはコンパイラに捕捉される。結果として、コンパイル段階で記述ミスに気づくことができる。

### Java/C#のブーリアン

C/C++とは異なり、JavaやC#の場合は、条件式の型はそれぞれ`boolean`や`bool`でなければならない仕様となっている。そのため、条件式を書くべきところに間違えて代入式を記述してしまっても、ほとんどのケースではコンパイルエラーになるが、例外もある。

例えば下記はJavaでも合法であり、コンパイルエラーにはならないが、本来プログラマーが意図していたコードは`flag == true`である。

このようなミスを防ぐためには、`flag != false`と書くか、あるいはヨーダ記法を使って`true == flag`と書く方法もあるが、そもそも`boolean`型の変数を`true`や`false`と比較するのは冗長である。真を期待する場合は条件式にそのまま使用し、偽を期待する場合は論理否定演算子`!`で反転してから条件式に使用すればよい。

### 暗黙変換の回避

下記はJavaにおいて、プリミティブラッパークラス`java.lang.Boolean`からプリミティブ型`boolean`への暗黙的なボックス化解除(オートアンボクシング)が実行されることで異常動作を引き起こす例である。

ヨーダ記法では:

Java 8以降は`java.util.Objects.isNull(Object)`を使う方法もある。

C#の場合は`bool`のような組み込みの値型もすべて`System.ValueType`から派生するオブジェクトであり、プリミティブラッパークラスのようなものは不要である。また、暗黙的なボックス化解除もされず、値を取り出すにはキャスト演算子を使って明示的に変換する必要があるため、上記のような問題は起きない。ただし、`bool`への暗黙変換演算子をユーザー定義していたり、`true`/`false`演算子をユーザー定義していたりすると、上記のJavaにおける例のような間違ったコードを書くことができてしまう。とはいえ、2つの参照の等値性比較には`Object.ReferenceEquals(Object, Object)`を使うことができるし、C# 7.0以降は`is`演算子を使って`if (obj is null) {...}`と書くこともできるので、問題を避けるためにヨーダ記法を使う必要はない。

### nullの回避

また、null値のデリファレンスによる危険な振る舞いを回避するのに使える場合もある。

ヨーダ記法では:

Java 7以降は`java.util.Objects.equals(Object, Object)`を使う方法もある。ただし文字列の大文字・小文字を区別せずに比較する場合、インスタンスメソッドの`String.equalsIgnoreCase(String)`を使う必要がある。

C#の場合は文字列の比較にはインスタンスメソッドの`Object.Equals(Object)`ではなく、両辺に`null`を許可する`==`演算子オーバーロードを使い、また前述のように条件式の型は`bool`でなければならないため、少なくとも文字列の比較に関してヨーダ記法を使う必要はない。大文字・小文字を区別せずに比較する場合、インスタンスメソッドだけでなく`null`を許可する静的メソッドも用意されている。

### 見切れた場合の可読性向上

正確にはヨーダ記法固有の利点ではないが、比較演算子を左側に寄せることにより人によっては可読性が増すという長所もある。特にこの長所は略語を使わない文化や型無しのオブジェクト指向言語で顕著となる。(型が無い場合は名前の重複を避けるためメソッドにつける名前が長くなりやすい)

例えばSmalltalkによる上記の例を差分比較用のエディターや、参考用コードを表示するため横幅を縮めて画面端に置いたエディターなどで表示すると下記のように見切れてしまう。また入れ子の関係で字下げが深くなってしまった場合も同様に見切れてしまう。

上記のように比較演算子を左に寄せている場合(結果的にヨーダ記法)は、定数と演算子により各行が何をしているか推測できるが、比較演算子を右に寄せた場合、重要な情報がすべて見切れてしまい、各行が何をしているか推測が困難となる。

## PowerShell

PowerShellでは、代入演算子に`=`を使い、比較演算子には別のトークンを使う仕様となっているが、`-eq`演算子(または`-ne`演算子)の左オペランドに、配列のようなコレクションを指定すると、右オペランドと一致する要素を含むサブ配列(または一致する要素を含まないサブ配列)が返却される。

そのため、コレクション変数自体を`$null`と比較する場合、必ず演算子の左オペランドに`$null`を指定するヨーダ記法を使わなければならない。

PowerShellは動的型付け言語であるため、変数は特定の型に束縛されず、プログラムの実行途中で(再代入によって)型が変化する可能性がある。変数にコレクション型の値が格納されているか否かを問わず、nullチェックの際は常に`$null`を比較演算子の左側に置くことがベストプラクティスとされている。

## 批判

ヨーダ記法の批判者は、可読性の欠如が上記の利点を上回っていると考えている。比較式の左辺に、本来の主語である変数が出現する順序のほうが、コードを自然言語に置き換えて読むときに理解しやすくなるからである。また、比較式の両辺のうち、少なくとも片方が再代入不可能な定数である場合はエラー捕捉の効果を発揮するが、ともに再代入可能な変数である場合は意味をなさない。

PythonやKotlin、Swiftなどいくつかの後発プログラミング言語では、`=`による代入が式ではなく文であったり、あるいは代入演算子`=`が値を返さないようにしていたりすることで、条件式中の代入を許容しない設計になっており、そういった言語を用いる場合はこの種の不具合を作りこむことがそもそも不可能になる。そのため、わざわざヨーダ記法を用いる理由はどこにもない。

またC/C++のように潜在的に問題を抱えた言語であっても、多くのコンパイラは`if (myNumber = 42)`のようなコードに対して、記述ミスのおそれがあるとして警告を表示する。ただし、コンパイラ警告は無視することも可能であるため、不注意なプログラマーは警告に気づかずミスを犯すかもしれない。警告をエラーとして扱うように設定して無視させないように構成することもできるが、コードの書き方によっては警告を出さなくなるコンパイラもある。そのようなコードであっても問題を検出できるようにするために、静的コード解析ツールが併用されることもある。

SEI CERT C Coding Standardではかつて「EXP21-C. Place constants on the left of equality comparisons」という項目をレコメンデーション(推奨事項)としていたが、独立した項目としては2014年に削除され、EXP45-Cなどにおける限定的な解決策のひとつとして例示されるだけとなっている。なお、JPCERT/CCによる日本語版は更新されておらず、項目の削除が反映されていない。

nullの振る舞いを回避できる利点についても、ヌルポインタエラーを隠蔽し発覚が遅れるという意味では欠点と考えることができる。入力としてnullを許可しないコードであった場合、本来は事前のnullチェック処理を明示的に記述し、実際に入力を使用する箇所ではnon-nullになることを保証すべきだが、ヨーダ記法で書くと事前のnullチェックを省略できてしまい、意図せずnullを許可するコードになってしまう。

そのほか、C++において非基本型を `==` 演算子で比較する際、適切な演算子オーバーロードが存在しない場合があることも欠点に挙げられる。例えば、ATLの`CComBSTR`を文字列リテラルと比較するとき、`if (L"Hello" == cbstrMessage)`と記述すると、`CComBSTR`によるメンバー演算子オーバーロード`CComBSTR::operator ==`は使用されない。代わりに暗黙の型変換演算子オーバーロード`CComBSTR::operator BSTR`が使用され、結果として文字列ではなくポインタ同士の比較が実行されてしまう。`_bstr_t`にも同様の問題がある。もっとも、この点に関してはヨーダ記法の問題というより、演算子オーバーロードの定義の仕方に問題がある。等値比較演算子`==`は本来オペランドの交換法則を満たすべきであり、このような組み込み型に対する通常の演算子の意味から逸脱するような振る舞いをする演算子オーバーロードは、便利というより混乱を招くだけである。