〈extreme.framework/EFUtils.h〉

常用工具归于一处。

2.0～[这是什么?]

+objectIsNilOrNull:[这是什么?]

对象判空。(Validate the object is nil or null.)[这是什么?]

参数：

object 对象实例 id 必填

返回值：

BOOL 检查结果，YES 不存在或为空 NO 不为空。

+ (BOOL)objectIsNilOrNull:(id _Nonnull)object;

[这是什么?]

+stringIsNilOrNullOrEmpty:

字符串判空。(Validate the string is nil or null or empty.)

参数：

string NSString实例 NSString 必填

返回值：

BOOL 检查结果，YES 不存在或为空 NO 不为空。

+ (BOOL)stringIsNilOrNullOrEmpty:(NSString *_Nonnull)string;

+validateString:byRegExp:

使用正则表达式验证字符串值。(Validate the string by a regular expression.)

参数：

stringValue NSString实例 NSString 必填
regExp 用于验证的正则表达式 NSString 必填

返回值：

BOOL 检查结果，YES 合法 NO 不合法。

+ (BOOL)validateString:(NSString *_Nonnull)string byRegExp:(NSString *_Nonnull)regExp;

+objectValueIsNilOrNull:withKey:

字典中指定键值判空。(Validate the key value in a dictionary is nil or null.)

参数：

dictionary NSDictionary实例 NSDictionary 必填
key 键 NSString 必填

返回值：

BOOL 检查结果，YES 不存在或为空 NO 不为空。

+ (BOOL)objectValueIsNilOrNull:(NSDictionary *_Nonnull)dictionary withKey:(NSString *_Nonnull)key;

+objectValueIsEqualTo:dictionary:withKey:

字典中指定键值是否等于指定数值。(Validate the key value in a dictionary is equal to another integer value in a NSNumber or NSString object or not.)

参数：

value NSNumber或者 NSString实例，其中包含一个整数值 id 必填
dictionary NSDictionary实例 NSDictionary 必填
key 键 NSString 必填

返回值：

BOOL 检查结果，YES 等于 NO 不等于。

+ (BOOL)objectValueIsEqualTo:(id _Nonnull)value dictionary:(NSDictionary *_Nonnull)dictionary withKey:(NSString *_Nonnull)key;

+validateDictionary:

字典中所有的值都不为空，注意之前 +validDictionary: 返回的值已发生反转。(Validate all values in a dictionary is all not empty, note that the returned value from +validDictionary: has been reversed.)

参数：

dictionary NSDictionary实例 NSDictionary 必填

返回值：

BOOL 检查结果，YES 均不为空 NO 不是字典或者字典中至少一个键值不存在或为空。

+ (BOOL)validateDictionary:(NSDictionary *_Nonnull)dictionary;

+boolValueFromNumber:

将NSNumber转换为BOOL。(Bool value from a NSNumber object.)

参数：

number NSNumber实例 NSNumber 非必填

返回值：

BOOL 转换number中对应的boolValue，若number不存在或为空则直接返回NO。

+ (BOOL)boolValueFromNumber:(NSNumber *_Nullable)number;

+JSONToString:

JSON(字典或数组)转 JSON字符串。(JSON to string.)

参数：

json JSON，一般是以 NSDictionary或 NSArray为根 id 必填

返回值

NSString 转换后的 JSON字符串，可以为空。

+ (NSString *_Nullable)JSONToString:(id _Nonnull)json;

+stringToJSON:

JSON字符串转 JSON(字典或数组)。(String to JSON.)

参数：

jsonString JSON字符串 NSString 必填

返回值

id 转换后的 JSON，一般是以 NSDictionary或 NSArray为根，可以为空。

+ (NSString *_Nullable)JSONToString:(id _Nonnull)json;

+stringFromDateFormattedString:dateFormat:

日期字符串(例如：2017-07-12)转格式。(Date string with date format to date string with your date fomartter.)

参数：

dateFormattedString 转格式之前传入的日期字符串，例如：2017-07-12 NSString 必填
dateFormat 转格式指定的自定义日期格式显示模版 NSString 必填

返回值：

NSString 转格式之后的字符串，可以为空。

+ (NSString *_Nullable)stringFromDateFormattedString:(NSString *_Nonnull)dateFormattedString dateFormat:(NSString *_Nonnull)dateFormat;

+stringFromDateFormattedString:dateTime:dateFormat:

