Apa perwakilan _ garis bawah dalam Swift Referensi?

Di bagian referensi dokumen Apple ada banyak hal seperti ini:

func runAction(_action: SKAction!)

'Setara' Objective-C dari ini adalah:

- (void)runAction:(SKAction *)action

Itu mengejutkan saya bahwa mungkin penting bahwa (dalam referensi Swift) ada ruang setelah garis bawah dan "tindakan" ditulis dalam huruf miring.

Tetapi saya tidak tahu apa yang ingin disampaikannya. Jadi mungkin pertanyaannya adalah ... adakah referensi untuk konvensi yang digunakan dalam referensi?

- inilah halaman yang saya maksudkan dalam referensi ini untuk penggunaan garis bawah: https://developer.apple.com/documentation/spritekit/sknode#//apple_ref/occ/instm/SKNode/runAction

Memperbarui

Swift 3 telah membuat beberapa perubahan pada bagaimana nama parameter fungsi / metode dan label argumen digunakan dan dinamai. Ini memiliki konsekuensi pada pertanyaan ini dan jawabannya. @Rickster melakukan pekerjaan luar biasa untuk menjawab pertanyaan yang berbeda tentang _underscores dalam fungsi yang membersihkan sebagian besar dari ini, di sini: Mengapa saya perlu menggarisbawahi dengan cepat?

Kedua jawaban itu benar tetapi saya ingin menjelaskan sedikit lebih banyak.

_digunakan untuk memodifikasi perilaku nama parameter eksternal untuk metode .

Di bagian Parameter Nama Lokal dan Eksternal untuk Metode dokumentasi, dikatakan:

Swift memberikan nama parameter pertama dalam metode nama parameter lokal secara default, dan memberikan nama parameter kedua dan selanjutnya nama parameter lokal dan eksternal secara default.

Di sisi lain, fungsi secara default tidak memiliki nama parameter eksternal.

Sebagai contoh, kita memiliki foo()metode ini didefinisikan di kelas Bar:

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

Ketika Anda menelepon foo(), ini disebut seperti bar.foo("Hello", s2: "World").

Tapi , Anda bisa mengesampingkan perilaku ini dengan menggunakan _di depan s2tempat itu dinyatakan.

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

Kemudian, ketika Anda menelepon foo, itu bisa disebut seperti bar.foo("Hello", "World")tanpa nama parameter kedua.

Kembali ke kasus Anda, runActionadalah metode karena itu terkait dengan tipe SKNode, jelas. Dengan demikian, menempatkan _parameter sebelum actionmemungkinkan Anda untuk memanggil runActiontanpa nama eksternal.

Pembaruan untuk Swift 2.0

Fungsi dan metode sekarang bekerja dengan cara yang sama dalam hal deklarasi nama argumen lokal dan eksternal.

Fungsi sekarang dipanggil dengan menggunakan nama parameter eksternal secara default, mulai dari parameter ke-2. Aturan ini hanya berlaku untuk kode Swift murni.

Jadi, dengan memberikan _di depan fungsi , pemanggil tidak harus menentukan nama parameter eksternal, seperti apa yang akan Anda lakukan untuk suatu metode .

Garis bawah adalah token umum yang digunakan untuk menunjukkan nilai yang dibuang.

Dalam kasus khusus ini, itu berarti bahwa fungsi akan dipanggil sebagai runAction(argument)gantirunAction(action:argument)

Dalam konteks lain ia memiliki makna serupa lainnya, misalnya dalam:

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

Itu berarti bahwa kami hanya ingin mengeksekusi blok 5 kali dan kami tidak peduli dengan indeks di dalam blok.

Dalam konteks ini:

let (result, _) = someFunctionThatReturnsATuple()

Itu berarti bahwa kita tidak peduli apa elemen kedua dari tuple, hanya yang pertama.

Karena Swift 3 semua label argumen diperlukan secara default .

Anda dapat memaksa IDE untuk menyembunyikan label argumen _.

func foo(a: String) {
}

func foo2(_ a: String) {
}

menelepon foo(a: "abc")danfoo2("abc")

Catatan: ini hanya dapat digunakan ketika aadalah label argumen (eksternal) dan nama variabel (internal) pada waktu yang sama. Ini setara - func foo(a a: String)tidak akan menerima _.

Mengapa Apple menggunakannya?

Anda dapat melihat Apple menggunakannya di seluruh API. Pustaka Apple masih ditulis dalam Objective-C (jika tidak, mereka tetap memiliki nama fungsi yang sama, yang dirancang untuk sintaks Objective-C)

Fungsi seperti applicationWillResignActive(_ application: UIApplication)akan berlebihan nama parameter application, karena sudah ada yang aplikasi di dalamnya nama fungsi.

Contoh anda

func runAction(_ action: SKAction!)akan disebut tanpa itu _tanda seperti runAction(action:). Nama parameter actionakan berlebihan karena sudah ada satu di nama fungsi. Itulah tujuannya dan mengapa itu ada di sana.

Pengidentifikasi di depan deklarasi parameter mendefinisikan nama parameter eksternal . Ini adalah nama yang harus disediakan oleh pemanggil saat memanggil fungsi:

func someFunction(externalParameterName localParameterName: Int)

Swift memberikan nama eksternal otomatis untuk parameter default apa pun yang Anda tetapkan, jika Anda sendiri tidak memberikan nama eksternal. Menggunakan garis bawah untuk nama parameter eksternal menyisih dari perilaku ini:

Anda dapat memilih keluar dari perilaku ini dengan menulis garis bawah ( _) alih-alih nama eksternal eksplisit ketika Anda menentukan parameter.

Anda dapat membaca lebih lanjut tentang perilaku ini di bagian Nama Eksternal untuk Parameter dengan Nilai Default di sini .

Saya pikir ini memaksa konvensi di Swift yang membuatnya lebih dekat ke objektif-c, yang lebih cocok dengan konvensi kakao. Di objc Anda tidak (secara eksternal) memberi nama parameter pertama Anda. Sebagai gantinya, dengan konvensi Anda biasanya memasukkan nama eksternal di bagian akhir nama metode seperti ini:

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

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

Untuk membuat panggilan api Swift konsisten dengan objc Anda akan ingin menekan nama parameter eksternal param pertama.

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

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

Sebenarnya, ada perbedaan antara kode nyata yang digunakan untuk mendefinisikan metode dan deklarasi metode dalam dokumen Apple. Mari kita ambil UIControl 's - addTarget: action: forControlEvents: metode misalnya, kode sebenarnya adalah:

Namun dalam dokumen, ini tampak seperti ini (perhatikan _ sebelum target):

Dalam kode nyata, _ digunakan untuk membuat nama eksternal parameter kedua atau berikutnya tidak muncul ketika suatu metode dipanggil, sementara dalam dokumen, _ sebelum nama lokal parameter menunjukkan bahwa ketika Anda memanggil suatu metode atau fungsi, Anda tidak boleh memberikan nama eksternal.

Tidak ada nama eksternal ketika suatu fungsi dipanggil secara default kecuali Anda memberikan sendiri atau menambahkan # sebelum (tanpa spasi) nama lokal parameter, misalnya, ini adalah bagaimana kami menggunakan dispatch_after :

Dan dalam dokumen, tampak seperti ini (perhatikan tiga _):

Konvensi deklarasi fungsi sama seperti yang saya jelaskan untuk metode.

Hanya lebih secara visual.

Seperti yang Anda lihat, _hapus saja nama parameter lokal atau tidak.