Swift: Memahami // MARK

Apa tujuan menulis komentar di Swift sebagai:

// MARK: This is a comment

Kapan Anda juga bisa melakukan:

// This is a comment

Apa // MARKpencapaiannya?

The // MARK:dan // MARK: -sintaks dalam fungsi Swift identik dengan #pragma markdan #pragma mark -sintaks di Objective-C.

Saat menggunakan sintaks ini (plus // TODO:dan // FIXME:), Anda bisa mendapatkan beberapa informasi tambahan untuk ditampilkan di bilah lompat cepat.

Pertimbangkan beberapa baris kode sumber berikut:

// MARK: A mark comment lives here.

func isPrime(_ value: UInt) -> Bool { return true }

Dan untuk referensi, bilah lompat cepat ada di bagian atas di Xcode:

Itu ada sebagian besar untuk membantu navigasi cepat di dalam file.

Perhatikan bahwa tanda hubung ( // MARK: -) menyebabkan garis pemisah yang bagus muncul. Pertimbangkan MARKkomentar ini :

// MARK: - A mark comment lives here.

Garis pemisah abu-abu gelap tepat di atas opsi yang dicetak tebal di menu itu berasal dari tanda hubung.

Selain itu, kita dapat mencapai garis pemisah ini tanpa komentar hanya dengan tidak memiliki teks apa pun setelah tanda hubung:

// MARK: -

Seperti yang disebutkan, // TODO:dan // FIXME:komentar juga akan muncul di sini.

// MARK: - Prime functions

func isPrime(_ value: UInt) -> Bool {
    // TODO: Actually implement the logic for this method
    return true
}

func nthPrime(_ value: UInt) -> Int {
    // FIXME: Returns incorrect values for some arguments
    return 2
}

• FIXME mendapatkan ikon bantuan pita kecil yang membantu mereka menonjol.
• Ikon MARK tampak seperti daftar isi
• Ikon TODO lebih terlihat seperti daftar periksa

Mengklik baris mana pun di bilah lompat cepat akan membawa Anda langsung ke baris tersebut di kode sumber.

MARK hanya menambahkan MARK visual di bilah lompat seperti ini:

ex // MARK: Core Data Stack

Anda selalu bisa menggunakan

// MARK: - Properties
var name: String

// MARK: - Methods
func display() {
}

init(name: String, rollNumber: Int) {

    // TODO: add configuration code
    self.name = name
}

// FIXME: bug XYZ
func fixBug() {

}