README-zh.md

PySwiftyRegex

像Python一样简洁高效地作正则处理。

English 日本語 한국어

先上代码

import PySwiftyRegex

if let m = re.search("[Tt]his is (.*?)easy", "I think this is really easy!!!") {
	m.group()  // "this is really easy"
	m.group(1) // "really "
}

查看 常见用例.

环境

• iOS 7.0+ / Mac OS X 10.9+
• Xcode 8.0+

Swift 2.3请使用0.3.0版。

导入

使用 Embedded frameworks 至少需要 iOS 8 或 OS X Mavericks.

如果您的项目需要支持iOS 7但仍想使用 PySwiftyRegex, 您需要将源代码文件 PySwiftyRegex.swift 下载并添加到您的Xcode项目中。

CocoaPods(iOS 8+, OS X 10.9+)

您可以通过 Cocoapods 来将 PySwiftyRegex 添加到您的项目中。 下面是一个示例的Podfile:

platform :ios, '8.0'
use_frameworks!

target 'MyApp' do
	pod 'PySwiftyRegex', '~> 0.2.0'
end

配置好Podfile后执行如下命令:

$ pod install

Carthage(iOS 8+, OS X 10.9+)

往 Cartfile 或 Cartfile.private 中加入如下一行:

github "cezheng/PySwiftyRegex" ~> 0.2.0

然后执行如下命令:

$ carthage update

最后将Carthage编译出来的PySwiftyRegex.framework拖拽入目标的General -> Embedded Binaries。

已实现的re模块方法

如果您已有 re 模块的使用经验, 那么基本上将这个库导入到项目中就可以直接开始用了。 如果没有，或许可以点击下方的链接传送到Python的文档页面大致了解一下为何re模块会比NSRegualarExpression的API更加好用。

re

• re.compile
• re.search
• re.match
• re.split
• re.findall
• re.finditer
• re.sub
• re.subn

re.RegexObject

• search
• match
• split
• findall
• finditer
• sub
• subn

re.MatchObject

• expand
• group
• groups
• span

常用方法用例

创建可重复使用的正则表达式对象

let regex = re.compile("this(.+)that")

从字符串起始点开始匹配

if let m = regex.match("this one is different from that") {
	m.group()  //"this one is different from that"
	m.group(1) //" one is different from "
}

在字符串中搜索第一个匹配

if let m = regex.search("I want this one, not that one") {
	m.group()  //"this one, not that one"
	m.group(1) //" one, not "
}

查找所有匹配字串

regex.findall("this or that, this and that") // ["this or that", "this and that"]

获得所有匹配字串的匹配结果

for m in regex.finditer("this or that, this and that") {
	m.group()  // 第1次: "this or that", 第2次: "this and that"
	m.group(1) // 第1次: " or ", 第2次: " and "
}

用正则表达式分割字符串

let regex = re.compile("[\\+\\-\\*/]")

// 默认将做最多次分割
regex.split("1+2-3*4/5")    // ["1", "2", "3", "4", "5"]

// 设定最大分割次数为2
regex.split("1+2-3*4/5", 2) // ["1", "2", "3*4/5"]

正则替换

let regex = re.compile("[Yy]ou")

// 替换所有匹配 (本例中替换了2次)
regex.sub("u", "You guys go grap your food")     // "u guys go grap ur food"
regex.subn("u", "You guys go grap your food")    // ("u guys go grap ur food", 2)

// 设定最大替换次数 (本例中替换了1次)
regex.sub("u", "You guys go grap your food", 1)  // "u guys go grap your food"
regex.subn("u", "You guys go grap your food", 1) // ("u guys go grap your food", 1)

开源协议

PySwiftyRegex 使用MIT许可协议。 详见 LICENSE 。