Swift'te Associated Values: Nedir, Sözdizimi ve Örnekler

Associated Values Nedir?

Associated Values, bir enum durumunun kendisiyle birlikte saklayabileceği ek bilgilerdir. Bildirim düzeyinde sabit olan raw values'ın aksine, associated values bir enum örneği oluşturulurken ayarlanır.

Bir ödeme yöntemini modellediğinizi hayal edin: creditCard durumu son 4 haneyi ve son kullanma tarihini saklayabilirken, applePay durumu hiçbir şey saklamaz. Associated values ile bu, alt sınıflar veya isteğe bağlı alanlar olmadan doğal bir şekilde uygulanır.

Apple dokümantasyonuna göre, associated values, enum'u basit bir sabitler kümesinden işlevsel dillere özgü cebirsel bir veri türüne (sum type) dönüştürür. Bu, kod ifade gücünü önemli ölçüde artırır.

Associated values sözdizimi

Associated Values, işlevlerde olduğu gibi, durumdan sonra parantez içinde parametre adları ve türleri belirtilerek bildirilir.

enum MediaFile {
    case image(width: Int, height: Int, format: String)
    case video(duration: Double, codec: String)
    case audio(bitrate: Int)
    case unknown
}

Bir örnek oluşturulurken, associated values argümanlar olarak iletilir:

let photo = MediaFile.image(width: 1920, height: 1080, format: "jpeg")
let clip = MediaFile.video(duration: 120.5, codec: "h264")

Swift, associated values'ın sayısı veya türleri üzerinde kısıtlama getirmez. Associated values içinde generics, closure işlevleri ve diğer enum'ları kullanabilirsiniz. Bu, karmaşık iç içe yapılar oluşturmayı mümkün kılar.

Associated values parametre adları, bir örnek oluşturulurken argüman etiketleri olarak kullanılır — bu, kod okunabilirliğini artırır. Switch ile çıkarım sırasında adlar, her değerin anlamını netleştirerek dokümantasyon görevi görür. Bu yaklaşım, kodu kendi kendini belgeleyen hale getirir ve veri eşleştirme sırasında hata olasılığını azaltır. Bu, büyük iOS uygulamalarının takım geliştirmesinde özellikle değerlidir.

Switch ile associated values

Switch, associated values'ı çıkarmanın birincil yoludur. Değerler, let veya var aracılığıyla sabitlere veya değişkenlere bağlanır.

func describe(_ file: MediaFile) -> String {
    switch file {
    case .image(let w, let h, let fmt):
        return "Image \(w)x\(h) .\(fmt)"
    case .video(let duration, let codec):
        return "Video \(duration)s, \(codec)"
    case .audio(let bitrate):
        return "Audio \(bitrate)kbps"
    case .unknown:
        return "Unknown format"
    }
}

Swift kısmi eşleme destekler — associated values için somut değerler belirtebilirsiniz:

switch file {
case .image(let w, let h, "png"):
    print("PNG görüntüsü \(w)x\(h)")
case .image(1920, 1080, _):
    print("Full HD görüntü")
default:
    break
}

Joker karakter (_) kullanmak gereksiz associated values'ı yok saymaya olanak tanır ve durumlardaki sabitler, belirli değerlerle eşleşmeyi kontrol etmenizi sağlar.

Associated Values vs Raw Values

Birçok acemi geliştirici associated values ile raw values'ı karıştırır. Bunlar farklı kullanım durumlarına sahip farklı mekanizmalardır.

Swift Evolution'a göre, associated values, enum yeniden tasarımının bir parçası olarak Swift 2.0'da tanıtılmıştır. Her durumun kendi imzasına sahip ayrı bir kurucu olduğu türlere cebirsel bir yaklaşım sağlarlar.

Associated values pratik örnekleri

Associated Values, gerçek iOS projelerinde aktif olarak kullanılır. Üç tipik senaryoyu inceleyelim.

API yanıtlarını modelleme

enum APIResponse<T: Codable> {
    case success(data: T, cached: Bool)
    case failure(error: Error, retryAvailable: Bool)
    case loading(progress: Double)
}

UI Durum Makinesi

enum ViewState<T> {
    case idle
    case loading(message: String)
    case loaded(data: T)
    case error(message: String, retryAction: () -> Void)
}

Associated values ile enum, durum makineleri için güçlü bir araç haline gelir: her durum bir durumdur, associated values bu durumun parametreleridir. Derleyici, tüm geçişlerin işlendiğini garanti eder.

if case ve guard case ile çıkarma

Switch olmadan tek bir durumu kontrol etmek için if case veya guard case kullanın. Yalnızca bir seçeneği işlemeniz gerektiğinde bu daha derli topludur.

let error = NetworkError.timeout(seconds: 30)

if case .timeout(let seconds) = error {
    print("\(seconds)s sonra istek zaman aşımına uğradı")
}

guard case .httpError(let code, _) = error else {
    return
}
print("\(code) kodlu HTTP hatası")