日期字符串(例如：2017-07-12)或日期时间字符串(例如：2017-07-12 16:00)转格式。(Date string with date format or date and time format to date string with your date fomartter.)

参数：

dateFormattedString 转格式之前传入的日期字符串(例如：2017-07-12)或日期时间字符串(例如：2017-07-12 16:00)，由 dateTime决定 NSString 必填
dateTime 转格式之前传入的是日期字符串还是日期时间字符串，YES 日期时间字符串 NO 日期字符串 BOOL
dateFormat 转格式指定的自定义日期格式显示模版 NSString 必填

返回值：

NSString 转格式之后的字符串，可以为空。

+ (NSString *_Nullable)stringFromDateFormattedString:(NSString *_Nonnull)dateFormattedString dateTime:(BOOL)dateTime dateFormat:(NSString *_Nonnull)dateFormat;

+stringFromDateFormattedString:dateFormatIn:dateFormatOut:

日期格式字符串转格式。(Date string with date fomartter 1 to data string with date fomartter 2.)

参数：

dateFormattedString 转格式之前传入的日期格式字符串 NSString 必填
dateFormatIn 转格式之前传入的自定义日期格式显示模版 NSString 必填
dateFormatOut 转格式指定的自定义日期格式显示模版 NSString 必填

返回值：

NSString 转格式之后的字符串，可以为空。

+ (NSString *_Nullable)stringFromDateFormattedString:(NSString *_Nonnull)dateFormattedString dateFormatIn:(NSString *_Nonnull)dateFormatIn dateFormatOut:(NSString *_Nonnull)dateFormatOut;

+dateFromDateFormattedString:

日期字符串(例如：2017-07-12)转日期对象。(Date string with date fomart to NSDate.)

参数：

dateFormattedString 转格式之前传入的日期字符串(例如：2017-07-12) NSString 必填

返回值：

NSDate 转换后的日期对象，可以为空。

+ (NSDate *_Nullable)dateFromDateFormattedString:(NSString *_Nonnull)dateFormattedString;

+dateFromDateFormattedString:dateTime:

日期字符串(例如：2017-07-12)或日期时间字符串(例如：2017-07-12 16:00)转日期对象。(Date string with date format or date and time format to NSDate.)

参数：

dateFormattedString 转格式之前传入的日期字符串(例如：2017-07-12)或日期时间字符串(例如：2017-07-12 16:00)，由 dateTime决定 NSString 必填
dateTime 转格式之前传入的是日期字符串还是日期时间字符串，YES 日期时间字符串 NO 日期字符串 BOOL

返回值：

NSDate 转换后的日期对象，可以为空。

+ (NSDate *_Nullable)dateFromDateFormattedString:(NSString *_Nonnull)dateFormattedString dateTime:(BOOL)dateTime;

+dateFromDateFormattedString:dateFormatIn:

日期格式字符串转日期对象。(Date string with date fomartter to NSDate.)

参数：

dateFormattedString 转格式之前传入的日期格式字符串 NSString 必填
dateFormatIn 转格式之前传入的自定义日期格式显示模版 NSString 必填

返回值：

NSDate 转换后的日期对象，可以为空。

+ (NSDate *_Nullable)dateFromDateFormattedString:(NSString *_Nonnull)dateFormattedString dateFormatIn:(NSString *_Nonnull)dateFormatIn;

+dataBase64EncodingWith:

编码为 base64字符串。(NSData base64 encoding.)

参数：

data NSData实例 NSData 必填

返回值：

NSString 返回编码后的 base64字符串，可以为空。

+ (NSString *_Nullable)dataBase64EncodingWith:(NSData *_Nonnull)data;

+dataBase64DecodingFrom:

解码为 NSData。(NSData base64 decoding.)

参数：

base64EncodedString 编码后的 base64字符串 NSString 必填

返回值：

NSData 返回解码后的 NSData实例，可以为空。

+ (NSData *_Nullable)dataBase64DecodingFrom:(NSString *_Nonnull)base64EncodedString;

COLOR_HEXSTRING(hexString)

+colorWithHexString:

