Swift JavaScript Ruby
Latest commit 5efbbed Feb 26, 2017 @onmyway133 Update README

README.md

Smile

Emoji in Swift. For reference, go to https://github.com/onmyway133/emoji

CI Status Version Carthage Compatible License Platform Swift

Features

List

List all emojis

Smile.list()
emojiList
emojiCategories

Emoji

Check if a character is emoji

Smile.isEmoji(character: "πŸŽ‰") // true

Check if a string contains any emoji

Smile.containsEmoji(string: "🎈 and 🎁") // true

Get emoji from unicode value

Smile.emoji(unicodeValue: 0x23F0) // ⏰

Get visible length of an emoji

"πŸ‘¨πŸΎβ€πŸŽ“".characters.count // 3
Smile.visibleLength(emoji: "πŸ‘¨πŸΎβ€πŸŽ“") // 1

Unmodify an emoji

Smile.unmodify(emoji: "πŸ‘¨πŸΏ") // πŸ‘¨

Name

Show standard name of an emoji

Smile.name(emoji: "πŸ‡³πŸ‡΄") // ["REGIONAL INDICATOR SYMBOL LETTER N", "REGIONAL INDICATOR SYMBOL LETTER O"])

Search emoji by keywords

Smile.emojis(keywords: ["GRINNING"]) // 😁, 😸

Flag

Search emoji flag by country code

Smile.emoji(countryCode: "no") // πŸ‡³πŸ‡΄

Alias

Search emoji by alias

Emoji data is from https://github.com/github/gemoji/blob/master/db/emoji.json

Smile.emoji(alias: "japanese_castle") // 🏯

Find alias by emoji

Smile.alias(emoji: "🏯") // japanese_castle

Replace alias within a string

Smile.replaceAlias(string: ":santa: is coming to :european_castle:") // πŸŽ… is coming to 🏰

Category

Find category of emoji

Emoji data is from https://github.com/github/gemoji/blob/master/db/Category-Emoji.json

Smile.category(emoji: "😁") // people

Manipulation

Extract all emojis within a string

Smile.extractEmojis(string: "Find πŸ”‘andπŸ”Ž") // πŸ”‘πŸ”Ž

Remove all emojis within a string

Smile.removeEmojis(string: "Find πŸ”‘andπŸ”Ž") // Find and

Assemble

Smile.assemble(emojis: ["πŸ‘¨", "🏫") // πŸ‘¨β€πŸ«
Smile.assemble(emojis: ["πŸ‘¨", "πŸ‘©", "πŸ‘§", "πŸ‘¦"] // πŸ‘¨β€πŸ‘©β€πŸ‘§β€πŸ‘¦

Disassemble

Smile.disassemble(emoji: "πŸ‘¨β€πŸ«") // [πŸ‘¨, 🏫]

Script

Update emoji list by running

node parser.js

Installation

Smile is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'Smile'

Smile is also available through Carthage. To install just write into your Cartfile:

github "onmyway133/Smile"

Author

Khoa Pham, onmyway133@gmail.com

Contributing

We would love you to contribute to Smile, check the CONTRIBUTING file for more info.

License

Smile is available under the MIT license. See the LICENSE file for more info.