コーディング規則
コーディング規約は、効率と API の使用と明快さと、API の命名法の一貫性を保証するのに役立つ一連のガイドラインです。コード内の使用規則に従う場合は、実行時の例外などとして問題を経験する可能性が低くなります。命名規則に従っている場合は、いずれのメソッドも、関数、定数、または宣言した他の記号は、コードを共にする必要のある開発者によりよく理解されるでしょう。
Cocoa フレームワークで定義されているメソッドは、たとえば、Foundation、AppKit、UIKit は異なる状況で特定の方法で、動作します。たとえば、次のように：
- 通常、オブジェクトを返すメソッドは、オブジェクトを作成したり、見つけられなかった場合、nil を返します。それらは直接ステータスコードを返しません。
- 操作を実行するメソッドは、成功または失敗を示すブール値を返します。
- メソッドが、コレクション・オブジェクトを取る場合、つまり、NSArray、NSDictionary、または NSSet のオブジェクトの場合、"デフォルト" または"値なし" を示すために nil を指定しないでください。代わりに、空のコレクションオブジェクトを渡します。
- 明示的にプログラムメモリを管理している場合は、メモリ管理のためのガイドラインと実践に従ってください。
- 明瞭かつ簡潔に。両方とも重要ですが、明瞭さは簡潔さのために犠牲にしてはいけません。
- あいまいな名前は避けてください。
- アクションを表すメソッドや関数の名前に動詞を使用してください。
- クラス名に、関数とデータ型のような物としてクラスに関連付けられたシンボルとプレフィックスを使用して下さい。
API の命名規則をサンプリングすると、次のとおりです。
前提条件の記事
(なし)
関連記事
既出の議論
ココアのコーディングのガイドライン
次の章
前の章