Swift: Hiểu // đánh dấu

Mục đích viết bình luận trong Swift là gì:

// MARK: This is a comment

Khi nào bạn cũng có thể làm:

// This is a comment

Những gì // MARKđạt được?

Các // MARK:và // MARK: -cú pháp trong Swift chức năng y hệt #pragma markvà #pragma mark -cú pháp trong Objective-C.

Khi sử dụng cú pháp này (cộng // TODO:và // FIXME:), bạn có thể nhận được một số thông tin bổ sung để hiển thị trong thanh nhảy nhanh.

Hãy xem xét một vài dòng mã nguồn:

// MARK: A mark comment lives here.

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

Và để tham khảo, thanh nhảy nhanh nằm ở đầu trong Xcode:

Nó tồn tại chủ yếu để giúp điều hướng nhanh chóng trong tập tin.

Lưu ý rằng dấu gạch ngang ( // MARK: -) làm cho một đường phân tách đẹp hiển thị. Xem xét MARKnhận xét này :

// MARK: - A mark comment lives here.

Dòng phân cách màu xám đậm hơn ngay phía trên tùy chọn được in đậm trong menu đó đến từ dấu gạch ngang.

Ngoài ra, chúng ta có thể đạt được dòng phân tách này mà không cần nhận xét bằng cách đơn giản là không có bất kỳ văn bản nào sau dấu gạch ngang:

// MARK: -

Như đã đề cập, // TODO:và // FIXME:ý kiến ​​cũng sẽ xuất hiện ở đây.

// 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
}

• FIXMEs có được một biểu tượng hỗ trợ ban nhạc nhỏ giúp họ nổi bật.
• Biểu tượng Mark trông giống như một bảng mục lục
• Các biểu tượng TODO trông giống như một danh sách kiểm tra

Nhấp vào bất kỳ dòng nào trong thanh nhảy nhanh sẽ đưa bạn trực tiếp đến dòng đó trong mã nguồn.

MARK chỉ cần thêm một hình ảnh trực quan trong thanh nhảy như thế này:

Ví dụ // MARK: Core Data Stack

Bạn luôn có thể sử dụng

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

}