Latest 1.03
Homepage https://github.com/kittymo/MoRegex
License MIT
Platforms ios 9.0, osx 10.10, requires ARC
Authors

CocoaPods Platform

MoRegex 讓你輕鬆的在 Swift 裡使用正規表示式(Regular Expression)

為什麼要用這個?

iOS 原生的正規表示式並不友善, 我們經常只想做一些簡單的字串判斷, 但需要很多程式碼才能完成,
MoRegex 把這些繁瑣的程式碼封裝成一個簡易使用的運算子(Operator)判斷式,
讓您只需要一行程式就可以做簡單的正規表示式判斷(Regular Expressions Matches)



比如我們 UI 上有一個輸入格, 讓使用者輸入 email, 我們必須檢查使用者輸入的是不是正確的 email 格式



例如:

let str1 = "02-12345678"       
if let res = str1 =~ "(\d\d)\-(\d\d\d\d\d\d\d\d)" {
  print("1 res=(res)")
  // PRINT: 1 res=["02-12345678", "02", "12345678"]
}

let str2 = "[email protected]"
if let res = str2.regexMatch(check: .mail) {        // 電子郵件
    // PRINT: res=["[email protected]", "hello-kitty", "mail", "com"]
}

對 String 使用 =~ 運算子操作, 會回傳一個匹配的陣列, 如果匹配失敗會回傳 nil

系統需求 Requirements

  • iOS 9.0+ | macOS 10.10+
  • Xcode 9
  • Swift 3 or 4

功能特徵 Features

  • 運算子 =~ 操作
  • 指定樣板替換字串
  • 指定匹配欄位替換字串
  • 內含簡易的常用判斷式

如何安裝 使用CocoaPods (iOS 9+, OS X 10.10+)

你可以使用 CocoaPods 來安裝, 把MoRegex加到你的Podfile:

platform :ios, '9.0'
use_frameworks!

target 'MyApp' do
    pod 'MoRegex'
end

如何安裝 使用Swift Package Manager

你可以使用 The Swift Package Manager 來安裝, 在你的Package.swift加入MoRegex:

import PackageDescription

let package = Package(
    name: "YOUR_PROJECT_NAME",
    targets: [],
    dependencies: [
        .Package(url: "https://github.com/kittymo/MoRegex.git", majorVersion: 1),
    ]
)

如何安裝 手動Manually

  1. 下載本套件的 MoRegex.swift
  2. 把這個檔案加進你的 xcode 專案裡
  3. 安裝完成了

如何使用 Usage

1. 使用 =~ 運算子

let str1 = "02-12345678"    // 想判斷的字串

// 取出前後2組字串
if let res = str1 =~ "(\d\d)\-(\d\d\d\d\d\d\d\d)" {
    // PRINT: res=["02-12345678", "02", "12345678"]
}

// 取出3組字串
if let res = str1 =~ "(\d\d)\-(\d\d\d\d)(\d\d\d\d)" {
    // PRINT: res=["02-12345678", "02", "1234", "5678"]
}

// 判斷是否含有 12345
if let res = str1 =~ "12345" {
    // PRINT: res=["12345"]
}

// 取出 - 符號後的字串
if let res = str1 =~ "\-(.*+)" {
    // PRINT: res=["-12345678", "12345678"]
}

2. 使用 regexMatch

regexMatch 的功能與 =~ 運算子相同

let str1 = "02-12345678"
if let res = str1.regexMatch("(\d\d)\-(\d\d\d\d)(\d\d\d\d)") {
    // PRINT: res=["02-12345678", "02", "1234", "5678"]
}

3. 使用 regexReplace

regexReplace 可以讓你以樣板字串的方式重新組合取出的字串

let str1 = "02-12345678"
if let res = str1.regexReplace("(\d\d)\-(\d\d\d\d)(....)", template: "($1)$2-$3") {
    // PRINT: res=(02)1234-5678
}

