Jaki jest symbol podkreślenia _ w Swift References?

W sekcji referencyjnej dokumentacji firmy Apple znajduje się wiele przykładów tego rodzaju rzeczy:

func runAction(_action: SKAction!)

`` Ekwiwalentem '' celu-C tego jest:

- (void)runAction:(SKAction *)action

Uderza mnie, że prawdopodobnie ważne jest, aby (w odwołaniu do języka Swift) była spacja po podkreśleniu i napisie „akcja” kursywą.

Ale nie potrafię zrozumieć, co to próbuje przekazać. Może więc pytanie brzmi ... czy istnieje odniesienie do konwencji użytych w odniesieniach?

- oto strona, do której odwołuję się w tym odwołaniu do użycia podkreślenia: https://developer.apple.com/documentation/spritekit/sknode#//apple_ref/occ/instm/SKNode/runAction

Aktualizacja

Swift 3 wprowadził pewne zmiany w sposobie używania i nazywania nazw parametrów funkcji / metod oraz etykiet argumentów. Ma to konsekwencje dla tego pytania i odpowiedzi. @Rickster wykonuje niesamowitą robotę, odpowiadając na inne pytanie dotyczące _podstawowych wyników w funkcjach, które w większości wyjaśniają ten problem, tutaj: Dlaczego potrzebuję szybko podkreślenia?

Obie odpowiedzi były poprawne, ale chcę wyjaśnić trochę więcej.

_służy do modyfikowania zachowania nazwy parametru zewnętrznego dla metod .

W sekcji Lokalne i zewnętrzne nazwy parametrów dla metod w dokumentacji jest napisane:

Swift domyślnie nadaje pierwszemu parametrowi w metodzie nazwę parametru lokalnego, a drugiemu i kolejnym nazwom parametrów zarówno lokalne, jak i zewnętrzne nazwy parametrów .

Z drugiej strony funkcje domyślnie nie mają nazw parametrów zewnętrznych.

Na przykład mamy tę foo()metodę zdefiniowaną w klasie Bar:

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

Kiedy dzwonisz foo(), nazywa się to jak bar.foo("Hello", s2: "World").

Ale można to zmienić za pomocą _przed s2gdzie jest zadeklarowana.

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

Następnie, kiedy wywołujesz foo, może być po prostu wywołane jak bar.foo("Hello", "World")bez nazwy drugiego parametru.

Wracając do twojego przypadku, runActionto metoda, ponieważ jest SKNodeoczywiście związana z typem . Zatem umieszczenie _parametru przed actionpozwala na wywołanie runActionbez nazwy zewnętrznej.

Aktualizacja dla Swift 2.0

Funkcja i metoda działają teraz w ten sam sposób, jeśli chodzi o deklarację nazwy argumentu lokalnego i zewnętrznego.

Funkcje są teraz wywoływane domyślnie przy użyciu nazwy parametru zewnętrznego, począwszy od drugiego parametru. Ta zasada dotyczy tylko czystego kodu Swift.

Tak więc, dostarczając _przed funkcją funkcję , wywołujący nie będzie musiał określać nazwy parametru zewnętrznego, tak jak zrobiłbyś to dla metody .

Podkreślenie to ogólny token używany do wskazania odrzuconej wartości.

W tym konkretnym przypadku oznacza to, że funkcja zostanie wywołana jako runAction(argument)zamiastrunAction(action:argument)

W innych kontekstach ma inne podobne znaczenie, np. W:

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

Oznacza to, że chcemy po prostu wykonać blok 5 razy i nie obchodzi nas indeks w bloku.

W tym kontekście:

let (result, _) = someFunctionThatReturnsATuple()

Oznacza to, że nie obchodzi nas, jaki jest drugi element krotki, tylko pierwszy.

Od wersji Swift 3 wszystkie etykiety argumentów są domyślnie wymagane .

Możesz wymusić na IDE ukrycie etykiety argumentu za pomocą _.

func foo(a: String) {
}

func foo2(_ a: String) {
}

zadzwonił foo(a: "abc")ifoo2("abc")

Uwaga: To może być stosowany tylko wtedy, gdy ajest etykieta (zewnętrzne) Argument i (wewnętrzne) Nazwa zmiennej w tym samym czasie. Jest równoważne - func foo(a a: String)nie zaakceptuje _.

Dlaczego Apple go używa?

Możesz zobaczyć, że Apple używa go w całym interfejsie API. Biblioteki Apple są nadal napisane w Objective-C (jeśli nie, i tak mają te same nazwy funkcji, które zostały zaprojektowane dla składni Objective-C)

Funkcje takie jak applicationWillResignActive(_ application: UIApplication)miałyby redundantną nazwę parametru application, ponieważ w ich nazwie jest już aplikacja .

Twój przykład

func runAction(_ action: SKAction!)byłby nazywany bez swojego _znaku runAction(action:). Nazwa parametru actionbyłaby zbędna, ponieważ istnieje już w nazwie funkcji. To jest cel i dlaczego tam jest.

Identyfikator przed deklaracją parametru definiuje nazwę parametru zewnętrznego . To jest nazwa, którą musi podać dzwoniący podczas wywoływania funkcji:

func someFunction(externalParameterName localParameterName: Int)

Swift zapewnia automatyczną nazwę zewnętrzną dla każdego zdefiniowanego parametru domyślnego, jeśli sam nie podasz nazwy zewnętrznej. Użycie podkreślenia dla nazwy parametru zewnętrznego wyklucza to zachowanie:

Możesz zrezygnować z tego zachowania, wpisując podkreślenie ( _) zamiast jawnej nazwy zewnętrznej podczas definiowania parametru.

Możesz przeczytać więcej o tym zachowaniu w sekcji Nazwy zewnętrzne dla parametrów z wartościami domyślnymi tutaj .

Myślę, że wymusza to w Swifcie konwencję, która przybliża go do celu-c, co lepiej pasuje do konwencji kakaowych. W objc nie podajesz (zewnętrznie) nazwy swojego pierwszego parametru. Zamiast tego, zgodnie z konwencją, zwykle umieszcza się nazwę zewnętrzną w drugiej części nazwy metody w następujący sposób:

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

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

Aby wywołania Swift api były spójne z objc, będziesz chciał pominąć nazwę parametru zewnętrznego pierwszego parametru.

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

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

W rzeczywistości istnieje różnica między rzeczywistym kodem używanym do zdefiniowania metody a deklaracją metody w dokumentacji Apple. Weźmy UIControl „s - addTarget: Działanie: forControlEvents: Sposób na przykład, prawdziwy kod jest:

Ale w dokumentach wygląda to tak (uwaga _ przed celem):

W prawdziwym kodzie _ służy do tego, aby zewnętrzna nazwa drugiego lub kolejnego parametru nie pojawiała się po wywołaniu metody, podczas gdy w dokumentach _ przed lokalną nazwą parametru wskazuje, że kiedy wywołujesz metodę lub funkcję, nie powinieneś podawać nazwa zewnętrzna.

Nie ma nazwy zewnętrznej, gdy funkcja jest wywoływana domyślnie, chyba że podasz własną lub dodasz # przed (bez spacji) lokalną nazwę parametru, na przykład, tak używamy dispatch_after :

W dokumentach wygląda to tak (zwróć uwagę na trzy _):

Konwencja deklaracji funkcji jest taka sama, jak opisałem dla metody.

Tylko bardziej wizualnie.

Jak widać, po _prostu make pomija lokalną nazwę parametru lub nie.