DefaultsKit

简体中文

DefaultSkit هي مكتبة سريعة خفيفة الوزن تبني على ترميز لتقديم غلاف بسيط وكتبت بقوة ومدمجة لمستخدمي Defaults. مع أقل من 100 سطر من التعليمات البرمجية ، يكون من السهل الاستخدام وكفاءة عالية.

التثبيت >> instructions <<

الاستخدام

مثيل ، أو الحصول على مثيل shared من Defaults

 let defaults = Defaults ( ) // or Defaults.shared

ثم:

// Define a key
let key = Key < String > ( " someKey " )

// Set a value
defaults . set ( " Codable FTW ? " , for : key )

// Read the value back
defaults . get ( for : key ) // Output: Codable FTW ?

تحقق مما إذا كان للمفتاح قيمة:

if defaults . has ( key ) {
    // Do your thing
}

إذا كنت بحاجة فقط إلى معرفة وجود زوج مفتاح/قيمة ، دون استخدام القيمة فعليًا ، استخدم طريقة has() بدلاً من get(for:key) . بالنسبة للكائنات المعقدة ، فإنه سيمنع أي هجر غير ضروري.

تعبير عضو ضمني

يمكنك العثور على غلاف راحة لمفاتيحك عن طريق توسيع DefaultsKey . هذا يتيح لك استخدام تعبير عضو ضمني:

// Extend with a custom key
extension DefaultsKey {
    static var someKey : Key < Int > { Key ( " someKey " ) }
}

// Then use it like this
defaults . set ( " Some key " , for : . someKey )
defaults . get ( for : . someKey ) // Output: Some key

كائنات معقدة

لتخزين كائن معقد يتوافق مع البروتوكول القابل للترميز:

 struct Person : Codable {
    let name : String
    let age : Int
}

ثم:

// Create a key
let key = Key < Person > ( " personKey " )

// Get an instance of your Codable conforming enum, struct or class
let person = Person ( name : " Bonnie Greenwell " , age : 80 )

// Set the value
defaults . set ( person , for : key )

وأخيرا:

// Read it back
let person = defaults . get ( for : key )
person ? . name // Bonnie Greenwell
person ? . age  // 80

الأشياء المتداخلة

يمكنك أيضًا استخدام الكائنات المتداخلة طالما أنها تتوافق مع البروتوكول Codable :

 enum Pet : String , Codable {
    case cat
    case dog
}

struct Person : Codable {
    let name : String
    let pets : [ Pet ]
}

// Get a Codable conforming instante
let person = Person ( name : " Claire " , pets : [ . cat ] )

// Set the value
defaults . set ( person , for : key )

// And read it back
let person = defaults . get ( for : key )
person ? . name        // Claire
person ? . pets . first  // cat

رخصة

يتم إصدار DefaultSkit تحت رخصة معهد ماساتشوستس للتكنولوجيا. انظر الترخيص للحصول على التفاصيل.

مطلوب مساعدة

مراجعة/ترجمة readme.zh-cn.md إلى الصينية

اللغة الصينية هي اللغة المنطوقة رقم 1 في العالم وأحب أن أكون أكثر شمولاً ، للأسف أنا لا أتحدث الصينية. إذا كنت تعرف الصينية ، وترغب في المساعدة ، يرجى الاطلاع على العدد رقم 1

شكرًا لك