Что такое символ подчеркивания в Swift References?

В справочном разделе документации Apple есть много примеров такого рода вещей:

func runAction(_action: SKAction!)

Objective-C «эквивалент» этого:

- (void)runAction:(SKAction *)action

Меня поражает, что, вероятно, важно, чтобы (в справочнике по Swift) после подчеркивания был пробел, а «действие» было написано курсивом.

Но я не могу понять, что это пытается передать. Так что, возможно, вопрос в том ... есть ли ссылка на условные обозначения, используемые в ссылках?

- вот страница, на которую я ссылаюсь в этой ссылке на использование подчеркивания: https://developer.apple.com/documentation/spritekit/sknode#//apple_ref/occ/instm/SKNode/runAction

Обновить

Swift 3 внес некоторые изменения в то, как имена и параметры параметров функций / методов и метки аргументов используются и именуются. Это имеет последствия для этого вопроса и его ответа. @Rickster делает потрясающую работу, отвечая на другой вопрос о _underscores в функциях, которые проясняют большую часть этого вопроса, здесь: Зачем мне нужны подчеркивания в swift?

Оба ответа были правильными, но я хочу уточнить немного больше.

_используется для изменения поведения имени внешнего параметра для методов .

В разделе « Локальные и внешние имена параметров для методов » документации говорится:

Swift присваивает первому имени параметра в методе локальное имя параметра по умолчанию и по умолчанию дает второму и последующим именам параметров как локальные, так и внешние имена параметров.

С другой стороны, функции по умолчанию не имеют внешних имен параметров.

Например, у нас есть этот foo()метод, определенный в классе Bar:

class Bar{
    func foo(s1: String, s2: String) -> String {
        return s1 + s2;
    }
}

Когда вы звоните foo(), это называется как bar.foo("Hello", s2: "World").

Но вы можете переопределить это поведение, используя _перед тем, s2где оно объявлено.

func foo(s1: String, _ s2: String) -> String{
    return s1 + s2;
}

Затем, когда вы вызываете foo, он может быть просто назван как bar.foo("Hello", "World")без имени второго параметра.

Возвращаясь к вашему случаю, runActionэто метод, потому что он SKNode, очевидно , связан с типом . Таким образом, установка _параметра before actionпозволяет вам звонить runActionбез внешнего имени.

Обновление для Swift 2.0

Функция и метод теперь работают одинаково с точки зрения объявления имени локального и внешнего аргумента.

Функции теперь вызываются с использованием внешнего имени параметра по умолчанию, начиная со второго параметра. Это правило относится только к чистому коду Swift.

Таким образом, предоставляя _перед функцией функцию , вызывающая сторона не должна будет указывать имя внешнего параметра, так же, как вы делали бы для метода .

Подчеркивание - это общий токен, используемый для обозначения отброшенного значения.

В данном конкретном случае это означает, что функция будет вызываться runAction(argument)вместоrunAction(action:argument)

В других контекстах оно имеет другое подобное значение, например:

for _ in 0..<5 { ... }

Это означает, что мы просто хотим выполнить блок 5 раз, и нам нет дела до индекса внутри блока.

В контексте:

let (result, _) = someFunctionThatReturnsATuple()

Это означает, что нас не волнует, что является вторым элементом кортежа, только первым.

Начиная с Swift 3 все метки аргументов являются обязательными по умолчанию .

Вы можете заставить IDE скрыть метку аргумента с помощью _.

func foo(a: String) {
}

func foo2(_ a: String) {
}

называется foo(a: "abc")иfoo2("abc")

Примечание. Это можно использовать только в том случае, если одновременно aуказана (внешняя) метка аргумента и (внутренняя) переменная . Это эквивалентно - func foo(a a: String)не примет _.

Почему Apple использует это?

Вы можете видеть, что Apple использует его через API. Библиотеки Apple по-прежнему написаны на Objective-C (если нет, они в любом случае имеют одни и те же имена функций, которые были разработаны для синтаксиса Objective-C)

Функции вроде applicationWillResignActive(_ application: UIApplication)бы имеют избыточное имя параметра application, поскольку в имени функции уже есть приложение .

Ваш пример

func runAction(_ action: SKAction!)будет называться без это _метки , как runAction(action:). Имя параметра actionбудет избыточным, так как оно уже есть в имени функции. Это цель и почему это там.

Идентификатор перед объявлением параметра определяет имя внешнего параметра. Это имя, которое должно быть предоставлено вызывающей стороной при вызове функции:

func someFunction(externalParameterName localParameterName: Int)

Swift предоставляет автоматическое внешнее имя для любого заданного по умолчанию параметра, если вы сами не предоставляете внешнее имя. Использование подчеркивания для имени внешнего параметра исключает из этого поведения:

Вы можете отказаться от этого поведения, написав подчеркивание ( _) вместо явного внешнего имени при определении параметра.

Вы можете прочитать больше об этом поведении в разделе « Внешние имена для параметров со значениями по умолчанию» здесь .

Я думаю, что это вызывает соглашение в Swift, которое делает его более близким к target-c, что лучше соответствует соглашениям по какао. В objc вы не (внешне) называете свой первый параметр. Вместо этого по соглашению вы обычно включаете внешнее имя в последнюю часть имени метода следующим образом:

- (void)myFancyMethodWithFirstName:(NSString *)aFirstName lastName:(NSString *)aLastName;

[someInstance myFancyMethodWithFirstName:@"John" lastName:@"Doe"];

Чтобы сделать вызовы Swift API в соответствии с objc, вам нужно подавить имя внешнего параметра первого параметра.

func myFancyMethodWithFirstName(_ firstName:String, lastName:String);

someInstance.myFancyMethodWithFirstName("John", lastName:"Doe")

На самом деле, существует разница между реальным кодом, используемым для определения метода, и объявлением метода в документации Apple. Давайте UIControl «s - addTarget: Действие: forControlEvents: метод, например, реальный код:

Но в документах это выглядит так (обратите внимание _ перед целью):

В реальном коде _ используется, чтобы внешнее имя второго или последующего параметра не появлялось при вызове метода, тогда как в документах _ перед локальным именем параметра указывает, что при вызове метода или функции вы не должны предоставлять внешнее имя.

Нет внешнего имени, когда функция вызывается по умолчанию, если вы не предоставите свое собственное или не добавите # перед (без пробелов) локальным именем параметра, например, вот как мы используем dispatch_after :

И в документах это выглядит так (обратите внимание на три _):

Соглашение об объявлении функции точно такое же, как я описал для метода.

Просто визуально.

Как вы можете видеть, _просто make пропускает локальное имя параметра или нет.