正则表达式的创建
NSRegularExpression
iOS中 NSRegularExpression
类代表正则表达式,下面我们来看看的NSRegularExpression.h头文件声明定义
属性声明:
///正则匹配模式
@property (readonly, copy) NSString *pattern;
///正则匹配选项
@property (readonly) NSRegularExpressionOptions options;
///捕获的数量
@property (readonly) NSUInteger numberOfCaptureGroups;
可以看到属性都是可读的, 其中options是一个 NSRegularExpressionOptions枚举类型
typedef NS_OPTIONS(NSUInteger, NSRegularExpressionOptions) {
NSRegularExpressionCaseInsensitive = 1 << 0, /* Match letters in the pattern independent of case. 不区分字母大小写的模式*/
NSRegularExpressionAllowCommentsAndWhitespace = 1 << 1, /* Ignore whitespace and #-prefixed comments in the pattern. 忽略掉正则表达式中的空格和#号之后的字符*/
NSRegularExpressionIgnoreMetacharacters = 1 << 2, /* Treat the entire pattern as a literal string. 将正则表达式整体作为字符串处理*/
NSRegularExpressionDotMatchesLineSeparators = 1 << 3, /* Allow . to match any character, including line separators. 允许.匹配任何字符,包括换行符 */
NSRegularExpressionAnchorsMatchLines = 1 << 4, /* Allow ^ and $ to match the start and end of lines. 允许^和$符号匹配行的开头和结尾*/
NSRegularExpressionUseUnixLineSeparators = 1 << 5, /* Treat only \n as a line separator (otherwise, all standard line separators are used). 设置\n为唯一的行分隔符,否则所有的都有效。*/
NSRegularExpressionUseUnicodeWordBoundaries = 1 << 6 /* Use Unicode TR#29 to specify word boundaries (otherwise, traditional regular expression word boundaries are used). 使用Unicode TR#29标准作为词的边界,否则所有传统正则表达式的词边界都有效*/
};
方法列表声明
创建正则表达式对象提供了一个类方法和一个实例方法,可以看到需要提供正则匹配的pattern (模式),匹配条件选项和错误地址。
+ (nullable NSRegularExpression *)regularExpressionWithPattern:(NSString *)pattern options:(NSRegularExpressionOptions)options error:(NSError **)error;
- (nullable instancetype)initWithPattern:(NSString *)pattern options:(NSRegularExpressionOptions)options error:(NSError **)error NS_DESIGNATED_INITIALIZER;
我们已经知道正则表达式怎么创建了,下面让我们看看怎么使用, 头文件分别用NSRegularExpression (NSMatching) 和 NSRegularExpression (NSReplacement) 定义了一系列方法供开发者用来检索和替换。
+ (NSString *)escapedPatternForString:(NSString *)string;
正则表达式的匹配
匹配方法都声明在 NSRegularExpression (NSMatching)
分类中
@interface NSRegularExpression (NSMatching)
/*
遍历的模式,正则表达式匹配在指定options和range模式下匹配指定string,传入block中可以获取结果信息
*/
- (void)enumerateMatchesInString:(NSString *)string options:(NSMatchingOptions)options range:(NSRange)range usingBlock:(void (NS_NOESCAPE ^)(NSTextCheckingResult * _Nullable result, NSMatchingFlags flags, BOOL *stop))block;
/*
在指定options和range模式下匹配指定string,通过正则匹配返回一个匹配结果的数组
*/
- (NSArray<NSTextCheckingResult *> *)matchesInString:(NSString *)string options:(NSMatchingOptions)options range:(NSRange)range;
/*
返回满足条件的匹配次数
*/
- (NSUInteger)numberOfMatchesInString:(NSString *)string options:(NSMatchingOptions)options range:(NSRange)range;
/*
匹配返回的第一个结果,NSTextCheckingResult类型
*/
- (nullable NSTextCheckingResult *)firstMatchInString:(NSString *)string options:(NSMatchingOptions)options range:(NSRange)range;
/*
匹配返回的第一个结果的NSRange范围信息
*/
- (NSRange)rangeOfFirstMatchInString:(NSString *)string options:(NSMatchingOptions)options range:(NSRange)range;
@end
NSMatchingOptions 枚举
typedef NS_OPTIONS(NSUInteger, NSMatchingOptions) {
NSMatchingReportProgress = 1 << 0, //找到最长的匹配字符串后调用block回调
NSMatchingReportCompletion = 1 << 1, //找到任何一个匹配串后都回调一次block
NSMatchingAnchored = 1 << 2, //从匹配范围的开始处进行匹配
NSMatchingWithTransparentBounds = 1 << 3, //允许匹配的范围超出设置的范围
NSMatchingWithoutAnchoringBounds = 1 << 4 //禁止^和$自动匹配行还是和结束
};
NSMatchingFlags 枚举
typedef NS_OPTIONS(NSUInteger, NSMatchingFlags) {
NSMatchingProgress = 1 << 0, //匹配到最长串后被设置
NSMatchingCompleted = 1 << 1, //全部分配完成后被设置
NSMatchingHitEnd = 1 << 2, //匹配到设置范围的末尾时被设置
NSMatchingRequiredEnd = 1 << 3, //当前匹配到的字符串在匹配范围的末尾时被设置
NSMatchingInternalError = 1 << 4 //由于错误导致的匹配失败时被设置
};
正则表达式的替换
用新的字段来替换原文中符合规则的字段的方法都声明在 NSRegularExpression (NSReplacement)
分类中
@interface NSRegularExpression (NSReplacement)
/*
在指定的options和指定的range中,用新字段替换原文本中的对应字段,并返回操作后的NSString
*/
- (NSString *)stringByReplacingMatchesInString:(NSString *)string options:(NSMatchingOptions)options range:(NSRange)range withTemplate:(NSString *)templ;
/*
用新字段替换原文本中的对应字段,并返回操作次数(替换字段的个数)
*/
- (NSUInteger)replaceMatchesInString:(NSMutableString *)string options:(NSMatchingOptions)options range:(NSRange)range withTemplate:(NSString *)templ;
/*
在 string 中查找由 result + offset 指定的字符串, 返回 template 指定的字符串(比如$0-9等)
*/
- (NSString *)replacementStringForResult:(NSTextCheckingResult *)result inString:(NSString *)string offset:(NSInteger)offset template:(NSString *)templ;
/*
正则表达式字符串, 包括一些特殊字符.
*/
+ (NSString *)escapedTemplateForString:(NSString *)string;
@end
如果觉得原生的复杂,github上面star比较多的也开源库
如 objective-C-RegEx-Categories 简单好用。