Qual è il rappresentante _ underscore di in Swift References?

Nella sezione di riferimento dei documenti di Apple ci sono molte istanze di questo genere di cose:

func runAction(_action: SKAction!)

L '"equivalente" obiettivo-C di questo è:

- (void)runAction:(SKAction *)action

Mi sembra che sia probabilmente importante che (nel riferimento Swift) ci sia uno spazio dopo il trattino basso e "azione" sia scritto in corsivo.

Ma non riesco a capire cosa stia cercando di trasmettere. Quindi forse la domanda è ... c'è un riferimento per le convenzioni utilizzate nei riferimenti?

- ecco la pagina a cui mi riferisco in questo riferimento all'uso del trattino basso: https://developer.apple.com/documentation/spritekit/sknode#//apple_ref/occ/instm/SKNode/runAction

Aggiornare

Swift 3 ha apportato alcune modifiche al modo in cui vengono utilizzati e denominati i nomi dei parametri di funzione / metodo e le etichette degli argomenti. Ciò ha conseguenze su questa domanda e sulla sua risposta. @Rickster fa un ottimo lavoro nel rispondere a una domanda diversa su _underscores in funzioni che chiariscono gran parte di questo, qui: Perché ho bisogno di sottolineatura in fretta?

Entrambe le risposte erano corrette ma voglio chiarire un po 'di più.

_viene utilizzato per modificare il comportamento del nome di parametro esterno per i metodi .

Nella sezione Nomi dei parametri locali ed esterni della documentazione, dice:

Swift assegna al nome del primo parametro in un metodo un nome di parametro locale per impostazione predefinita e fornisce al secondo e ai nomi dei parametri successivi sia i nomi dei parametri locali che quelli esterni per impostazione predefinita.

D'altra parte, le funzioni di default non hanno nomi di parametri esterni.

Ad esempio, abbiamo questo foo()metodo definito in classe Bar:

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

Quando chiami foo(), si chiama come bar.foo("Hello", s2: "World").

Tuttavia , è possibile ignorare questo comportamento utilizzando _davanti a s2dove è dichiarato.

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

Quindi, quando chiami foo, potrebbe semplicemente essere chiamato come bar.foo("Hello", "World")senza il nome del secondo parametro.

Tornando al tuo caso, runActionè un metodo perché è associato al tipo SKNode, ovviamente. Pertanto, l'inserimento di un _parametro before actionconsente di chiamare runActionsenza un nome esterno.

Aggiornamento per Swift 2.0

La funzione e il metodo ora funzionano allo stesso modo in termini di dichiarazione del nome dell'argomento locale ed esterno.

Le funzioni vengono ora chiamate utilizzando il nome del parametro esterno per impostazione predefinita, a partire dal 2o parametro. Questa regola si applica solo al codice Swift puro.

Quindi, fornendo un _davanti a una funzione , il chiamante non dovrà specificare il nome del parametro esterno, proprio come si farebbe per un metodo .

Il carattere di sottolineatura è un token generale utilizzato per indicare un valore scartato.

In questo caso specifico, significa che la funzione verrà invocata come runAction(argument)anzichérunAction(action:argument)

In altri contesti ha altri significati simili, ad esempio in:

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

Significa che vogliamo semplicemente eseguire il blocco 5 volte e non ci interessa l'indice all'interno del blocco.

In questo contesto:

let (result, _) = someFunctionThatReturnsATuple()

Significa che non ci interessa quale sia il secondo elemento della tupla, solo il primo.

Da Swift 3 tutte le etichette degli argomenti sono richieste per impostazione predefinita .

È possibile forzare un IDE con cui nascondere un'etichetta argomento _.

func foo(a: String) {
}

func foo2(_ a: String) {
}

chiamato foo(a: "abc")efoo2("abc")

Nota: questo può essere usato solo quando si atrovano contemporaneamente l' etichetta dell'argomento (esterno) e il nome della variabile (interna) . È equivalente - func foo(a a: String)non accetta il _.

Perché lo sta usando Apple?

Puoi vedere che Apple lo sta usando attraverso l'API. Le librerie di Apple sono ancora scritte in Objective-C (in caso contrario, condividono comunque gli stessi nomi di funzioni, che sono state progettate per la sintassi Objective-C)

Funzioni come applicationWillResignActive(_ application: UIApplication)avrebbero un nome di parametro ridondanteapplication , poiché esiste già l' applicazione nel suo nome di funzione.

Il tuo esempio

func runAction(_ action: SKAction!)sarebbe chiamato senza il suo _segno come runAction(action:). Il nome del parametro actionsarebbe ridondante poiché ce n'è già uno nel nome della funzione. Questo è lo scopo e perché è lì.

Un identificatore davanti alla dichiarazione di parametro definisce un nome di parametro esterno . Questo è il nome che deve essere fornito dal chiamante quando chiama la funzione:

func someFunction(externalParameterName localParameterName: Int)

Swift fornisce un nome esterno automatico per qualsiasi parametro predefinito definito, se non si fornisce un nome esterno da soli. L'utilizzo di un carattere di sottolineatura per il nome del parametro esterno esclude questo comportamento:

È possibile annullare questo comportamento scrivendo un carattere di sottolineatura ( _) anziché un nome esterno esplicito quando si definisce il parametro.

Puoi leggere ulteriori informazioni su questo comportamento nella sezione Nomi esterni per parametri con valori predefiniti qui .

Penso che questo costringa una convenzione in Swift che la renda più vicina all'obiettivo-c, che corrisponda meglio alle convenzioni sul cacao. In objc non si nomina (esternamente) il primo parametro. Invece, per convenzione di solito includi il nome esterno nell'ultima parte del nome del metodo in questo modo:

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

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

Per rendere le chiamate API Swift coerenti con objc, è necessario sopprimere il nome del parametro esterno del primo parametro.

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

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

In realtà, c'è una differenza tra il codice reale utilizzato per definire un metodo e la dichiarazione del metodo nei documenti di Apple. Prendiamo UIControl s' - addTarget: azione: forControlEvents: metodo per esempio, il codice reale è:

Ma nei documenti, appare così (nota _ prima del target):

Nel codice reale, _ viene utilizzato per non visualizzare il nome esterno del secondo o successivo parametro quando viene chiamato un metodo, mentre nei documenti, _ prima che il nome locale di un parametro indichi che quando si chiama un metodo o una funzione, non è necessario fornire un nome esterno.

Non esiste un nome esterno quando una funzione viene chiamata per impostazione predefinita a meno che tu non fornisca il tuo o aggiunga # prima (senza spazi bianchi) il nome locale di un parametro, ad esempio, è così che utilizziamo dispatch_after :

E nei documenti, appare così (nota tre _):

La convenzione della dichiarazione della funzione è la stessa che ho descritto per il metodo.

Solo più visivamente.

Come puoi vedere _basta omettere o meno un nome di parametro locale.