十六进制颜色码(例如：不带不透明度 #FFFFFF或带不透明度 #1EFFFFFF)转 UIColor。(Color with hex string of color.)

参数：

hexString 十六进制颜色码，例如：不带不透明度 #FFFFFF或带不透明度 #1EFFFFFF NSString 必填

返回值：

UIColor 返回 UIColor实例，可以为空。

+ (UIColor *_Nullable)colorWithHexString:(NSString *_Nonnull)hexString;

COLOR_HEXSTRING_ALPHA(hexString, alphaValue)

+colorWithHexString:alpha:

十六进制颜色码(不带不透明度，例如：#FFFFFF)外挂不透明度转 UIColor。(Color with hex string of color and alpha value.)

参数：

hexString 十六进制颜色码，例如：不带不透明度 #FFFFFF或带不透明度 #1EFFFFFF NSString 必填
alpha 外挂不透明度，0～1 CGFloat

返回值：

UIColor 返回 UIColor实例，可以为空。

+ (UIColor *_Nullable)colorWithHexString:(NSString *_Nonnull)hexString alpha:(CGFloat)alpha;

+hexStringWithColor:

HEXSTRING_COLOR(color)

UIColor转十六进制颜色码，例如：不带不透明度 #FFFFFF或带不透明度 #1EFFFFFF。(Full hex string with color.)

参数：

color UIColor实例 UIColor 必填

返回值：

NSString 返回十六进制颜色码，例如：不带不透明度 #FFFFFF或带不透明度 #1EFFFFFF，可以为空。

+ (NSString *_Nullable)hexStringWithColor:(UIColor *_Nonnull)color;

+sharedControllerInstanceWithStoryName:andStoryboardID:

获取 storyboard中的控制器实例。(Get the instance of the controller which your given a name in a storyboard.)

参数：

storyboardName storyboard文件名，不含后缀 NSString 必填
storyboardID 控制器的 storyboardID NSString 必填

返回值：

id 控制器实例，非空。

+ (id _Nonnull)sharedControllerInstanceWithStoryName:(NSString *_Nonnull)storyboardName andStoryboardID:(NSString *_Nonnull)storyboardID;

+removeAllSubviewsOf:

移除所有子视图。(Remove all subviews of parent view.)

参数：

parentView 父类 UIView 必填

返回值

无

+ (void)removeAllSubviewsOf:(UIView *_Nonnull)parentView;

+generateQRCode:width:height:

生成二维码。(Generate a QRCode image, then return it.)

参数：

code 字符串 NSString 必填
width 宽 CGFloat
height 高 CGFloat

返回值

UIImage QRCode Image，可以为空。

+ (UIImage *_Nullable)generateQRCode:(NSString *_Nonnull)code width:(CGFloat)width height:(CGFloat)height;

1.5～

+stringFromDictionary:withKey:

字典中指定键值转换为字符串。(String value from the key value in a dictionary.)

参数：

dictionary NSDictionary实例 NSDictionary 必填
key 键 NSString 必填

返回值：

NSString 转换的字符串，如果指定键值不是 NSString或者 NSNumber，则返回 nil，可以为空。

+ (NSString *_Nullable)stringFromDictionary:(NSDictionary *_Nonnull)dictionary withKey:(NSString *_Nonnull)key;

+stringFromDate:

日期对象转日期时间字符串，例如：2017-07-12 16:00。(NSDate to date string with date and time format.)

参数：

date NSDate实例 NSDate 必填

返回值：

NSString 返回转格式之后的字符串，可以为空。

+ (NSString *_Nullable)stringFromDate:(NSDate *_Nonnull)date;

+stringFromDate:dateTime:

日期对象转日期字符串(例如：2017-07-12)或日期时间字符串(例如：2017-07-12 16:00)。(NSDate to date string with date format or date and time format.)

参数：

date NSDate实例 NSDate 必填
dateTime 转格式会自动指定哪个日期格式显示模版，YES 日期时间字符串 NO 日期字符串 BOOL

返回值：

NSString 返回转格式之后的字符串，可以为空。

+ (NSString *_Nullable)stringFromDate:(NSDate *_Nonnull)date dateTime:(BOOL)dateTime;

+stringFromDate:dateFormat:

日期对象转日期格式字符串，可自定义日期格式显示模版。(NSDate to date string with your date fomartter.)

参数：

date NSDate实例 NSDate 必填
dateFormat 转格式指定的自定义日期格式显示模版 NSString 必填

返回值：

NSString 返回转格式之后的字符串，可以为空。

+ (NSString *_Nullable)stringFromDate:(NSDate *_Nonnull)date dateFormat:(NSString *_Nonnull)dateFormat;

1.5 (Deprecated in 2.0)

+sharedStoryboardInstanceWithStoryName:storyboardID:

获取 storyboard中控制器的实例。

参数：

storyboardName storyboard文件名，不含后缀 NSString 必填
storyboardID 控制器的 storyboardID NSString 必填

返回值：

id 控制器实例，非空。

+ (id _Nonnull)sharedStoryboardInstanceWithStoryName:(NSString *_Nonnull)storyboardName storyboardID:(NSString *_Nonnull)storyboardID;

+checkValue:byRegExp:

检查字符串值是否合法

参数：

stringValue 字符串值 NSString 必填
regExp 用于检查的正则表达式 NSString 必填

返回值：

BOOL 检查结果，YES 合法 NO 不合法。

+ (BOOL)checkValue:(NSString *_Nonnull)stringValue byRegExp:(NSString *_Nonnull)regExp;

+objectIsNullOrEmpty:

对象判空

参数：

object 对象 id 必填

返回值：

BOOL 检查结果，YES 不存在或为空 NO 不为空。

+ (BOOL)objectIsNullOrEmpty:(id _Nonnull)object;

+stringIsNullOrEmpty:

字符串判空

参数：

string 字符串值 NSString 必填

返回值：

BOOL 检查结果，YES 不存在或为空 NO 不为空。

+ (BOOL)stringIsNullOrEmpty:(NSString *_Nonnull)string;

+objectIsNull:withKey:

判断字典指定键值是否为空

参数：

dictionary NSDictionary实例 NSDictionary 必填
key 键 NSString 必填

返回值：

BOOL 检查结果，YES 不存在或为空 NO 不为空。

+ (BOOL)objectIsNull:(NSDictionary *_Nonnull)dictionary withKey:(NSString *_Nonnull)key;

+validDictionary:

字典中是否有键值不存在或为空。(Validate every key value in a dictionary at least one is nil or null.)

参数：

dictionary NSDictionary实例 NSDictionary 必填

返回值：

BOOL 检查结果，YES 至少一个键值不存在或为空 NO 均不为空。

+ (BOOL)validDictionary:(NSDictionary *_Nonnull)dictionary;

+stringFromDateString:dateFormat:

日期字符串(例如：2017-07-12)转格式。(Date string to string with your date fomartter.)

参数：

dateString 转格式之前传入的日期字符串，例如：2017-07-12 NSString 必填
dateFormat 转格式指定的自定义日期格式显示模版 NSString 必填

返回值：

NSString 返回转格式之后的字符串，可以为空。

+ (NSString *_Nullable)stringFromDateString:(NSString *_Nonnull)dateString dateFormat:(NSString *_Nonnull)dateFormat;

+stringFromDateTimeString:dateTime:dateFormat:

日期字符串或日期时间字符串转格式

参数：

dateTimeString 转格式之前的日期字符串 yyyy-MM-dd或日期时间字符串 yyyy-MM-dd HH:mm:ss，由 dateTime 决定 NSString 必填
dateTime 传入转格式之前的是日期字符串还是日期时间字符串，YES 日期时间字符串 NO 日期字符串 BOOL
dateFormat 转换格式模版 NSString 必填

返回值：

NSString 返回转格式之后的字符串，可以为空。

+ (NSString *_Nullable)stringFromDateTimeString:(NSString *_Nonnull)dateTimeString dateTime:(BOOL)dateTime dateFormat:(NSString *_Nonnull)dateFormat;

__BASE64( text )

+base64StringFromText:

参数：

text 文本 NSString 必填

返回值：

NSString 经本地DES加密后的base64格式字符串，可以为空。

__TEXT( base64 )

+textFromBase64String:

参数：

base64 经本地DES加密后的base64格式字符串 NSString 必填

返回值：

NSString 还原的文本，可以为空。

#define __BASE64( text )        [EFUtils base64StringFromText:text]
#define __TEXT( base64 )        [EFUtils textFromBase64String:base64]

+ (NSString *_Nullable)base64StringFromText:(NSString *_Nonnull)text;
+ (NSString *_Nullable)textFromBase64String:(NSString *_Nonnull)base64;

相关

• EFUtils示例(1)-验证值是否合法
• EFUtils示例(2)-转换
• EFUtils示例(3)-日期格式字符串格式化
• EFUtils示例(4)-编码为base64字符串和解码为NSData
• EFUtils示例(5)-用类似”#FF0000”初始化UIColor

更新内容

1. 验证新的方法。
2. 转换新的方法。
3. 新增 NSData基于 Base64String的编码与解码方法。
4. 新增 UIColor工具。
5. UIKit新的方法。
6. 新增相关代码示例。