nrs

NRSimplePlist

Easy library to fetch and edit data from and to plists on the fly (Swift and Obj-C versions)

Showing:

Popularity

Downloads/wk

0

GitHub Stars

53

Maintenance

Last Commit

6yrs ago

Contributors

4

Package

Dependencies

0

License

MIT

Categories

Readme

NRSimplePlist

COCOAPODS pod 'NRSimplePlist', :head

ENGLISH

###Easy library to fetch and edit data from and to plists on the fly (Xcode)


Usage

Swift Version

Get values (return AnyObject):

 plistGet(key:String, forPlistNamed:String) -> AnyObject

Set value for key:

 plistSet(newValue:AnyObject, forKey:String, inPlistNamed:String)

With Arrays and Dictionaries you have to set the var to a .mutableCopy() of it before setting it:

 var value = plistGet(...)
 value = value.mutableCopy()

Example - Swift Version

Fetching the name of background music from the 'settings.plist' file into the project:

    var stringFromPlist : NSString = plistGet("settings", "backgroundMusic") as NSString

Editing the background music, saving the changes on the fly:

    //You can put this into a viewDidLoad method, a generic method, a class or where you need it!
    plistSet("bgMusic2.mp3", "backgroundMusic", "settings")
    //Set new value "bgMusic2.mp3" for key "backgroundMusic" in Plist named "settings"

Objective-C Version

Fetch values:

 + (id)valuePlist:(NSString *)plistName withKey:(NSString*)key;

edit values, depending of his type, with:

 //String
    +(void)editStringPlist:(NSString *)plistName withKey:(NSString*)key andString:(NSString*)string;

 //Number
     +(void)editNumberPlist:(NSString *)plistName withKey:(NSString*)key andNumber:(NSNumber*)number;

 //Bool
     +(void)editBoolPlist:(NSString *)plistName withKey:(NSString*)key andBool:(BOOL)boolValue;

 //Data
     +(void)editDataPlist:(NSString *)plistName withKey:(NSString*)key andData:(NSData*)data;

 //Date
     +(void)editDatePlist:(NSString *)plistName withKey:(NSString*)key andDate:(NSDate*)date;

 //Array
     +(void)editArrayPlist:(NSString *)plistName withKey:(NSString*)key andArray:(NSArray*)array;

 //Dictionary
     +(void)editDictionaryPlist:(NSString *)plistName withKey:(NSString*)key andDictionary:(NSDictionary*)dictionary;

Examples - Objective-C Version

Fetching the name of background music from the 'settings.plist' file into the project:

     NSString *stringFromPlist = [NRSimplePlist valuePlist:@"settings" withKey:@"backgroundMusic"];

Editing the background music, saving the changes on the fly:

    //You can put this into a viewDidLoad method, a generic method, a class or where you need it!
    [NRSimplePlist editStringPlist:@"settings" withKey:@"backgroundMusic" andString:@"bgMusic2.mp3"];

Easy, right? Let's give it a try!

N.B. If you want to save sensible data DON'T USE PLISTS! Use CoreData instead or MySQL/MySQLi database!

ITALIANO

###Semplice libreria per recuperare dati da file plist e modificarli al volo (Xcode)


Utilizzo

Versione Swift (solo in inglese per praticità)

Ritorna il valore passando una chiave (ritorna NSString):

 plistGet(key:String, forPlistNamed:String) -> AnyObject

Setta un valore nel file per la chiave passata:

 plistSet(newValue:AnyObject, forKey:String, inPlistNamed:String)

Con Array e Dictionary devi settare la variabile in una versione .mutableCopy() prima di poterli modificare:

 var value = plistGet(...)
 value = value.mutableCopy()

Esempio - Versione Swift

Estraiamo il nome della musica di sottofondo dal file 'settaggi.plist' presente nel progetto:

    var stringFromPlist : NSString = plistGet("settings", "backgroundMusic") as NSString

Modifichiamo ora la musica di sottofondo, salvando subito il cambiamento:

    plistSet("bgMusic2.mp3", "backgroundMusic", "settings")
    //Setta nuovo valore "bgMusic2.mp3" per la chiave "backgroundMusic" nel file Plist "settings"

Versione Objective-C

Recupera i valori con:

 + (id)valorePlist:(NSString *)nomeFile conChiave:(NSString*)chiave;

Modifica i valori, a seconda del tipo, con:

 //Stringa
    +(void)modificaStringaPlist:(NSString *)nomeFile conChiave:(NSString*)chiave eStringa:(NSString*)stringa;

 //Numero
     +(void)modificaNumeroPlist:(NSString *)nomeFile conChiave:(NSString*)chiave eNumero:(NSNumber*)numero;

 //Bool
     +(void)modificaBoolPlist:(NSString *)nomeFile conChiave:(NSString*)chiave eBool:(BOOL)valoreBooleano;

 //Data
     +(void)modificaDataPlist:(NSString *)nomeFile conChiave:(NSString*)chiave eData:(NSData*)data;

 //Date
     +(void)modificaDatePlist:(NSString *)nomeFile conChiave:(NSString*)chiave eDate:(NSDate*)date;

 //Array
     +(void)modificaArrayPlist:(NSString *)nomeFile conChiave:(NSString*)chiave eArray:(NSArray*)array;

 //Dictionary
     +(void)modificaDictionaryPlist:(NSString *)nomeFile conChiave:(NSString*)chiave eDictionary:(NSDictionary*)dictionary;

Esempio - Versione Objective-C

Estraiamo il nome della musica di sottofondo dal file 'settaggi.plist' presente nel progetto:

     NSString *stringaDaPlist = [NRSimplePlist valorePlist:@"settaggi" conChiave:@"musicaSottofondo"];

Modifichiamo ora la musica di sottofondo, salvando subito il cambiamento:

    [NRSimplePlist modificaStringaPlist:@"settaggi" conChiave:@"musicaSottofondo" eStringa:@"sottofondo2.mp3"];

Semplice no? Provaci anche tu!

N.B. Se devi passare dati sensibili NON USARE LE PLIST ma utilizza CoreData o i database MySQL o MySQLi!

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100