В Xcode есть возможность добавлять в код специальные маркеры:

• MARK
• TODO
• FIXME

Первым чаще всего обозначают группы элементов, а двумя остальными — требующие доработки места.

import Foundation

class Cat {
    // MARK: - Properties
    // MARK: required
    let breed: String!
    var age: UInt!
    
    // MARK: optional
    let sex: String?
    
    // MARK: - Initialization
    init() {
        breed = "siamese"
        age = 1
        
        // FIXME: Sex setting
        sex = nil
    }
    
    // MARK: - Main
    func walk() {
        print("Walk")
    }
    
    // TODO: Write a logic
    func meow() {
        print("Meow...")
    }
}

В панели иерархии это выглядит так:

Кроме разметки, редактор также позволяет документировать код Markup-языком. Возможности его достаточно обширны и включают наряду с базовым описанием объектов, параметров и возвращаемых значений, различные заголовки, списки, ссылки, вставки кода, изображений и многое другое.

Для наглядности, пример с использованием основных команд:

import Foundation

/**
 The `Utility` class provides various useful functions and values.
*/
class Utility {
    /**
     Fixes the string representation of number.
     
     ```
     1.0 -> 1 (not 1.0)
     0.00003 -> 0.00003 (not 3e-05)
     ```
     
     - parameters:
        - doubleValue: The number to be represented as the string.
     
     - returns: The string representation of number.
    */
    class func doubleToString(doubleValue: Double) -> String {
        var stringValue: String
        
        if trunc(doubleValue) == doubleValue {
            stringValue = "\(Int(doubleValue))"
        } else if abs(doubleValue) < 0.0001 {
            stringValue = "\(doubleValue + (doubleValue.isSignMinus ? -1 : 1))"
            stringValue = stringValue.stringByReplacingOccurrencesOfString("1.", withString: "0.")
        } else {
            stringValue = "\(doubleValue)"
        }
        
        return stringValue
    }
}

Теперь эта информация будет отображаться во всплывающей подсказке и панели помощи:

Иногда бывает необходимо выполнить дополнительные операции при изменении значений свойств. Чтобы отловить события, используются наблюдатели willSet/didSet, в работе с которыми есть нюансы.

Рассмотрим пример:

import UIKit

class Object {
    var color = UIColor.greenColor() {
        didSet {
            color.getRed(&red, green: &green, blue: &blue, alpha: &alpha)
        }
    }
    
    private(set) var red = CGFloat()
    private(set) var green = CGFloat()
    private(set) var blue = CGFloat()
    private(set) var alpha = CGFloat()
    
    var point = CGPoint() {
        didSet {
            print("Point changed to \(point)")
        }
    }
    
    var name = NSMutableString() {
        didSet {
            print("Name changed to \(name)")
        }
    }

    init() {
        color = UIColor.redColor()
    }
}

Первое — наблюдатели не вызываются при задании значений по умолчанию, а также в инициализаторе:

let object = Object()
print("Red: \(object.red), green: \(object.green), blue: \(object.blue), alpha \(object.alpha)")

// Output: Red: 0.0, green: 0.0, blue: 0.0, alpha 0.0

И второе — изменение (мутация) свойств значений не ссылочных типов (структур и перечислений) реализуется через перезапись экземпляра на новый, содержащий обновления, поэтому мутация провоцирует вызов наблюдателей. Для ссылочных типов (объектных классов) такого не происходит:

object.point = CGPoint(x: 10, y: 10)
object.point.x = 20

// Output: Point changed to (10.0, 10.0)
//         Point changed to (20.0, 10.0)

object.name = NSMutableString(string: "'The new name'")
object.name.setString("Changed name")

// Output: Name changed to 'The new name'

По умолчанию уровни доступа геттера и сеттера свойства идентичны. Например, в данном случае value окажется совершенно недоступным извне:

import Foundation

class Counter {
    private var value = 0

    func increase() {
        value++
    }
    
    func decrease() {
        value--
    }
}

Но что если свойство должно быть открытым на чтение за пределами класса? Перевод его в публичные открывает вместе с тем и изменения, это не всегда допустимо. Другой способ — оставить приватность и создать еще одно свойство с геттером, смотрящим на наше значение. Так задача решится, но добавятся новые связи, усложняющие код.

Благо, Swift — красивый язык, в котором можно найти решение поизящнее. В данном случае поможет конструкция private(set), позволяющая задавать сеттеру уровень доступа ниже геттера:

import Foundation

class Counter {
    private(set) var value = 0
    
    func increase() {
        value++
    }
    
    func decrease() {
        value--
    }
}

Теперь у геттера видимость по умолчанию, то есть internal, а у сеттера private.