Swiftのメソッドの自然言語文中での表記法


自然言語文中にメソッド名を記述するときに、Objective-Cでは+[Foo bar]や-[Foo
baz:qux:]の様に書いたと思いますが、Swiftではどのように書くのが一般的でしょうか？




Rubyだとインスタンスメソッドは`Range#each`のように「#」で繋いで書き、クラスメソッドは`Range.new`のように「.」で繋いで書きます。このようなドキュメントや本を書く上で標準化された表記法のルールがあるか、という質問ですよね？

Objective-Cでは`+[Foo bar]`や`-[Foo
baz:qux:]`のように「+」と「-」で区別し、あるいは文脈でレシーバが明らかなら、`-objectsForKeys:notFoundMarker:`などと書くのが慣例的に行われてきたと思います。

Swiftは今のところはっきりと決まったものは無いと思います。

強いていえば単体のメソッドやfunctionはアップルのドキュメントに倣って`drawRect(_:)`のように書いている本やサイトが多いと思います。

Rubyのようにクラスメソッドとインスタンスメソッド（あるいはStaticメソッド）をうまく区別する表記法は無くて、区別なく`Array.append(_:)`のように単にドットで繋げて書いていることが多数のようです。

