زبان برنامه‌نویسی

چیت‌شیت Swift

مرجع پایه Swift برای ثابت‌ها، optionals، ساختارها، collectionها و هم‌زمانی. مقدارهای غایب را با Optional نمایش دهید و پیش‌شرط‌ها را با guard روشن کنید. نوع value و reference را متناسب با semantics انتخاب کنید. متدهای collection را برای تبدیل declarative استفاده کنید؛ closure را کوتاه و captureهای ناخواسته را کنترل کنید. از این صفحه به‌عنوان مرجع سریع استفاده کنید و مثال‌ها و نکته‌ها را با نسخهٔ ابزار، نیاز و شرایط واقعی پروژهٔ خود تطبیق دهید.

NOVIN SKILLS / DIGITAL STUDIO

Guard برای خروج زودهنگام

پس از guard متغیر unwrapشده در ادامهٔ scope در دسترس است.

1func greeting(for name: String?) -> String {2    guard let name, !name.isEmpty else {3        return "Hello, guest"4    }5    return "Hello, \(name)"6}

Enum با associated value

enum می‌تواند دادهٔ وابسته به هر حالت را type-safe نگه دارد.

1enum LoadState {2    case idle3    case loading4    case loaded([String])5    case failed(Error)6}

Struct و computed property

struct برای مقدارهای مستقل و قابل‌کپی مناسب است.

1struct Rectangle {2    var width: Double3    var height: Double45    var area: Double { width * height }6}

Map و filter

نتیجهٔ هر مرحله آرایه‌ای تازه با نوع خروجی مشخص می‌سازد.

1let visibleNames = users2    .filter { $0.isActive }3    .map(\.name)4    .sorted()

Dictionary با grouping

Dictionary(grouping:by:) اعضا را براساس کلید دسته‌بندی می‌کند.

1let usersByCity = Dictionary(grouping: users, by: \.city)

Reduce برای جمع

reduce را برای aggregation با accumulator روشن نگه دارید.

1let total = prices.reduce(0) { sum, price in2    sum + price3}

Error و throws

خطای دامنه‌ای را با enum قابل‌بررسی تعریف کنید.

1enum InputError: Error {2    case empty3}45func validate(_ value: String) throws -> String {6    guard !value.isEmpty else { throw InputError.empty }7    return value8}

Async function

await محل انتظار را در جریان کنترل آشکار می‌کند.

1func loadProfile(id: Int) async throws -> Profile {2    let (data, _) = try await URLSession.shared.data(from: profileURL(id))3    return try JSONDecoder().decode(Profile.self, from: data)4}

Task group برای کارهای مستقل

گروه taskها نتایج را جمع می‌کند و با scope والد lifecycle دارد.

1let results = await withTaskGroup(of: Image?.self) { group in2    for url in urls {3        group.addTask { try? await loadImage(from: url) }4    }5    return await group.reduce(into: []) { $0.append($1) }6}

برای استفاده در پروژه

نکات کلیدی

۱
مقدار تغییرناپذیر را با let و مقدار متغیر را با var تعریف کنید.
۲
نوع داده را از context استنباط کنید یا برای API عمومی صریح بنویسید.
۳
مقدار احتمالی را با Optional نمایش دهید و امن با if let باز کنید.
۴
از force unwrap فقط وقتی invariant قطعی است استفاده کنید.
۵
برای داده‌های ارزشی از struct و برای هویت مرجعی از class بهره ببرید.
۶
آرایه، دیکشنری و مجموعه را با نوع عنصر مشخص بسازید.
۷
الگوی guard را برای خروج زودهنگام و روشن‌کردن پیش‌شرط‌ها به‌کار ببرید.
۸
خطا را با throws و do/catch منتقل و مدیریت کنید.
۹
ناهمگامی را با async/await و لغو task را آگاهانه مدیریت کنید.
۱۰
چرخه عمر referenceها را بررسی کنید و تست را روی سناریوهای اختیاری و خطا اجرا کنید.
۱۱
Optional را با if let یا guard let باز کنید و force unwrap را فقط در invariant اثبات‌شده نگه دارید.
۱۲
برای انتقال داده میان taskها، قواعد Sendable و actor isolation را بررسی کنید.

چیت‌شیت Swift

Guard برای خروج زودهنگام

پس از guard متغیر unwrapشده در ادامهٔ scope در دسترس است.

1func greeting(for name: String?) -> String {2    guard let name, !name.isEmpty else {3        return "Hello, guest"4    }5    return "Hello, \(name)"6}

Enum با associated value

enum می‌تواند دادهٔ وابسته به هر حالت را type-safe نگه دارد.

1enum LoadState {2    case idle3    case loading4    case loaded([String])5    case failed(Error)6}

Struct و computed property

struct برای مقدارهای مستقل و قابل‌کپی مناسب است.

1struct Rectangle {2    var width: Double3    var height: Double45    var area: Double { width * height }6}

Map و filter

نتیجهٔ هر مرحله آرایه‌ای تازه با نوع خروجی مشخص می‌سازد.

1let visibleNames = users2    .filter { $0.isActive }3    .map(\.name)4    .sorted()

Dictionary با grouping

Dictionary(grouping:by:) اعضا را براساس کلید دسته‌بندی می‌کند.

1let usersByCity = Dictionary(grouping: users, by: \.city)

Reduce برای جمع

reduce را برای aggregation با accumulator روشن نگه دارید.

1let total = prices.reduce(0) { sum, price in2    sum + price3}

Error و throws

خطای دامنه‌ای را با enum قابل‌بررسی تعریف کنید.

1enum InputError: Error {2    case empty3}45func validate(_ value: String) throws -> String {6    guard !value.isEmpty else { throw InputError.empty }7    return value8}

Async function

await محل انتظار را در جریان کنترل آشکار می‌کند.

1func loadProfile(id: Int) async throws -> Profile {2    let (data, _) = try await URLSession.shared.data(from: profileURL(id))3    return try JSONDecoder().decode(Profile.self, from: data)4}

Task group برای کارهای مستقل

گروه taskها نتایج را جمع می‌کند و با scope والد lifecycle دارد.

1let results = await withTaskGroup(of: Image?.self) { group in2    for url in urls {3        group.addTask { try? await loadImage(from: url) }4    }5    return await group.reduce(into: []) { $0.append($1) }6}

برای استفاده در پروژه

نکات کلیدی

۱
مقدار تغییرناپذیر را با let و مقدار متغیر را با var تعریف کنید.
۲
نوع داده را از context استنباط کنید یا برای API عمومی صریح بنویسید.
۳
مقدار احتمالی را با Optional نمایش دهید و امن با if let باز کنید.
۴
از force unwrap فقط وقتی invariant قطعی است استفاده کنید.
۵
برای داده‌های ارزشی از struct و برای هویت مرجعی از class بهره ببرید.
۶
آرایه، دیکشنری و مجموعه را با نوع عنصر مشخص بسازید.
۷
الگوی guard را برای خروج زودهنگام و روشن‌کردن پیش‌شرط‌ها به‌کار ببرید.
۸
خطا را با throws و do/catch منتقل و مدیریت کنید.
۹
ناهمگامی را با async/await و لغو task را آگاهانه مدیریت کنید.
۱۰
چرخه عمر referenceها را بررسی کنید و تست را روی سناریوهای اختیاری و خطا اجرا کنید.
۱۱
Optional را با if let یا guard let باز کنید و force unwrap را فقط در invariant اثبات‌شده نگه دارید.
۱۲
برای انتقال داده میان taskها، قواعد Sendable و actor isolation را بررسی کنید.