Emoji regular expressions for Swift.
Swift Ruby Objective-C
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Sources
SwiftEmoji-OSX
SwiftEmoji-iOS
SwiftEmoji.xcodeproj
SwiftEmoji.xcworkspace
SwiftEmojiTests
tasks
.gitignore
LICENSE.txt
Package.swift
README.md
Rakefile
SwiftEmoji.podspec

README.md

Swift Emoji

SwiftEmoji provides a set of regular expressions to find emoji in swift strings. All forms of emoji are matched, including:

  • Single-character emoji (πŸ‘)
  • Emoji that are variants of other characters (e.g. ⌚️ instead of ⌚︎)
  • Fitzpatrick Modifiers (e.g. skintones πŸ‘πŸ»πŸ‘πŸΌπŸ‘πŸ½πŸ‘πŸΎπŸ‘πŸΏ)
  • ZWJ Sequences (e.g. πŸ’‘)
  • Combining sequences and Combining Marks (e.g. 0️⃣)
  • Flag sequences (e.g πŸ‡¨πŸ‡¦)

All emoji are derived directly from the standard unicode data files, using an automated script.

Usage

The Emoji class exposes a number of useful regular expressions as static variables. They each come in compiled (NSRegularExpression) and uncompiled (String) forms.

  • SingleEmojiPattern and SingleEmojiRegex match a single emoji character (grapheme cluster).
  • MultiEmojiPattern and MultiEmojiRegex match one or more consecutive emoji characters.

The String values are useful when composing your own expressions. For example, you could

Look at the source code in Emoji.swift for an example.

Installation

SwiftEmoji can be installed via CocoaPods, Carthage, or Swift Package Manager.

License

SwiftEmoji is released under the MIT License. Details are in the LICENSE.txt file in the project.