iOS NSUserDefaults简介

薛涛
2023-12-01

1. NSUserDefaults初始化

NSUserDefaults以键值对的形式进行数据存储,适合存储轻量级的本地数据。iOS系统是以一个.plist文件来统一管理。

NSUserDefaults *userDefaults = [NSUserDefaults standardUserDefaults];

2. 主要方法

NSUserDefaults支持的数据结构有NSIntegerBOOLNSURLNSStringNSArray, NSDictionaryNSData等,NSUserDefaults对象默认会将数据存入Library/Preferences目录。

// 获取整型值
- (NSInteger)integerForKey:(NSString *)defaultName;
// 获取浮点型
- (float)floatForKey:(NSString *)defaultName;
// 获取双精度浮点数
- (double)doubleForKey:(NSString *)defaultName;
// 获取布尔型
- (BOOL)boolForKey:(NSString *)defaultName;
// 获取URL对象
- (nullable NSURL *)URLForKey:(NSString *)defaultName;
// 获取字符串
- (nullable NSString *)stringForKey:(NSString *)defaultName;
// 获取数组数据
- (nullable NSArray *)arrayForKey:(NSString *)defaultName;
// 获取字典数据
- (nullable NSDictionary<NSString *, id> *)dictionaryForKey:(NSString *)defaultName;
// 获取NSData型数据
- (nullable NSData *)dataForKey:(NSString *)defaultName;
// 获取字符串数组
- (nullable NSArray<NSString *> *)stringArrayForKey:(NSString *)defaultName;

// 设置整型
- (void)setInteger:(NSInteger)value forKey:(NSString *)defaultName;
// 设置浮点型
- (void)setFloat:(float)value forKey:(NSString *)defaultName;
// 设置双精度浮点数
- (void)setDouble:(double)value forKey:(NSString *)defaultName;
// 设置布尔型
- (void)setBool:(BOOL)value forKey:(NSString *)defaultName;
// 设置URL对象
- (void)setURL:(nullable NSURL *)url forKey:(NSString *)defaultName;
// 设置对象
- (void)setObject:(nullable id)value forKey:(NSString *)defaultName;

其他操作

// 删除数据
- (void)removeObjectForKey:(NSString *)defaultName;

// 同步,存储到硬盘
- (BOOL)synchronize;

3. NSUserDefaults域

NSUserDefaults由多个层级的域组成的,当你读取一个键值的数据时,NSUserDefaults从上到下透过域的层级寻找正确的值,不同的域有不同的功能。默认包含五个Domain,如下:

  • 参数域(NSArgumentDomain),有最高优先权,代表的是命令行参数
  • 应用域(Application),是最重要的域,NSUserDefaultssetXX:forKey:方法默认数据保存在这里
  • 全局域(NSGlobalDomain),存储着系统的设置,一般来说是系统Frameworks取来使用
  • 语言域(Languages),则包括地区、日期等
  • 注册域(NSRegistrationDomain),仅有较低的优先权,只有在应用域没有找到值时才从注册域去寻找

在读取数据时,搜索的顺序是这样:

NSArgumentDomain > Application > NSGlobalDomain > Languages > NSRegistrationDomain

常用registerDefaults方法在注册域(NSRegistrationDomain)中设置默认值

- (void)registerDefaults:(NSDictionary<NSString *, id> *)registrationDictionary;
 类似资料: