Swift Referanslar'ın _ alt çizgi temsilcisi nedir?

Apple'ın dokümanlarının referans bölümünde bu tür şeylerin birçok örneği var:

func runAction(_action: SKAction!)

Bunun Objective-C 'eşdeğeri':

- (void)runAction:(SKAction *)action

Bana (Swift referansında) alt çizgiden sonra bir boşluk olması ve "eylem" italik yazılması önemli olabilir.

Ama bunun ne aktarmaya çalıştığını anlayamıyorum. Belki de soru şu ... referanslarda kullanılan sözleşmeler için bir referans var mı?

- işte bu altçizgi referansına atıfta bulunduğum sayfa: https://developer.apple.com/documentation/spritekit/sknode#//apple_ref/occ/instm/SKNode/runAction

Güncelleme

Swift 3, işlev / yöntem parametre adlarının ve bağımsız değişken etiketlerinin kullanılması ve adlandırılmasında bazı değişiklikler yaptı. Bunun bu soru ve cevabı hakkında sonuçları var. @Rickster, bunun çoğunu temizleyen işlevlerde _underscores hakkında farklı bir soruya cevap vermek için inanılmaz bir iş çıkarıyor: Burada neden hızlı bir şekilde alt çizgilere ihtiyacım var?

Her iki cevap da doğruydu ama biraz daha açıklığa kavuşturmak istiyorum.

_için kullanılan yöntemler için dış parametre adı davranışını değiştirmek .

In Yerel ve Yöntemler için harici Parametre Adları belgelerin bölümünde, diyor:

Swift, bir yöntemdeki ilk parametre adını varsayılan olarak yerel bir parametre adı verir ve ikinci ve sonraki parametre adlarına varsayılan olarak hem yerel hem de harici parametre adlarını verir .

Öte yandan, varsayılan olarak işlevlerin harici parametre adları yoktur.

Örneğin, bu foo()yöntem sınıfta tanımlanmıştır Bar:

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

Aradığınızda buna foo()denir bar.foo("Hello", s2: "World").

Ancak , bildirildiği yerin _önünde kullanarak bu davranışı geçersiz kılabilirsiniz s2.

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

Sonra, aradığınızda foo, bar.foo("Hello", "World")ikinci parametrenin adı olmadan basitçe çağrılabilir .

Sizin durumunuza geri dönersek, runActionbir yöntemdir, çünkü SKNodeaçıkçası türle ilişkilendirilmiştir . Bu nedenle, bir _before parametresi koymak, harici bir ad olmadan actionçağrı yapmanızı sağlar runAction.

Swift 2.0 Güncellemesi

İşlev ve yöntem artık yerel ve harici argüman adı bildirimi açısından aynı şekilde çalışmaktadır .

Fonksiyonlar artık 2. parametreden başlayarak varsayılan olarak harici parametre adı kullanılarak çağrılmaktadır. Bu kural yalnızca saf Swift kodu için geçerlidir.

Bu nedenle, _bir işlevin önüne bir giriş sağlayarak , arayanın bir yöntem için ne yapacağınız gibi harici parametre adı belirtmesi gerekmez .

Alt çizgi, atılan bir değeri belirtmek için kullanılan genel bir simgedir.

Bu özel durumda, işlev runAction(argument)yerinerunAction(action:argument)

Diğer bağlamlarda başka benzer anlamları vardır, örneğin:

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

Bu, sadece bloğu 5 kez yürütmek istediğimiz ve blok içindeki dizini umursamadığımız anlamına gelir.

Bu içerikte:

let (result, _) = someFunctionThatReturnsATuple()

Bu, demetin ikinci elementinin ne olduğunu umursamadığımız anlamına gelir, sadece birincisi.

Swift 3'ten beri varsayılan olarak tüm bağımsız değişken etiketleri gereklidir .

IDE'yi ile bir bağımsız değişken etiketini gizlemeye zorlayabilirsiniz _.

func foo(a: String) {
}

func foo2(_ a: String) {
}

aradı foo(a: "abc")vefoo2("abc")

Not: Yalnızca bu kullanılabilir aolan (dış) argüman etiket ve (dahili) değişken adı aynı anda. Eşdeğerdir - func foo(a a: String)kabul etmeyecektir _.

Apple neden kullanıyor?

Apple'ın API genelinde kullandığını görebilirsiniz. Apple'ın kütüphaneleri hala Objective-C'de yazılmıştır (eğer değilse, Objective-C sözdizimi için tasarlanmış aynı işlev adlarını paylaşırlar)

Zaten işlevler , zaten uygulama olduğundan yedek parametre adına applicationWillResignActive(_ application: UIApplication)sahip olacaktırapplication 's işlev adı.

Örneğiniz

func runAction(_ action: SKAction!)aranmak olmadan 's _gibi işareti runAction(action:). İşlev adında zaten bir tane olduğundan parametre adı gereksizaction olur . Amaç bu ve neden orada.

Parametre bildiriminin önündeki bir tanımlayıcı harici bir parametre adı tanımlar . Bu, işlevi çağırırken arayan tarafından sağlanması gereken addır:

func someFunction(externalParameterName localParameterName: Int)

Kendiniz harici bir ad sağlamazsanız Swift, tanımladığınız herhangi bir varsayılan parametre için otomatik bir harici ad sağlar. Harici parametre adı için bir alt çizgi kullanmak bu davranıştan vazgeçer:

_Parametreyi tanımlarken açık bir harici ad yerine bir alt çizgi ( ) yazarak bu davranışı devre dışı bırakabilirsiniz .

Bu davranış hakkında daha fazla bilgiyi Varsayılan Değerleri Olan Parametreler için Harici Adlar bölümünde bulabilirsiniz .

Sanırım bu Swift'te kakao konvansiyonlarını daha iyi karşılayan objektif-c'ye daha yakın okumasını sağlayan bir sözleşmeyi zorladı. Objc'de ilk parametrenizi (harici olarak) adlandırmazsınız. Bunun yerine, kural olarak, dış ad genellikle yöntem adının ikinci bölümüne şu şekilde eklenir:

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

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

Swift api çağrılarını objc ile tutarlı hale getirmek için ilk parametrenin dış parametre adını bastırmak isteyeceksiniz.

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

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

Aslında, bir yöntemi tanımlamak için kullanılan gerçek kod ile Apple dokümanlarında yöntem bildirimi arasında bir fark vardır. En alalım UIControl 'ler - addTarget: aksiyon: forControlEvents: örneğin metodu, gerçek kodudur:

Ancak dokümanlarda şu şekilde görünür (hedeften önce _ dikkat edin):

Gerçek kodda, bir yöntem çağrıldığında ikinci veya sonraki parametrenin dış adının görünmemesini sağlamak için kullanılır ; dokümanlardayken, bir parametrenin yerel adının bir yöntemi veya işlevi çağırdığınızda, bir yöntem veya işlevi çağırdığınızda harici ad.

Eğer kendi parametrenizi girmedikçe veya bir parametrenin yerel adından önce (boşluk olmadan) # eklemediğiniz sürece varsayılan olarak bir işlev çağrıldığında dış ad yoktur, örneğin dispatch_after'ı şu şekilde kullanırız :

Ve dokümanlarda şu şekilde görünür (üçe dikkat edin _):

İşlev bildirimi kuralı, yöntem için tanımladığımla aynıdır.

Daha görsel.

Gördüğünüz gibi _atlamayı yerel bir parametre adı olsun ya da olmasın.