Swift-də Associated Values: nədir, sintaksis və nümunələr

Associated Values nədir?

Associated Values — enum case-nin özü ilə birlikdə saxlaya biləcəyi əlavə məlumatdır. Raw values-dən fərqli olaraq, onlar bəyannamə səviyyəsində sabitlənmişdir, associated values isə enum nümunəsi yaradılarkən təyin edilir.

Təsəvvür edin ödəniş metodunun modelləşdirilməsini: creditCard case-i son 4 rəqəmi və bitmə tarixini saxlaya bilər, applePay case-i isə heç nə. Associated values ilə bu, alt siniflər və ya opsional sahələr olmadan təbii şəkildə həyata keçirilir.

Apple sənədləşməsinə görə, associated values enum-u sadə sabitlər dəstindən funksional dillər üçün xarakterik olan cəbri məlumat tipinə (sum type) çevirir. Bu, kodun ifadəliliyini əhəmiyyətli dərəcədə artırır.

Associated values sintaksisi

Associated values case-dən sonra dairəvi mötərizələrdə, funksiyalardakı kimi parametr adları və tipləri göstərilməklə bəyan edilir.

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

Nümunə yaradılarkən associated values arqumentlər kimi ötürülür:

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

Swift associated values sayına və ya tiplərinə heç bir məhdudiyyət qoymur. Siz associated values daxilində dżeneriklərdən, qapanma funksiyalarından və digər enum-lardan istifadə edə bilərsiniz. Bu, mürəkkəb iç-içə strukturlar qurmağa imkan verir.

Associated values parametr adları nümunə yaradılarkən arqument etiketləri kimi istifadə olunur — bu, kodun oxunaqlılığını yaxşılaşdırır. Switch vasitəsilə çıxarılarkən adlar sənədləşmə rolunu oynayır, hər bir dəyərin mənasını izah edir. Belə yanaşma kodu özünü sənədləşdirən edir və məlumatların uyğunlaşdırılması zamanı səhv ehtimalını azaldır. Bu, xüsusilə böyük iOS tətbiqlərinin komanda şəklində inkişafında dəyərlidir.

Associated values ilə Switch

Switch — associated values çıxarmaq üçün əsas üsuldur. Dəyərlər let və ya var vasitəsilə sabitlərə və ya dəyişənlərə 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 qismən uyğunlaşdırmanı dəstəkləyir — associated values-ün konkret dəyərlərini göstərmək olar:

switch file {
case .image(let w, let h, "png"):
    print("PNG şəkli \(w)x\(h)")
case .image(1920, 1080, _):
    print("Full HD şəkli")
default:
    break
}

Wildcard (_) istifadəsi lazımsız associated values-ü gözardı etməyə, case-lərdəki sabitlər isə konkret dəyərlərlə uyğunluğu yoxlamağa imkan verir.

Associated Values vs Raw Values

Bir çox təcrübəsiz tərtibatçı associated values-ü raw values ilə qarışdırır. Bunlar fərqli tətbiq ssenariləri olan fərqli mexanizmlərdir.

Swift Evolution-a görə, associated values Swift 2.0-da enum-un yenidən dizaynının bir hissəsi kimi təqdim edilmişdir. Onlar tiplərə cəbri yanaşma təmin edir, burada hər bir case öz imzası olan ayrıca konstruktordur.

Associated values praktik nümunələri

Associated values real iOS layihələrində fəal şəkildə istifadə olunur. Üç tipik ssenarini nəzərdən keçirək.

API cavablarının modelləşdirilməsi

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

UI State Machine

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

Associated values ilə enum güclü alətə çevrilir sonlu avtomatlar üçün: hər case — vəziyyət, associated values — bu vəziyyətin parametrləri. Kompilyator bütün keçidlərin işləndiyinə zəmanət verir.

if case və guard case vasitəsilə çıxarılma

Switch olmadan bir case-i yoxlamaq üçün if case və ya guard case istifadə edin. Bu, yalnız bir variantı emal etmək lazım olduqda daha yığcamdır.

let error = NetworkError.timeout(seconds: 30)

if case .timeout(let seconds) = error {
    print("Sorğu vaxtı bitdi \(seconds)s sonra")
}

guard case .httpError(let code, _) = error else {
    return
}
print("Kod \(code) ilə HTTP xətası")