Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/amayne/SwiftString
A comprehensive, lightweight string extension for Swift
https://github.com/amayne/SwiftString
Last synced: about 2 months ago
JSON representation
A comprehensive, lightweight string extension for Swift
- Host: GitHub
- URL: https://github.com/amayne/SwiftString
- Owner: amayne
- License: mit
- Created: 2016-01-31T16:01:39.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2017-03-23T08:41:23.000Z (almost 8 years ago)
- Last Synced: 2024-04-23T19:19:52.587Z (9 months ago)
- Language: Swift
- Homepage:
- Size: 920 KB
- Stars: 1,614
- Watchers: 31
- Forks: 147
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios-star - SwiftString - A comprehensive, lightweight string extension for Swift. (Text / Other Testing)
- awesome-swift-cn - SwiftString - A lightweight string extension for Swift. (Libs / Text)
- awesome-ios - SwiftString - A comprehensive, lightweight string extension for Swift. (Text / Other Testing)
README
# SwiftString
[![CI Status](http://img.shields.io/travis/amayne/SwiftString.svg?style=flat)](https://travis-ci.org/amayne/SwiftString)
[![Version](https://img.shields.io/cocoapods/v/SwiftString.svg?style=flat)](http://cocoapods.org/pods/SwiftString)
[![License](https://img.shields.io/cocoapods/l/SwiftString.svg?style=flat)](http://cocoapods.org/pods/SwiftString)
[![Platform](https://img.shields.io/cocoapods/p/SwiftString.svg?style=flat)](http://cocoapods.org/pods/SwiftString)
[![Swift-2.1](http://img.shields.io/badge/Swift-2.1-blue.svg)]()SwiftString is a lightweight string extension for Swift.
This library was motivated by having to search StackOverflow for common string operations,
and wanting them to be in one place with test coverage.## Installation
SwiftString is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:```ruby
pod "SwiftString"
```## Usage
```swift
import SwiftString
```## Methods
**between(left, right)**
```swift
"foo".between("", "") // "foo"
"foo".between("", "") // "foo"
"foo".between("", "") // nil
"Some strings } are very {weird}, dont you think?".between("{", "}") // "weird"
"".between("", "") // nil
"foo".between("", "") // nil
```**camelize()**
```swift
"os version".camelize() // "osVersion"
"HelloWorld".camelize() // "helloWorld"
"someword With Characters".camelize() // "somewordWithCharacters"
"data_rate".camelize() // "dataRate"
"background-color".camelize() // "backgroundColor"
```**capitalize()**
```swift
"hello world".capitalize() // "Hello World"
```**chompLeft(string)**
```swift
"foobar".chompLeft("foo") // "bar"
"foobar".chompLeft("bar") // "foo"
```**chompRight(string)**
```swift
"foobar".chompRight("bar") // "foo"
"foobar".chompRight("foo") // "bar"
```**collapseWhitespace()**
```swift
" String \t libraries are \n\n\t fun\n! ".collapseWhitespace() // "String libraries are fun !")
```**contains(substring)**
```swift
"foobar".contains("foo") // true
"foobar".contains("bar") // true
"foobar".contains("something") // false
```**count(string)**
```swift
"hi hi ho hey hihey".count("hi") // 3
```**decodeHTML()**
```swift
"The Weekend ‘King Of The Fall’".decodeHTML() // "The Weekend ‘King Of The Fall’"
" 4 < 5 & 3 > 2 . Price: 12 €. @ ".decodeHTML() // " 4 < 5 & 3 > 2 . Price: 12 €. @ "
"this is so "good"".decodeHTML() // "this is so \"good\""
```**endsWith(suffix)**
```swift
"hello world".endsWith("world") // true
"hello world".endsWith("foo") // false
```**ensureLeft(prefix)**
```swift
"/subdir".ensureLeft("/") // "/subdir"
"subdir".ensureLeft("/") // "/subdir"
```**ensureRight(suffix)**
```swift
"subdir/".ensureRight("/") // "subdir/"
"subdir".ensureRight("/") // "subdir/"
```**indexOf(substring)**
```swift
"hello".indexOf("hell"), // 0
"hello".indexOf("lo"), // 3
"hello".indexOf("world") // nil
```**initials()**
```swift
"First".initials(), // "F"
"First Last".initials(), // "FL"
"First Middle1 Middle2 Middle3 Last".initials() // "FMMML"
```**initialsFirstAndLast()**
```swift
"First Last".initialsFirstAndLast(), // "FL"
"First Middle1 Middle2 Middle3 Last".initialsFirstAndLast() // "FL"
```**isAlpha()**
```swift
"fdafaf3".isAlpha() // false
"afaf".isAlpha() // true
"dfdf--dfd".isAlpha() // false
```**isAlphaNumeric()**
```swift
"afaf35353afaf".isAlphaNumeric() // true
"FFFF99fff".isAlphaNumeric() // true
"99".isAlphaNumeric() // true
"afff".isAlphaNumeric() // true
"-33".isAlphaNumeric() // false
"aaff..".isAlphaNumeric() // false
```**isEmpty()**
```swift
" ".isEmpty() // true
"\t\t\t ".isEmpty() // true
"\n\n".isEmpty() // true
"helo".isEmpty() // false
```**isNumeric()**
```swift
"abc".isNumeric() // false
"123a".isNumeric() // false
"1".isNumeric() // true
"22".isNumeric() // true
"33.0".isNumeric() // true
"-63.0".isNumeric() // true
```**join(sequence)**
```swift
",".join([1,2,3]) // "1,2,3"
",".join([]) // ""
",".join(["a","b","c"]) // "a,b,c"
"! ".join(["hey","who are you?"]) // "hey! who are you?"
```**latinize()**
```swift
"šÜįéïöç".latinize() // "sUieioc"
"crème brûlée".latinize() // "creme brulee"
```**lines()**
```swift
"test".lines() // ["test"]
"test\nsentence".lines() // ["test", "sentence"]
"test \nsentence".lines() // ["test ", "sentence"]
```**pad(n, string)**
```swift
"hello".pad(2) // " hello "
"hello".pad(1, "\t") // "\thello\t"
```**padLeft(n, string)**
```swift
"hello".padLeft(10) // " hello"
"what?".padLeft(2, "!") // "!!what?"
```**padRight(n, string)**
```swift
"hello".padRight(10) // "hello "
"hello".padRight(2, "!") // "hello!!"
```**startsWith(prefix)**
```swift
"hello world".startsWith("hello") // true
"hello world".startsWith("foo") // false
```**split(separator)**
```swift
"hello world".split(" ")[0] // "hello"
"hello world".split(" ")[1] // "world"
"helloworld".split(" ")[0] // "helloworld"
```**times(n)**
```swift
"hi".times(3) // "hihihi"
" ".times(10) // " "
```**toBool()**
```swift
"asdwads".toBool() // nil
"true".toBool() // true
"false".toBool() // false
```**toFloat()**
```swift
"asdwads".toFloat() // nil
"2.00".toFloat() // 2.0
"2".toFloat() // 2.0
```**toInt()**
```swift
"asdwads".toInt() // nil
"2.00".toInt() // 2
"2".toInt() // 2
```**toDate()**
```swift
"asdwads".toDate() // nil
"2014-06-03".toDate() // NSDate
```**toDateTime()**
```swift
"asdwads".toDateTime() // nil
"2014-06-03 13:15:01".toDateTime() // NSDate
```**toDouble()**
```swift
"asdwads".toDouble() // nil
"2.00".toDouble() // 2.0
"2".toDouble() // 2.0
```**trimmedLeft()**
```swift
" How are you? ".trimmedLeft() // "How are you? "
```**trimmedRight()**
```swift
" How are you? ".trimmedRight() // " How are you?"
```**trimmed()**
```swift
" How are you? ".trimmed() // "How are you?"
```**slugify()**
```swift
"Global Thermonuclear Warfare".slugify() // "global-thermonuclear-warfare"
"Crème brûlée".slugify() // "creme-brulee"
```**stripPunctuation()**
```swift
"My, st[ring] *full* of %punct)".stripPunctuation() // "My string full of punct"
```**substring(startIndex, length)**
```swift
"hello world".substring(0, length: 1) // "h"
"hello world".substring(0, length: 11) // "hello world"
```**[subscript]**
```swift
"hello world"[0...1] // "he"
"hello world"[0..<1] // "h"
"hello world"[0] // "h"
"hello world"[0...10] // "hello world"
```## Author
Andrew Mayne, [email protected]
## License
SwiftString is available under the MIT license. See the LICENSE file for more info.