Параметры Swift метода в документации

Question

Иногда я вижу методы Swift, задокументированные как application(_:didFinishLaunchingWithOptions:) или tableView(_:cellForRowAtIndexPath:). Где документированы эти общие документы документации по документам? Например: где я могу увидеть, что означает подчеркивание, как интерпретировать несколько параметров метода, задокументированных таким образом и т. Д.

Answer 1

Конвенция проиллюстрирована в The Swift Programming Language: Functions. Это внешняя подпись функции, то есть то, что вам нужно знать, чтобы назвать ее. Он состоит из имени функции, плюс все метки аргументов для всех параметров этой функции.

Рассмотрим

func greet(person: String) -> String { 
    ... 
} 

Это greet(person:) функция.

Но учтите следующее, несколько более сложный, Swift 3 UITableViewDataSource метод:

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell { 
    ... 
} 

Здесь каждый из этих двух параметров имеет как метка аргумент (то, что используется, когда вызывается функция), а затем имя параметра (что используется для обозначения этого параметра внутри самой функции). В этом случае первый параметр не имеет метки аргумента (обозначается _), но это имя tableView. Метка аргумента второго параметра - cellForRowAt, а имя - indexPath.

В этом случае, вы будете видеть выше UITableViewDataSource метод, на который ссылается в качестве tableView(_:cellForRowAt:): Имя функции является tableView, то первый параметр не имеет аргумента метки (обозначенный _), а второй параметр имеет аргумент метку cellForRowAt.

---

Как и в сторону, в Swift версии 2, метка аргумент первого параметра по умолчанию будет _ (т.е. без метки), если явно не указано иное. Эффективный Swift 3, первый параметр работает с теми же самыми всеми другими параметрами, по умолчанию, независимо от имени параметра (поэтому вы увидите в этом случае _, чтобы явно указать, что этот первый параметр функции Swift 3 не имеет значения, t есть метка).