Swift: ทำความเข้าใจ // MARK

จุดประสงค์ของการเขียนความคิดเห็นใน Swift คืออะไร:

// MARK: This is a comment

เมื่อคุณสามารถทำได้:

// This is a comment

สิ่งที่ไม่// MARKบรรลุ?

// MARK:และ// MARK: -ไวยากรณ์ในฟังก์ชั่นสวิฟท์เหมือนกันไป#pragma markและ#pragma mark -ไวยากรณ์ใน Objective-C

เมื่อใช้ไวยากรณ์นี้ (บวก// TODO:และ// FIXME:) คุณสามารถรับข้อมูลเพิ่มเติมเพื่อแสดงในแถบกระโดดด่วน

พิจารณาซอร์สโค้ดสองสามบรรทัดเหล่านี้:

// MARK: A mark comment lives here.

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

และสำหรับการอ้างอิงแถบกระโดดด่วนจะอยู่ที่ด้านบนสุดใน Xcode:

ส่วนใหญ่มีไว้เพื่อช่วยในการนำทางอย่างรวดเร็วภายในไฟล์

สังเกตว่าเส้นประ ( // MARK: -) ทำให้เส้นคั่นที่สวยงามปรากฏขึ้น พิจารณาMARKความคิดเห็นนี้:

// MARK: - A mark comment lives here.

เส้นคั่นสีเทาเข้มเหนือตัวเลือกตัวหนาในเมนูนั้นมาจากเส้นประ

นอกจากนี้เราสามารถบรรลุบรรทัดคั่นนี้ได้โดยไม่ต้องแสดงความคิดเห็นโดยไม่ต้องมีข้อความใด ๆ หลังเส้นประ:

// MARK: -

ตามที่กล่าวไว้// TODO:และ// FIXME:ความคิดเห็นจะปรากฏที่นี่ด้วย

// 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 จะได้รับไอคอนวงดนตรีเล็ก ๆ ที่ช่วยให้พวกเขาโดดเด่น
• ไอคอน MARK ดูเหมือนสารบัญ
• ไอคอนสิ่งที่ต้องทำมีลักษณะเหมือนรายการตรวจสอบ

การคลิกที่บรรทัดใดก็ได้ในแถบกระโดดด่วนจะนำคุณไปยังบรรทัดนั้นโดยตรงในซอร์สโค้ด

MARK เพียงแค่เพิ่มเครื่องหมายภาพในแถบกระโดดดังนี้:

เช่น // MARK: Core Data Stack

คุณสามารถใช้

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

}