Swift-এ Associated Values: এটি কী, সিনট্যাক্স এবং উদাহরণ

Associated Values কী?

Associated Values হল অতিরিক্ত তথ্য যা একটি enum কেস নিজের সাথে সংরক্ষণ করতে পারে। raw values-এর বিপরীতে, যা ঘোষণা স্তরে স্থির, associated values enum ইনস্ট্যান্স তৈরি করার সময় সেট করা হয়।

একটি পেমেন্ট পদ্ধতি মডেল করার কল্পনা করুন: creditCard কেস শেষ 4টি সংখ্যা এবং মেয়াদ শেষ হওয়ার তারিখ সংরক্ষণ করতে পারে, যেখানে applePay কেস কিছুই সংরক্ষণ করে না। associated values-এর সাথে, এটি সাবক্লাস বা ঐচ্ছিক ফিল্ড ছাড়াই স্বাভাবিকভাবে বাস্তবায়িত হয়।

Apple ডকুমেন্টেশন অনুসারে, associated values enum-কে ধ্রুবকের একটি সাধারণ সেট থেকে একটি বীজগাণিতিক ডেটা টাইপে (sum type) রূপান্তরিত করে, যা ফাংশনাল ভাষার বৈশিষ্ট্য। এটি কোডের অভিব্যক্তিকে উল্লেখযোগ্যভাবে বাড়িয়ে তোলে।

Associated values-এর সিনট্যাক্স

Associated Values কেসের পরে বন্ধনীর মধ্যে ঘোষণা করা হয়, ফাংশনের মতো প্যারামিটারের নাম এবং প্রকার উল্লেখ করে।

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

একটি ইনস্ট্যান্স তৈরি করার সময়, associated values আর্গুমেন্ট হিসাবে পাস করা হয়:

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

Swift associated values-এর সংখ্যা বা প্রকারের উপর কোনও বিধিনিষেধ আরোপ করে না। আপনি associated values-এর ভিতরে জেনেরিক, ক্লোজার ফাংশন এবং অন্যান্য enum ব্যবহার করতে পারেন। এটি জটিল নেস্টেড স্ট্রাকচার তৈরি করা সম্ভব করে।

associated values-এর প্যারামিটারের নামগুলি ইনস্ট্যান্স তৈরি করার সময় আর্গুমেন্ট লেবেল হিসাবে ব্যবহৃত হয় — এটি কোড পঠনযোগ্যতা উন্নত করে। switch-এর মাধ্যমে নিষ্কাশনের সময়, নামগুলি ডকুমেন্টেশন হিসাবে কাজ করে, প্রতিটি মানের অর্থ স্পষ্ট করে। এই পদ্ধতি কোডকে স্ব-ডকুমেন্টিং করে তোলে এবং ডেটা ম্যাচ করার সময় ত্রুটির সম্ভাবনা হ্রাস করে। এটি বড় iOS অ্যাপ্লিকেশনের টিম ডেভেলপমেন্টে বিশেষভাবে মূল্যবান।

Switch with associated values

Switch হল associated values নিষ্কাশনের প্রাথমিক উপায়। মানগুলি let বা var-এর মাধ্যমে ধ্রুবক বা ভেরিয়েবলের সাথে আবদ্ধ হয়।

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 আংশিক ম্যাচিং সমর্থন করে — আপনি associated values-এর জন্য নির্দিষ্ট মান নির্ধারণ করতে পারেন:

switch file {
case .image(let w, let h, "png"):
    print("PNG চিত্র \(w)x\(h)")
case .image(1920, 1080, _):
    print("Full HD চিত্র")
default:
    break
}

ওয়াইল্ডকার্ড (_) ব্যবহার অপ্রয়োজনীয় associated values উপেক্ষা করতে দেয়, এবং কেসের ধ্রুবকগুলি আপনাকে নির্দিষ্ট মানের সাথে মিল পরীক্ষা করতে দেয়।

Associated Values vs Raw Values

অনেক শিক্ষানবিশ ডেভেলপার associated values কে raw values-এর সাথে গুলিয়ে ফেলেন। এগুলি বিভিন্ন ব্যবহারের ক্ষেত্রে ভিন্ন প্রক্রিয়া।

Swift Evolution অনুসারে, associated values Swift 2.0-এ enum রিডিজাইনের অংশ হিসাবে চালু করা হয়েছিল। তারা টাইপের জন্য একটি বীজগাণিতিক পদ্ধতি প্রদান করে, যেখানে প্রতিটি কেস তার নিজস্ব স্বাক্ষর সহ একটি পৃথক কনস্ট্রাক্টর।

Associated values-এর ব্যবহারিক উদাহরণ

Associated Values বাস্তব iOS প্রকল্পে সক্রিয়ভাবে ব্যবহৃত হয়। আসুন তিনটি সাধারণ পরিস্থিতি বিবেচনা করি।

API প্রতিক্রিয়ার মডেলিং

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

UI স্টেট মেশিন

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

associated values-এর সাথে, enum স্টেট মেশিনের জন্য একটি শক্তিশালী টুল হয়ে ওঠে: প্রতিটি কেস একটি অবস্থা, associated values হল সেই অবস্থার প্যারামিটার। কম্পাইলার গ্যারান্টি দেয় যে সমস্ত ট্রানজিশন হ্যান্ডেল করা হয়েছে।

if case এবং guard case-এর মাধ্যমে নিষ্কাশন

switch ছাড়া একটি একক কেস পরীক্ষা করতে, if case বা guard case ব্যবহার করুন। যখন আপনার শুধুমাত্র একটি বিকল্প হ্যান্ডেল করার প্রয়োজন হয় তখন এটি আরও কমপ্যাক্ট।

let error = NetworkError.timeout(seconds: 30)

if case .timeout(let seconds) = error {
    print("\(seconds)s পরে অনুরোধের সময় শেষ")
}

guard case .httpError(let code, _) = error else {
    return
}
print("\(code) কোড সহ HTTP ত্রুটি")