Swiftらしい関数名の命名のコツ by Ryomm

Swiftの関数名の命名についてお悩みの方はいませんか！？
命名を適切に行うことで、コードの可読性やメンテナンス性を大きく向上させることができます。

Swiftの命名規則に関して参考になるものとして、Swift API Design GuidelinesというドキュメントがAppleから提供されています。
このドキュメントを読むと、Swiftの関数名の命名においては、関数を使用するときの「明瞭さ」そして「自然な文章としての読みやすさ」の2つが重視されていることがわかります。
明瞭で自然な命名をしようと思っても、英語が達者でもない場合、難しいと感じることが多いです。
私自身命名が正しいかどうか思い悩む日々を過ごす中、前置詞を効果的に使うことで明瞭かつ自然な命名ができることに気づきました！
例えば setY(_ x:) という関数があったとき、XとYがどのように関係しているのかわかりますか？このように、関係性が不明瞭なときに
前置詞が役立ちます。

本稿では、Swift API Design Guidelinesをもとに関数名の付け方の基本を説明した上で、英文法から考えるSwiftらしい関数名の命名について紹介します。

• Swift API Design Guidelines で言及されている命名規則
• 英文法から考える関数名
• 引数ラベルに使えそうな前置詞早見表