Swift: Anlamak // MARK

Swift'te yorum yazmanın amacı nedir:

// MARK: This is a comment

Ayrıca şunları da yapabilirsiniz:

// This is a comment

Ne // MARKelde eder?

// MARK:Ve // MARK: -Swift fonksiyonlarda sözdizimi aynı etmek #pragma markve #pragma mark -sözdizimi Objective-C.

Bu sözdizimini (artı // TODO:ve // FIXME:) kullanırken, hızlı atlama çubuğunda gösterilecek bazı ek bilgiler alabilirsiniz.

Bu birkaç kaynak kodu satırını göz önünde bulundurun:

// MARK: A mark comment lives here.

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

Ve referans olarak, hızlı atlama çubuğu Xcode'da en üstte:

Çoğunlukla dosya içinde hızlı gezinmeye yardımcı olmak için vardır.

Tire ( // MARK: -) işlevinin hoş bir ayrım çizgisinin görünmesine neden olduğunu unutmayın . Bu MARKyorumu düşünün :

// MARK: - A mark comment lives here.

O menüdeki kalın seçeneğin hemen üstündeki koyu gri ayırıcı çizgi tire işaretinden gelir.

Ayrıca, kısa çizgi sonra herhangi bir metin olmadan bu ayırıcı satır yorum olmadan elde edebilirsiniz:

// MARK: -

Gibi söz, // TODO:ve // FIXME:yorumlar da burada görünecek.

// 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'lerin göze çarpmasına yardımcı olan küçük bir yara bandı simgesi var.
• MARK simgesi içindekiler tablosu gibi görünüyor
• YAPILACAK simgeleri daha çok bir kontrol listesine benziyor

Hızlı atlama çubuğundaki herhangi bir satıra tıklamak sizi doğrudan kaynak kodundaki satıra götürür.

MARK, atlama çubuğuna aşağıdaki gibi görsel bir MARK ekler:

eski // MARK: Core Data Stack

Her zaman kullanabilirsiniz

// 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() {

}