4. 使用 regexMatchSub

regexMatchSub 允許你傳入一個字串陣列, 並依順序替換掉已匹配的字串

let str1 = "02-12345678"
if let res = str1.regexMatchSub("(\d\d)\-(\d\d\d\d)(....)", replaces: ["AB", nil, "CDE"]) {
    // PRINT: res=["AB-1234CDE", "02", "1234", "5678"]
    // res[0] "AB-1234CDE" 是替換後的結果
}

將傳入的 "02-12345678" 經過匹配替換後變成 "AB-1234CDE"

5. 檢查一些常用的判斷式

MoRegex 已經內建幾個常用的表示式, 您可以用更簡單的方式做這些常用的判斷

let str2 = "[email protected]"
if let res = str2.regexMatch(check: .mail) {        // 電子郵件
    // PRINT: res=["[email protected]", "hello-kitty", "mail", "com"]
}

let str3 = "2017-09-30"
if let res = str3.regexMatch(check: .date) {        // 日期 年-月-日
    // PRINT: res=["2017-09-30", "2017", "09", "30"]
}

let str4 = "02-12341234"
if let res = str4.regexMatch(check: .telphone) {    // 市話
    // PRINT: res=["02-12341234", "02", "1234", "1234"]
}

let str5 = "0901-123123"
if let res = str5.regexMatch(check: .mobile) {      // 行動電話
    // PRINT: res=["0901-123123", "0901", "123", "123"]
}

let str6 = "<center>TEST</center>"
if let res = str6.regexMatch(check: .htmlTag) {     // HTML標籤
    // PRINT: res=["<center>TEST</center>", "center", "", "TEST"]
}

let str7 = "21:05:43"
if let res = str7.regexMatch(check: .time) {    // 時間(24小時制)
    // PRINT: res=["21:05:43", "21", "05", "43"]
}

let str9 = "https://hello.kitty.com/index.html"
if let res = str9.regexMatch(check: .url) {    // 網址
    // PRINT: res=["https://hello.kitty.com/index.html", "https://", "hello.kitty", "com", ""]
}

let str10 = "#F390CC"
if let res = str10.regexMatch(check: .colorHex) {    // 色碼
    // PRINT: res=["#F390CC", "F390CC"]
}

let str11 = "-12345"
if let res = str11.regexMatch(check: .number) {    // 整數數字
    // PRINT: res=["-12345"]
}

上面的檢查範例也可以用 regexCheck 來完成

let str12 = "-12345"
if let res = str12.regexCheck(.number) {    // 整數數字
    print("res=(res)")
    // PRINT: res=["-12345"]
}

6. 可以加入參數選項

MoRegex 是封裝 iOS 的 NSRegularExpression 函數, 因此也能傳入 NSRegularExpression 的 options 選項

以區分大小寫來做示範

let str8 = "My name is Kitty"

// 若沒加 options 參數, 則預設文字比對為不區分大小寫 options: [.caseInsensitive]
if let res = str8.regexMatch("kitty") {
    // PRINT: res=["Kitty"]
}

if let res = str8.regexMatch("kitty", options: []) {   // 區分大小寫
    // 因為匹配不成功, 這裡不會被執行
} else {
    // PRINT: NOT MATCH
}

Latest podspec

{
    "name": "MoRegex",
    "version": "1.03",
    "summary": "Regular Expression Helper for Swift",
    "homepage": "https://github.com/kittymo/MoRegex",
    "license": {
        "type": "MIT"
    },
    "authors": {
        "KittyMei": "[email protected]"
    },
    "platforms": {
        "ios": "9.0",
        "osx": "10.10"
    },
    "source": {
        "git": "https://github.com/kittymo/MoRegex.git",
        "tag": "1.03"
    },
    "source_files": "MoRegex/MoRegex.swift",
    "requires_arc": true,
    "pushed_with_swift_version": "3.2"
}

Pin It on Pinterest

Share This