mirror of
https://github.com/danielstjules/Stringy.git
synced 2025-09-02 01:22:37 +02:00
Compare commits
27 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
df24ab62d2 | ||
|
|
f9c2e0ae36 | ||
|
|
0c0b352009 | ||
|
|
f0a5c0ec80 | ||
|
|
8ef4bddd15 | ||
|
|
d9cee68330 | ||
|
2838f3412a | ||
|
|
50f0cb6356 | ||
|
|
d6dabeee67 | ||
|
44f492c025 | ||
|
|
2288363663 | ||
|
|
f22117862b | ||
|
|
eb13cc35d6 | ||
|
|
9b6bddcb20 | ||
|
|
67f16c9423 | ||
|
|
3708b6ba90 | ||
|
|
5c50a58bb8 | ||
|
|
8b59cd2233 | ||
|
|
63d81901ad | ||
|
|
a2624d4969 | ||
|
|
72102ae911 | ||
|
|
bf2a302aa1 | ||
|
5303203a72 | ||
|
|
e01ba7f848 | ||
|
|
f9f3b7f2f2 | ||
|
|
75b0cd2e0d | ||
|
|
b0976c72b7 |
@@ -10,10 +10,6 @@ sudo: false
|
||||
matrix:
|
||||
fast_finish: true
|
||||
include:
|
||||
- php: 5.3
|
||||
env: polyfill='true'
|
||||
- php: 5.3
|
||||
env: polyfill='false'
|
||||
- php: 5.4
|
||||
env: polyfill='true'
|
||||
- php: 5.4
|
||||
@@ -30,6 +26,10 @@ matrix:
|
||||
env: polyfill='true'
|
||||
- php: 7.0
|
||||
env: polyfill='false'
|
||||
- php: 7.1
|
||||
env: polyfill='true'
|
||||
- php: 7.1
|
||||
env: polyfill='false'
|
||||
|
||||
install: travis_retry composer install --no-interaction --prefer-source
|
||||
|
||||
|
||||
17
CHANGELOG.md
17
CHANGELOG.md
@@ -1,3 +1,20 @@
|
||||
### 3.1.0 (2017-06-11)
|
||||
* Add $language support to slugify
|
||||
* Add bg specific transliteration
|
||||
* ЬЪ/ьъ handling is now language-specific
|
||||
|
||||
### 3.0.1 (2017-04-12)
|
||||
* Don't replace @ in toAscii
|
||||
* Use normal replacement for @ in slugify, e.g. user@home => user-home
|
||||
|
||||
### 3.0.0 (2017-03-08)
|
||||
|
||||
* Breaking change: added $language parameter to toAscii, before
|
||||
$removeUnsupported
|
||||
* Breaking change: dropped PHP 5.3 support
|
||||
* Breaking change: any StaticStringy methods that previously returned instances
|
||||
of Stringy now return strings
|
||||
|
||||
### 2.4.0 (2017-03-02)
|
||||
|
||||
* Add startsWithAny
|
||||
|
||||
228
README.md
228
README.md
@@ -1,13 +1,16 @@
|
||||
|
||||
|
||||
A PHP string manipulation library with multibyte support. Compatible with PHP
|
||||
5.3+, PHP 7, and HHVM. Refer to the [1.x branch](https://github.com/danielstjules/Stringy/tree/1.x)
|
||||
for older documentation.
|
||||
5.4+, PHP 7+, and HHVM.
|
||||
|
||||
``` php
|
||||
s('string')->toTitleCase()->ensureRight('y') == 'Stringy'
|
||||
```
|
||||
|
||||
Refer to the [1.x branch](https://github.com/danielstjules/Stringy/tree/1.x) or
|
||||
[2.x branch](https://github.com/danielstjules/Stringy/tree/2.x) for older
|
||||
documentation.
|
||||
|
||||
[](https://travis-ci.org/danielstjules/Stringy)
|
||||
[](https://packagist.org/packages/danielstjules/stringy)
|
||||
[](https://packagist.org/packages/danielstjules/stringy)
|
||||
@@ -23,126 +26,127 @@ s('string')->toTitleCase()->ensureRight('y') == 'Stringy'
|
||||
* [Instance methods](#instance-methods)
|
||||
<table>
|
||||
<tr>
|
||||
<td>[append](#appendstring-string)</td>
|
||||
<td>[at](#atint-index)</td>
|
||||
<td>[between](#betweenstring-start-string-end--int-offset)</td>
|
||||
<td>[camelize](#camelize)</td>
|
||||
<td><a href="#appendstring-string">append</a></td>
|
||||
<td><a href="#atint-index">at</a></td>
|
||||
<td><a href="#betweenstring-start-string-end--int-offset">between</a></td>
|
||||
<td><a href="#camelize">camelize</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[chars](#chars)</td>
|
||||
<td>[collapseWhitespace](#collapsewhitespace)</td>
|
||||
<td>[contains](#containsstring-needle--boolean-casesensitive--true-)</td>
|
||||
<td>[containsAll](#containsallarray-needles--boolean-casesensitive--true-)</td>
|
||||
<td><a href="#chars">chars</a></td>
|
||||
<td><a href="#collapsewhitespace">collapseWhitespace</a></td>
|
||||
<td><a href="#containsstring-needle--boolean-casesensitive--true-">contains</a></td>
|
||||
<td><a href="#containsallarray-needles--boolean-casesensitive--true-">containsAll</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[containsAny](#containsanyarray-needles--boolean-casesensitive--true-)</td>
|
||||
<td>[countSubstr](#countsubstrstring-substring--boolean-casesensitive--true-)</td>
|
||||
<td>[dasherize](#dasherize)</td>
|
||||
<td>[delimit](#delimitint-delimiter)</td>
|
||||
<td><a href="#containsanyarray-needles--boolean-casesensitive--true-">containsAny</a></td>
|
||||
<td><a href="#countsubstrstring-substring--boolean-casesensitive--true-">countSubstr</a></td>
|
||||
<td><a href="#dasherize">dasherize</a></td>
|
||||
<td><a href="#delimitint-delimiter">delimit</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[endsWith](#endswithstring-substring--boolean-casesensitive--true-)</td>
|
||||
<td>[endsWithAny](#endsWithAnystring-substrings--boolean-casesensitive--true-)</td>
|
||||
<td>[ensureLeft](#ensureleftstring-substring)</td>
|
||||
<td>[ensureRight](#ensurerightstring-substring)</td>
|
||||
<td><a href="#endswithstring-substring--boolean-casesensitive--true-">endsWith</a></td>
|
||||
<td><a href="#endswithanystring-substrings--boolean-casesensitive--true-">endsWithAny</a></td>
|
||||
<td><a href="#ensureleftstring-substring">ensureLeft</a></td>
|
||||
<td><a href="#ensurerightstring-substring">ensureRight</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[first](#firstint-n)</td>
|
||||
<td>[getEncoding](#getencoding)</td>
|
||||
<td>[hasLowerCase](#haslowercase)</td>
|
||||
<td>[hasUpperCase](#hasuppercase)</td>
|
||||
<td><a href="#firstint-n">first</a></td>
|
||||
<td><a href="#getencoding">getEncoding</a></td>
|
||||
<td><a href="#haslowercase">hasLowerCase</a></td>
|
||||
<td><a href="#hasuppercase">hasUpperCase</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[htmlDecode](#htmldecode)</td>
|
||||
<td>[htmlEncode](#htmlencode)</td>
|
||||
<td>[humanize](#humanize)</td>
|
||||
<td>[indexOf](#indexofstring-needle--offset--0-)</td>
|
||||
<td><a href="#htmldecode">htmlDecode</a></td>
|
||||
<td><a href="#htmlencode">htmlEncode</a></td>
|
||||
<td><a href="#humanize">humanize</a></td>
|
||||
<td><a href="#indexofstring-needle--offset--0-">indexOf</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[indexOfLast](#indexoflaststring-needle--offset--0-)</td>
|
||||
<td>[insert](#insertint-index-string-substring)</td>
|
||||
<td>[isAlpha](#isalpha)</td>
|
||||
<td>[isAlphanumeric](#isalphanumeric)</td>
|
||||
<td><a href="#indexoflaststring-needle--offset--0-">indexOfLast</a></td>
|
||||
<td><a href="#insertint-index-string-substring">insert</a></td>
|
||||
<td><a href="#isalpha">isAlpha</a></td>
|
||||
<td><a href="#isalphanumeric">isAlphanumeric</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[isBase64](#isbase64)</td>
|
||||
<td>[isBlank](#isblank)</td>
|
||||
<td>[isHexadecimal](#ishexadecimal)</td>
|
||||
<td>[isJson](#isjson)</td>
|
||||
<td><a href="#isbase64">isBase64</a></td>
|
||||
<td><a href="#isblank">isBlank</a></td>
|
||||
<td><a href="#ishexadecimal">isHexadecimal</a></td>
|
||||
<td><a href="#isjson">isJson</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[isLowerCase](#islowercase)</td>
|
||||
<td>[isSerialized](#isserialized)</td>
|
||||
<td>[isUpperCase](#isuppercase)</td>
|
||||
<td>[last](#last)</td>
|
||||
<td><a href="#islowercase">isLowerCase</a></td>
|
||||
<td><a href="#isserialized">isSerialized</a></td>
|
||||
<td><a href="#isuppercase">isUpperCase</a></td>
|
||||
<td><a href="#lastint-n">last</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[length](#length)</td>
|
||||
<td>[lines](#lines)</td>
|
||||
<td>[longestCommonPrefix](#longestcommonprefixstring-otherstr)</td>
|
||||
<td>[longestCommonSuffix](#longestcommonsuffixstring-otherstr)</td>
|
||||
<td><a href="#length">length</a></td>
|
||||
<td><a href="#lines">lines</a></td>
|
||||
<td><a href="#longestcommonprefixstring-otherstr">longestCommonPrefix</a></td>
|
||||
<td><a href="#longestcommonsuffixstring-otherstr">longestCommonSuffix</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[longestCommonSubstring](#longestcommonsubstringstring-otherstr)</td>
|
||||
<td>[lowerCaseFirst](#lowercasefirst)</td>
|
||||
<td>[pad](#padint-length--string-padstr-----string-padtype--right-)</td>
|
||||
<td>[padBoth](#padbothint-length--string-padstr----)</td>
|
||||
<td><a href="#longestcommonsubstringstring-otherstr">longestCommonSubstring</a></td>
|
||||
<td><a href="#lowercasefirst">lowerCaseFirst</a></td>
|
||||
<td><a href="#padint-length--string-padstr-----string-padtype--right-">pad</a></td>
|
||||
<td><a href="#padbothint-length--string-padstr----">padBoth</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[padLeft](#padleftint-length--string-padstr----)</td>
|
||||
<td>[padRight](#padrightint-length--string-padstr----)</td>
|
||||
<td>[prepend](#prependstring-string)</td>
|
||||
<td>[regexReplace](#regexreplacestring-pattern-string-replacement--string-options--msr)</td>
|
||||
<td><a href="#padleftint-length--string-padstr----">padLeft</a></td>
|
||||
<td><a href="#padrightint-length--string-padstr----">padRight</a></td>
|
||||
<td><a href="#prependstring-string">prepend</a></td>
|
||||
<td><a href="#regexreplacestring-pattern-string-replacement--string-options--msr">regexReplace</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[removeLeft](#removeleftstring-substring)</td>
|
||||
<td>[removeRight](#removerightstring-substring)</td>
|
||||
<td>[repeat](#repeatmultiplier)</td>
|
||||
<td>[replace](#replacestring-search-string-replacement)</td>
|
||||
<td><a href="#removeleftstring-substring">removeLeft</a></td>
|
||||
<td><a href="#removerightstring-substring">removeRight</a></td>
|
||||
<td><a href="#repeatint-multiplier">repeat</a></td>
|
||||
<td><a href="#replacestring-search-string-replacement">replace</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[reverse](#reverse)</td>
|
||||
<td>[safeTruncate](#safetruncateint-length--string-substring---)</td>
|
||||
<td>[shuffle](#shuffle)</td>
|
||||
<td>[slugify](#slugify-string-replacement----)</td>
|
||||
<td><a href="#reverse">reverse</a></td>
|
||||
<td><a href="#safetruncateint-length--string-substring---">safeTruncate</a></td>
|
||||
<td><a href="#shuffle">shuffle</a></td>
|
||||
<td><a href="#slugify-string-replacement-----string-language--en">slugify</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[startsWith](#startswithstring-substring--boolean-casesensitive--true-)</td>
|
||||
<td>[startsWithAny](#startswithanystring-substrings--boolean-casesensitive--true-)</td>
|
||||
<td>[slice](#sliceint-start--int-end-)</td>
|
||||
<td>[split](#splitstring-pattern--int-limit-)</td>
|
||||
<td><a href="#sliceint-start--int-end-">slice</a></td>
|
||||
<td><a href="#splitstring-pattern--int-limit-">split</a></td>
|
||||
<td><a href="#startswithstring-substring--boolean-casesensitive--true-">startsWith</a></td>
|
||||
<td><a href="#startswithanystring-substrings--boolean-casesensitive--true-">startsWithAny</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[stripWhitespace](#stripwhitespace)</td>
|
||||
<td>[substr](#substrint-start--int-length-)</td>
|
||||
<td>[surround](#surroundstring-substring)</td>
|
||||
<td>[swapCase](#swapcase)</td>
|
||||
<td><a href="#stripwhitespace">stripWhitespace</a></td>
|
||||
<td><a href="#substrint-start--int-length-">substr</a></td>
|
||||
<td><a href="#surroundstring-substring">surround</a></td>
|
||||
<td><a href="#swapcase">swapCase</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[tidy](#tidy)</td>
|
||||
<td>[titleize](#titleize-array-ignore)</td>
|
||||
<td>[toAscii](#toascii)</td>
|
||||
<td>[toBoolean](#toboolean)</td>
|
||||
<td><a href="#tidy">tidy</a></td>
|
||||
<td><a href="#titleize-array-ignore">titleize</a></td>
|
||||
<td><a href="#toascii-string-language--en--bool-removeunsupported--true-">toAscii</a></td>
|
||||
<td><a href="#toboolean">toBoolean</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[toLowerCase](#tolowercase)</td>
|
||||
<td>[toSpaces](#tospaces-tablength--4-)</td>
|
||||
<td>[toTabs](#totabs-tablength--4-)</td>
|
||||
<td>[toTitleCase](#totitlecase)</td>
|
||||
<td><a href="#tolowercase">toLowerCase</a></td>
|
||||
<td><a href="#tospaces-tablength--4-">toSpaces</a></td>
|
||||
<td><a href="#totabs-tablength--4-">toTabs</a></td>
|
||||
<td><a href="#totitlecase">toTitleCase</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[toUpperCase](#touppercase)</td>
|
||||
<td>[trim](#trim-string-chars)</td>
|
||||
<td>[trimLeft](#trimleft-string-chars)</td>
|
||||
<td>[trimRight](#trimright-string-chars)</td>
|
||||
<td><a href="#touppercase">toUpperCase</a></td>
|
||||
<td><a href="#trim-string-chars">trim</a></td>
|
||||
<td><a href="#trimleft-string-chars">trimLeft</a></td>
|
||||
<td><a href="#trimright-string-chars">trimRight</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>[truncate](#truncateint-length--string-substring---)</td>
|
||||
<td>[underscored](#underscored)</td>
|
||||
<td>[upperCamelize](#uppercamelize)</td>
|
||||
<td>[upperCaseFirst](#uppercasefirst)</td>
|
||||
<td><a href="#truncateint-length--string-substring---">truncate</a></td>
|
||||
<td><a href="#underscored">underscored</a></td>
|
||||
<td><a href="#uppercamelize">upperCamelize</a></td>
|
||||
<td><a href="#uppercasefirst">upperCaseFirst</a></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
* [Extensions](#extensions)
|
||||
* [Tests](#tests)
|
||||
* [License](#license)
|
||||
@@ -176,7 +180,7 @@ in your composer.json file:
|
||||
|
||||
```json
|
||||
"require": {
|
||||
"danielstjules/stringy": "~2.4"
|
||||
"danielstjules/stringy": "~3.1.0"
|
||||
}
|
||||
```
|
||||
|
||||
@@ -433,7 +437,7 @@ default, the comparison is case-sensitive, but can be made insensitive by
|
||||
setting $caseSensitive to false.
|
||||
|
||||
```php
|
||||
s('fòôbàř')->endsWith('bàř', true); // true
|
||||
s('fòôbàř')->endsWith('bàř'); // true
|
||||
```
|
||||
|
||||
##### endsWithAny(string[] $substrings [, boolean $caseSensitive = true ])
|
||||
@@ -443,7 +447,7 @@ By default, the comparison is case-sensitive, but can be made insensitive
|
||||
by setting $caseSensitive to false.
|
||||
|
||||
```php
|
||||
s('fòôbàř')->endsWith(['bàř', 'baz'], true); // true
|
||||
s('fòôbàř')->endsWithAny(['bàř', 'baz']); // true
|
||||
```
|
||||
|
||||
##### ensureLeft(string $substring)
|
||||
@@ -806,38 +810,19 @@ random order.
|
||||
s('fòôbàř')->shuffle(); // 'àôřbòf'
|
||||
```
|
||||
|
||||
##### slugify([, string $replacement = '-' ])
|
||||
##### slugify([, string $replacement = '-' [, string $language = 'en']])
|
||||
|
||||
Converts the string into an URL slug. This includes replacing non-ASCII
|
||||
characters with their closest ASCII equivalents, removing remaining
|
||||
non-ASCII and non-alphanumeric characters, and replacing whitespace with
|
||||
$replacement. The replacement defaults to a single dash, and the string
|
||||
is also converted to lowercase.
|
||||
is also converted to lowercase. The language of the source string can
|
||||
also be supplied for language-specific transliteration.
|
||||
|
||||
```php
|
||||
s('Using strings like fòô bàř')->slugify(); // 'using-strings-like-foo-bar'
|
||||
```
|
||||
|
||||
##### startsWith(string $substring [, boolean $caseSensitive = true ])
|
||||
|
||||
Returns true if the string begins with $substring, false otherwise.
|
||||
By default, the comparison is case-sensitive, but can be made insensitive
|
||||
by setting $caseSensitive to false.
|
||||
|
||||
```php
|
||||
s('FÒÔbàřbaz')->startsWith('fòôbàř', false); // true
|
||||
```
|
||||
|
||||
##### startsWithAny(string[] $substrings [, boolean $caseSensitive = true ])
|
||||
|
||||
Returns true if the string begins with any of $substrings, false
|
||||
otherwise. By default the comparison is case-sensitive, but can be made
|
||||
insensitive by setting $caseSensitive to false.
|
||||
|
||||
```php
|
||||
s('FÒÔbàřbaz')->startsWith(['fòô', 'bàř'], false); // true
|
||||
```
|
||||
|
||||
##### slice(int $start [, int $end ])
|
||||
|
||||
Returns the substring beginning at $start, and up to, but not including
|
||||
@@ -859,6 +844,26 @@ results.
|
||||
s('foo,bar,baz')->split(',', 2); // ['foo', 'bar']
|
||||
```
|
||||
|
||||
##### startsWith(string $substring [, boolean $caseSensitive = true ])
|
||||
|
||||
Returns true if the string begins with $substring, false otherwise.
|
||||
By default, the comparison is case-sensitive, but can be made insensitive
|
||||
by setting $caseSensitive to false.
|
||||
|
||||
```php
|
||||
s('FÒÔbàřbaz')->startsWith('fòôbàř', false); // true
|
||||
```
|
||||
|
||||
##### startsWithAny(string[] $substrings [, boolean $caseSensitive = true ])
|
||||
|
||||
Returns true if the string begins with any of $substrings, false
|
||||
otherwise. By default the comparison is case-sensitive, but can be made
|
||||
insensitive by setting $caseSensitive to false.
|
||||
|
||||
```php
|
||||
s('FÒÔbàřbaz')->startsWithAny(['fòô', 'bàř'], false); // true
|
||||
```
|
||||
|
||||
##### stripWhitespace()
|
||||
|
||||
Strip all whitespace characters. This includes tabs and newline
|
||||
@@ -916,14 +921,19 @@ s('i like to watch television')->titleize($ignore);
|
||||
// 'I Like to Watch Television'
|
||||
```
|
||||
|
||||
##### toAscii()
|
||||
##### toAscii([, string $language = 'en' [, bool $removeUnsupported = true ]])
|
||||
|
||||
Returns an ASCII version of the string. A set of non-ASCII characters are
|
||||
replaced with their closest ASCII counterparts, and the rest are removed
|
||||
unless instructed otherwise.
|
||||
by default. The language or locale of the source string can be supplied
|
||||
for language-specific transliteration in any of the following formats:
|
||||
en, en_GB, or en-GB. For example, passing "de" results in "äöü" mapping
|
||||
to "aeoeue" rather than "aou" as in other languages.
|
||||
|
||||
```php
|
||||
s('fòôbàř')->toAscii(); // 'foobar'
|
||||
s('äöü')->toAscii(); // 'aou'
|
||||
s('äöü')->toAscii('de'); // 'aeoeue'
|
||||
```
|
||||
|
||||
##### toBoolean()
|
||||
|
||||
@@ -15,7 +15,7 @@
|
||||
}
|
||||
],
|
||||
"require": {
|
||||
"php": ">=5.3.0",
|
||||
"php": ">=5.4.0",
|
||||
"symfony/polyfill-mbstring": "~1.1"
|
||||
},
|
||||
"require-dev": {
|
||||
|
||||
@@ -16,13 +16,14 @@ use ReflectionMethod;
|
||||
* @method static string chars(string $str, string $encoding = null)
|
||||
* @method static string collapseWhitespace(string $str, string $encoding = null)
|
||||
* @method static bool contains(string $str, string $needle, bool $caseSensitive = true, string $encoding = null)
|
||||
* @method static bool containsAll(string $str, string $needle, bool $caseSensitive = true, string $encoding = null)
|
||||
* @method static bool containsAny(string $str, string $needle, bool $caseSensitive = true, string $encoding = null)
|
||||
* @method static bool containsAll(string $str, string[] $needle, bool $caseSensitive = true, string $encoding = null)
|
||||
* @method static bool containsAny(string $str, string[] $needle, bool $caseSensitive = true, string $encoding = null)
|
||||
* @method static int count(string $str, string $encoding = null)
|
||||
* @method static int countSubstr(string $str, string $substring, bool $caseSensitive = true, string $encoding = null)
|
||||
* @method static string dasherize(string $str, string $encoding = null)
|
||||
* @method static string delimit(string $str, string $delimiter, string $encoding = null)
|
||||
* @method static bool endsWith(string $str, string $substring, bool $caseSensitive = true, string $encoding = null)
|
||||
* @method static bool endsWithAny(string $str, string[] $substrings, bool $caseSensitive = true, string $encoding = null)
|
||||
* @method static string ensureLeft(string $str, string $substring, string $encoding = null)
|
||||
* @method static string ensureRight(string $str, string $substring, string $encoding = null)
|
||||
* @method static string first(string $str, int $n, string $encoding = null)
|
||||
@@ -45,7 +46,7 @@ use ReflectionMethod;
|
||||
* @method static bool isUpperCase(string $str, string $encoding = null)
|
||||
* @method static string last(string $str, string $encoding = null)
|
||||
* @method static int length(string $str, string $encoding = null)
|
||||
* @method static Stringy[] lines(string $str, string $encoding = null)
|
||||
* @method static string[] lines(string $str, string $encoding = null)
|
||||
* @method static string longestCommonPrefix(string $str, string $otherStr, string $encoding = null)
|
||||
* @method static string longestCommonSuffix(string $str, string $otherStr, string $encoding = null)
|
||||
* @method static string longestCommonSubstring(string $str, string $otherStr, string $encoding = null)
|
||||
@@ -64,15 +65,17 @@ use ReflectionMethod;
|
||||
* @method static string safeTruncate(string $str, int $length, string $substring = '', string $encoding = null)
|
||||
* @method static string shuffle(string $str, string $encoding = null)
|
||||
* @method static string slugify(string $str, string $replacement = '-', string $encoding = null)
|
||||
* @method static bool startsWith(string $str, string $substring, bool $caseSensitive = true, string $encoding = null)
|
||||
* @method static string slice(string $str, int $start, int $end = null, string $encoding = null)
|
||||
* @method static string split(string $str, string $pattern, int $limit = null, string $encoding = null)
|
||||
* @method static bool startsWith(string $str, string $substring, bool $caseSensitive = true, string $encoding = null)
|
||||
* @method static bool startsWithAny(string $str, string[] $substrings, bool $caseSensitive = true, string $encoding = null)
|
||||
* @method static string stripWhitespace(string $str, string $encoding = null)
|
||||
* @method static string substr(string $str, int $start, int $length = null, string $encoding = null)
|
||||
* @method static string surround(string $str, string $substring, string $encoding = null)
|
||||
* @method static string swapCase(string $str, string $encoding = null)
|
||||
* @method static string tidy(string $str, string $encoding = null)
|
||||
* @method static string titleize(string $str, string $encoding = null)
|
||||
* @method static string toAscii(string $str, bool $removeUnsupported = true, string $encoding = null)
|
||||
* @method static string toAscii(string $str, string $language = 'en', bool $removeUnsupported = true, string $encoding = null)
|
||||
* @method static bool toBoolean(string $str, string $encoding = null)
|
||||
* @method static string toLowerCase(string $str, string $encoding = null)
|
||||
* @method static string toSpaces(string $str, int $tabLength = 4, string $encoding = null)
|
||||
@@ -143,6 +146,16 @@ class StaticStringy
|
||||
|
||||
$stringy = Stringy::create($str, $encoding);
|
||||
|
||||
return call_user_func_array(array($stringy, $name), $args);
|
||||
$result = call_user_func_array([$stringy, $name], $args);
|
||||
|
||||
$cast = function($val) {
|
||||
if (is_object($val) && $val instanceof Stringy) {
|
||||
return (string) $val;
|
||||
} else {
|
||||
return $val;
|
||||
}
|
||||
};
|
||||
|
||||
return is_array($result) ? array_map($cast, $result) : $cast($result);
|
||||
}
|
||||
}
|
||||
|
||||
539
src/Stringy.php
539
src/Stringy.php
@@ -62,8 +62,8 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* then returns the initialized object. Throws an InvalidArgumentException
|
||||
* if the first argument is an array or object without a __toString method.
|
||||
*
|
||||
* @param mixed $str Value to modify, after being cast to string
|
||||
* @param string $encoding The character encoding
|
||||
* @param mixed $str Value to modify, after being cast to string
|
||||
* @param string $encoding The character encoding
|
||||
* @return static A Stringy object
|
||||
* @throws \InvalidArgumentException if an array or object without a
|
||||
* __toString method is passed as the first argument
|
||||
@@ -86,7 +86,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
/**
|
||||
* Returns a new string with $string appended.
|
||||
*
|
||||
* @param string $string The string to append
|
||||
* @param string $string The string to append
|
||||
* @return static Object with appended $string
|
||||
*/
|
||||
public function append($string)
|
||||
@@ -97,7 +97,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
/**
|
||||
* Returns the character at $index, with indexes starting at 0.
|
||||
*
|
||||
* @param int $index Position of the character
|
||||
* @param int $index Position of the character
|
||||
* @return static The character at $index
|
||||
*/
|
||||
public function at($index)
|
||||
@@ -174,7 +174,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
*/
|
||||
public function chars()
|
||||
{
|
||||
$chars = array();
|
||||
$chars = [];
|
||||
for ($i = 0, $l = $this->length(); $i < $l; $i++) {
|
||||
$chars[] = $this->at($i)->str;
|
||||
}
|
||||
@@ -219,9 +219,9 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* default the comparison is case-sensitive, but can be made insensitive by
|
||||
* setting $caseSensitive to false.
|
||||
*
|
||||
* @param array $needles Substrings to look for
|
||||
* @param bool $caseSensitive Whether or not to enforce case-sensitivity
|
||||
* @return bool Whether or not $str contains $needle
|
||||
* @param string[] $needles Substrings to look for
|
||||
* @param bool $caseSensitive Whether or not to enforce case-sensitivity
|
||||
* @return bool Whether or not $str contains $needle
|
||||
*/
|
||||
public function containsAll($needles, $caseSensitive = true)
|
||||
{
|
||||
@@ -243,9 +243,9 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* default the comparison is case-sensitive, but can be made insensitive by
|
||||
* setting $caseSensitive to false.
|
||||
*
|
||||
* @param array $needles Substrings to look for
|
||||
* @param bool $caseSensitive Whether or not to enforce case-sensitivity
|
||||
* @return bool Whether or not $str contains $needle
|
||||
* @param string[] $needles Substrings to look for
|
||||
* @param bool $caseSensitive Whether or not to enforce case-sensitivity
|
||||
* @return bool Whether or not $str contains $needle
|
||||
*/
|
||||
public function containsAny($needles, $caseSensitive = true)
|
||||
{
|
||||
@@ -311,7 +311,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* of the first character of the string), and in place of spaces, dashes,
|
||||
* and underscores. Alpha delimiters are not converted to lowercase.
|
||||
*
|
||||
* @param string $delimiter Sequence used to separate parts of the string
|
||||
* @param string $delimiter Sequence used to separate parts of the string
|
||||
* @return static Object with a delimited $str
|
||||
*/
|
||||
public function delimit($delimiter)
|
||||
@@ -382,7 +382,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* Ensures that the string begins with $substring. If it doesn't, it's
|
||||
* prepended.
|
||||
*
|
||||
* @param string $substring The substring to add if not present
|
||||
* @param string $substring The substring to add if not present
|
||||
* @return static Object with its $str prefixed by the $substring
|
||||
*/
|
||||
public function ensureLeft($substring)
|
||||
@@ -400,7 +400,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* Ensures that the string ends with $substring. If it doesn't, it's
|
||||
* appended.
|
||||
*
|
||||
* @param string $substring The substring to add if not present
|
||||
* @param string $substring The substring to add if not present
|
||||
* @return static Object with its $str suffixed by the $substring
|
||||
*/
|
||||
public function ensureRight($substring)
|
||||
@@ -417,7 +417,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
/**
|
||||
* Returns the first $n characters of the string.
|
||||
*
|
||||
* @param int $n Number of characters to retrieve from the start
|
||||
* @param int $n Number of characters to retrieve from the start
|
||||
* @return static Object with its $str being the first $n chars
|
||||
*/
|
||||
public function first($n)
|
||||
@@ -484,7 +484,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* http://php.net/manual/en/function.html-entity-decode.php
|
||||
*
|
||||
* @param int|null $flags Optional flags
|
||||
* @return static Object with the resulting $str after being html decoded.
|
||||
* @return static Object with the resulting $str after being html decoded.
|
||||
*/
|
||||
public function htmlDecode($flags = ENT_COMPAT)
|
||||
{
|
||||
@@ -499,7 +499,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* for a list of flags.
|
||||
*
|
||||
* @param int|null $flags Optional flags
|
||||
* @return static Object with the resulting $str after being html encoded.
|
||||
* @return static Object with the resulting $str after being html encoded.
|
||||
*/
|
||||
public function htmlEncode($flags = ENT_COMPAT)
|
||||
{
|
||||
@@ -516,7 +516,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
*/
|
||||
public function humanize()
|
||||
{
|
||||
$str = str_replace(array('_id', '_'), array('', ' '), $this->str);
|
||||
$str = str_replace(['_id', '_'], ['', ' '], $this->str);
|
||||
|
||||
return static::create($str, $this->encoding)->trim()->upperCaseFirst();
|
||||
}
|
||||
@@ -555,8 +555,8 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
/**
|
||||
* Inserts $substring into the string at the $index provided.
|
||||
*
|
||||
* @param string $substring String to be inserted
|
||||
* @param int $index The index at which to insert the substring
|
||||
* @param string $substring String to be inserted
|
||||
* @param int $index The index at which to insert the substring
|
||||
* @return static Object with the resulting $str after the insertion
|
||||
*/
|
||||
public function insert($substring, $index)
|
||||
@@ -683,7 +683,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
/**
|
||||
* Returns the last $n characters of the string.
|
||||
*
|
||||
* @param int $n Number of characters to retrieve from the end
|
||||
* @param int $n Number of characters to retrieve from the end
|
||||
* @return static Object with its $str being the last $n chars
|
||||
*/
|
||||
public function last($n)
|
||||
@@ -727,7 +727,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
/**
|
||||
* Returns the longest common prefix between the string and $otherStr.
|
||||
*
|
||||
* @param string $otherStr Second string for comparison
|
||||
* @param string $otherStr Second string for comparison
|
||||
* @return static Object with its $str being the longest common prefix
|
||||
*/
|
||||
public function longestCommonPrefix($otherStr)
|
||||
@@ -752,7 +752,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
/**
|
||||
* Returns the longest common suffix between the string and $otherStr.
|
||||
*
|
||||
* @param string $otherStr Second string for comparison
|
||||
* @param string $otherStr Second string for comparison
|
||||
* @return static Object with its $str being the longest common suffix
|
||||
*/
|
||||
public function longestCommonSuffix($otherStr)
|
||||
@@ -778,7 +778,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* Returns the longest common substring between the string and $otherStr.
|
||||
* In the case of ties, it returns that which occurs first.
|
||||
*
|
||||
* @param string $otherStr Second string for comparison
|
||||
* @param string $otherStr Second string for comparison
|
||||
* @return static Object with its $str being the longest common substring
|
||||
*/
|
||||
public function longestCommonSubstring($otherStr)
|
||||
@@ -916,16 +916,16 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* 'left', 'right', 'both') is 'right'. Throws an InvalidArgumentException
|
||||
* if $padType isn't one of those 3 values.
|
||||
*
|
||||
* @param int $length Desired string length after padding
|
||||
* @param string $padStr String used to pad, defaults to space
|
||||
* @param string $padType One of 'left', 'right', 'both'
|
||||
* @param int $length Desired string length after padding
|
||||
* @param string $padStr String used to pad, defaults to space
|
||||
* @param string $padType One of 'left', 'right', 'both'
|
||||
* @return static Object with a padded $str
|
||||
* @throws /InvalidArgumentException If $padType isn't one of 'right',
|
||||
* 'left' or 'both'
|
||||
*/
|
||||
public function pad($length, $padStr = ' ', $padType = 'right')
|
||||
{
|
||||
if (!in_array($padType, array('left', 'right', 'both'))) {
|
||||
if (!in_array($padType, ['left', 'right', 'both'])) {
|
||||
throw new InvalidArgumentException('Pad expects $padType ' .
|
||||
"to be one of 'left', 'right' or 'both'");
|
||||
}
|
||||
@@ -944,8 +944,8 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* Returns a new string of a given length such that both sides of the
|
||||
* string are padded. Alias for pad() with a $padType of 'both'.
|
||||
*
|
||||
* @param int $length Desired string length after padding
|
||||
* @param string $padStr String used to pad, defaults to space
|
||||
* @param int $length Desired string length after padding
|
||||
* @param string $padStr String used to pad, defaults to space
|
||||
* @return static String with padding applied
|
||||
*/
|
||||
public function padBoth($length, $padStr = ' ')
|
||||
@@ -960,8 +960,8 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* Returns a new string of a given length such that the beginning of the
|
||||
* string is padded. Alias for pad() with a $padType of 'left'.
|
||||
*
|
||||
* @param int $length Desired string length after padding
|
||||
* @param string $padStr String used to pad, defaults to space
|
||||
* @param int $length Desired string length after padding
|
||||
* @param string $padStr String used to pad, defaults to space
|
||||
* @return static String with left padding
|
||||
*/
|
||||
public function padLeft($length, $padStr = ' ')
|
||||
@@ -973,8 +973,8 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* Returns a new string of a given length such that the end of the string
|
||||
* is padded. Alias for pad() with a $padType of 'right'.
|
||||
*
|
||||
* @param int $length Desired string length after padding
|
||||
* @param string $padStr String used to pad, defaults to space
|
||||
* @param int $length Desired string length after padding
|
||||
* @param string $padStr String used to pad, defaults to space
|
||||
* @return static String with right padding
|
||||
*/
|
||||
public function padRight($length, $padStr = ' ')
|
||||
@@ -985,7 +985,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
/**
|
||||
* Returns a new string starting with $string.
|
||||
*
|
||||
* @param string $string The string to append
|
||||
* @param string $string The string to append
|
||||
* @return static Object with appended $string
|
||||
*/
|
||||
public function prepend($string)
|
||||
@@ -1000,9 +1000,9 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* to a lack of support in the bundled version of Oniguruma in PHP < 5.6,
|
||||
* and current versions of HHVM (3.8 and below).
|
||||
*
|
||||
* @param string $pattern The regular expression pattern
|
||||
* @param string $replacement The string to replace with
|
||||
* @param string $options Matching conditions to be used
|
||||
* @param string $pattern The regular expression pattern
|
||||
* @param string $replacement The string to replace with
|
||||
* @param string $options Matching conditions to be used
|
||||
* @return static Object with the resulting $str after the replacements
|
||||
*/
|
||||
public function regexReplace($pattern, $replacement, $options = 'msr')
|
||||
@@ -1019,7 +1019,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
/**
|
||||
* Returns a new string with the prefix $substring removed, if present.
|
||||
*
|
||||
* @param string $substring The prefix to remove
|
||||
* @param string $substring The prefix to remove
|
||||
* @return static Object having a $str without the prefix $substring
|
||||
*/
|
||||
public function removeLeft($substring)
|
||||
@@ -1037,7 +1037,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
/**
|
||||
* Returns a new string with the suffix $substring removed, if present.
|
||||
*
|
||||
* @param string $substring The suffix to remove
|
||||
* @param string $substring The suffix to remove
|
||||
* @return static Object having a $str without the suffix $substring
|
||||
*/
|
||||
public function removeRight($substring)
|
||||
@@ -1055,7 +1055,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
/**
|
||||
* Returns a repeated string given a multiplier. An alias for str_repeat.
|
||||
*
|
||||
* @param int $multiplier The number of times to repeat the string
|
||||
* @param int $multiplier The number of times to repeat the string
|
||||
* @return static Object with a repeated str
|
||||
*/
|
||||
public function repeat($multiplier)
|
||||
@@ -1068,8 +1068,8 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
/**
|
||||
* Replaces all occurrences of $search in $str by $replacement.
|
||||
*
|
||||
* @param string $search The needle to search for
|
||||
* @param string $replacement The string to replace with
|
||||
* @param string $search The needle to search for
|
||||
* @param string $replacement The string to replace with
|
||||
* @return static Object with the resulting $str after the replacements
|
||||
*/
|
||||
public function replace($search, $replacement)
|
||||
@@ -1101,8 +1101,8 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* string is further truncated so that the substring may be appended without
|
||||
* exceeding the desired length.
|
||||
*
|
||||
* @param int $length Desired length of the truncated string
|
||||
* @param string $substring The substring to append if it can fit
|
||||
* @param int $length Desired length of the truncated string
|
||||
* @param string $substring The substring to append if it can fit
|
||||
* @return static Object with the resulting $str after truncating
|
||||
*/
|
||||
public function safeTruncate($length, $substring = '')
|
||||
@@ -1157,15 +1157,18 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* characters with their closest ASCII equivalents, removing remaining
|
||||
* non-ASCII and non-alphanumeric characters, and replacing whitespace with
|
||||
* $replacement. The replacement defaults to a single dash, and the string
|
||||
* is also converted to lowercase.
|
||||
* is also converted to lowercase. The language of the source string can
|
||||
* also be supplied for language-specific transliteration.
|
||||
*
|
||||
* @param string $replacement The string used to replace whitespace
|
||||
* @param string $replacement The string used to replace whitespace
|
||||
* @param string $language Language of the source string
|
||||
* @return static Object whose $str has been converted to an URL slug
|
||||
*/
|
||||
public function slugify($replacement = '-')
|
||||
public function slugify($replacement = '-', $language = 'en')
|
||||
{
|
||||
$stringy = $this->toAscii();
|
||||
$stringy = $this->toAscii($language);
|
||||
|
||||
$stringy->str = str_replace('@', $replacement, $stringy);
|
||||
$quotedReplacement = preg_quote($replacement);
|
||||
$pattern = "/[^a-zA-Z\d\s-_$quotedReplacement]/u";
|
||||
$stringy->str = preg_replace($pattern, '', $stringy);
|
||||
@@ -1180,7 +1183,8 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* by setting $caseSensitive to false.
|
||||
*
|
||||
* @param string $substring The substring to look for
|
||||
* @param bool $caseSensitive Whether or not to enforce case-sensitivity
|
||||
* @param bool $caseSensitive Whether or not to enforce
|
||||
* case-sensitivity
|
||||
* @return bool Whether or not $str starts with $substring
|
||||
*/
|
||||
public function startsWith($substring, $caseSensitive = true)
|
||||
@@ -1228,8 +1232,8 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* the remaining string. If $end is negative, it is computed from the end
|
||||
* of the string.
|
||||
*
|
||||
* @param int $start Initial index from which to begin extraction
|
||||
* @param int $end Optional index at which to end extraction
|
||||
* @param int $start Initial index from which to begin extraction
|
||||
* @param int $end Optional index at which to end extraction
|
||||
* @return static Object with its $str being the extracted substring
|
||||
*/
|
||||
public function slice($start, $end = null)
|
||||
@@ -1252,20 +1256,20 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* array of Stringy objects. An optional integer $limit will truncate the
|
||||
* results.
|
||||
*
|
||||
* @param string $pattern The regex with which to split the string
|
||||
* @param int $limit Optional maximum number of results to return
|
||||
* @param string $pattern The regex with which to split the string
|
||||
* @param int $limit Optional maximum number of results to return
|
||||
* @return static[] An array of Stringy objects
|
||||
*/
|
||||
public function split($pattern, $limit = null)
|
||||
{
|
||||
if ($limit === 0) {
|
||||
return array();
|
||||
return [];
|
||||
}
|
||||
|
||||
// mb_split errors when supplied an empty pattern in < PHP 5.4.13
|
||||
// and HHVM < 3.8
|
||||
if ($pattern === '') {
|
||||
return array(static::create($this->str, $this->encoding));
|
||||
return [static::create($this->str, $this->encoding)];
|
||||
}
|
||||
|
||||
$regexEncoding = $this->regexEncoding();
|
||||
@@ -1316,8 +1320,8 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* It differs from the mb_substr() function in that providing a $length of
|
||||
* null will return the rest of the string, rather than an empty string.
|
||||
*
|
||||
* @param int $start Position of the first character to use
|
||||
* @param int $length Maximum number of characters used
|
||||
* @param int $start Position of the first character to use
|
||||
* @param int $length Maximum number of characters used
|
||||
* @return static Object with its $str being the substring
|
||||
*/
|
||||
public function substr($start, $length = null)
|
||||
@@ -1331,13 +1335,13 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
/**
|
||||
* Surrounds $str with the given substring.
|
||||
*
|
||||
* @param string $substring The substring to add to both sides
|
||||
* @param string $substring The substring to add to both sides
|
||||
* @return static Object whose $str had the substring both prepended and
|
||||
* appended
|
||||
*/
|
||||
public function surround($substring)
|
||||
{
|
||||
$str = implode('', array($substring, $this->str, $substring));
|
||||
$str = implode('', [$substring, $this->str, $substring]);
|
||||
|
||||
return static::create($str, $this->encoding);
|
||||
}
|
||||
@@ -1376,17 +1380,17 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
*/
|
||||
public function tidy()
|
||||
{
|
||||
$str = preg_replace(array(
|
||||
$str = preg_replace([
|
||||
'/\x{2026}/u',
|
||||
'/[\x{201C}\x{201D}]/u',
|
||||
'/[\x{2018}\x{2019}]/u',
|
||||
'/[\x{2013}\x{2014}]/u',
|
||||
), array(
|
||||
], [
|
||||
'...',
|
||||
'"',
|
||||
"'",
|
||||
'-',
|
||||
), $this->str);
|
||||
], $this->str);
|
||||
|
||||
return static::create($str, $this->encoding);
|
||||
}
|
||||
@@ -1396,7 +1400,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* Also accepts an array, $ignore, allowing you to list words not to be
|
||||
* capitalized.
|
||||
*
|
||||
* @param array $ignore An array of words not to capitalize
|
||||
* @param array $ignore An array of words not to capitalize
|
||||
* @return static Object with a titleized $str
|
||||
*/
|
||||
public function titleize($ignore = null)
|
||||
@@ -1424,16 +1428,25 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
/**
|
||||
* Returns an ASCII version of the string. A set of non-ASCII characters are
|
||||
* replaced with their closest ASCII counterparts, and the rest are removed
|
||||
* unless instructed otherwise.
|
||||
* by default. The language or locale of the source string can be supplied
|
||||
* for language-specific transliteration in any of the following formats:
|
||||
* en, en_GB, or en-GB. For example, passing "de" results in "äöü" mapping
|
||||
* to "aeoeue" rather than "aou" as in other languages.
|
||||
*
|
||||
* @param bool $removeUnsupported Whether or not to remove the
|
||||
* @param string $language Language of the source string
|
||||
* @param bool $removeUnsupported Whether or not to remove the
|
||||
* unsupported characters
|
||||
* @return static Object whose $str contains only ASCII characters
|
||||
*/
|
||||
public function toAscii($removeUnsupported = true)
|
||||
public function toAscii($language = 'en', $removeUnsupported = true)
|
||||
{
|
||||
$str = $this->str;
|
||||
|
||||
$langSpecific = $this->langSpecificCharsArray($language);
|
||||
if (!empty($langSpecific)) {
|
||||
$str = str_replace($langSpecific[0], $langSpecific[1], $str);
|
||||
}
|
||||
|
||||
foreach ($this->charsArray() as $key => $value) {
|
||||
$str = str_replace($value, $key, $str);
|
||||
}
|
||||
@@ -1459,7 +1472,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
public function toBoolean()
|
||||
{
|
||||
$key = $this->toLowerCase()->str;
|
||||
$map = array(
|
||||
$map = [
|
||||
'true' => true,
|
||||
'1' => true,
|
||||
'on' => true,
|
||||
@@ -1468,7 +1481,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
'0' => false,
|
||||
'off' => false,
|
||||
'no' => false
|
||||
);
|
||||
];
|
||||
|
||||
if (array_key_exists($key, $map)) {
|
||||
return $map[$key];
|
||||
@@ -1496,7 +1509,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* Converts each tab in the string to some number of spaces, as defined by
|
||||
* $tabLength. By default, each tab is converted to 4 consecutive spaces.
|
||||
*
|
||||
* @param int $tabLength Number of spaces to replace each tab with
|
||||
* @param int $tabLength Number of spaces to replace each tab with
|
||||
* @return static Object whose $str has had tabs switched to spaces
|
||||
*/
|
||||
public function toSpaces($tabLength = 4)
|
||||
@@ -1512,7 +1525,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* defined by $tabLength, to a tab. By default, each 4 consecutive spaces
|
||||
* are converted to a tab.
|
||||
*
|
||||
* @param int $tabLength Number of spaces to replace with a tab
|
||||
* @param int $tabLength Number of spaces to replace with a tab
|
||||
* @return static Object whose $str has had spaces switched to tabs
|
||||
*/
|
||||
public function toTabs($tabLength = 4)
|
||||
@@ -1553,7 +1566,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* string. Supports the removal of unicode whitespace. Accepts an optional
|
||||
* string of characters to strip instead of the defaults.
|
||||
*
|
||||
* @param string $chars Optional string of characters to strip
|
||||
* @param string $chars Optional string of characters to strip
|
||||
* @return static Object with a trimmed $str
|
||||
*/
|
||||
public function trim($chars = null)
|
||||
@@ -1568,7 +1581,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* Supports the removal of unicode whitespace. Accepts an optional
|
||||
* string of characters to strip instead of the defaults.
|
||||
*
|
||||
* @param string $chars Optional string of characters to strip
|
||||
* @param string $chars Optional string of characters to strip
|
||||
* @return static Object with a trimmed $str
|
||||
*/
|
||||
public function trimLeft($chars = null)
|
||||
@@ -1583,7 +1596,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* Supports the removal of unicode whitespace. Accepts an optional
|
||||
* string of characters to strip instead of the defaults.
|
||||
*
|
||||
* @param string $chars Optional string of characters to strip
|
||||
* @param string $chars Optional string of characters to strip
|
||||
* @return static Object with a trimmed $str
|
||||
*/
|
||||
public function trimRight($chars = null)
|
||||
@@ -1598,8 +1611,8 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
* truncating occurs, the string is further truncated so that the substring
|
||||
* may be appended without exceeding the desired length.
|
||||
*
|
||||
* @param int $length Desired length of the truncated string
|
||||
* @param string $substring The substring to append if it can fit
|
||||
* @param int $length Desired length of the truncated string
|
||||
* @param string $substring The substring to append if it can fit
|
||||
* @return static Object with the resulting $str after truncating
|
||||
*/
|
||||
public function truncate($length, $substring = '')
|
||||
@@ -1670,180 +1683,216 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
static $charsArray;
|
||||
if (isset($charsArray)) return $charsArray;
|
||||
|
||||
return $charsArray = array(
|
||||
'0' => array('°', '₀', '۰', '０'),
|
||||
'1' => array('¹', '₁', '۱', '１'),
|
||||
'2' => array('²', '₂', '۲', '２'),
|
||||
'3' => array('³', '₃', '۳', '３'),
|
||||
'4' => array('⁴', '₄', '۴', '٤', '４'),
|
||||
'5' => array('⁵', '₅', '۵', '٥', '５'),
|
||||
'6' => array('⁶', '₆', '۶', '٦', '６'),
|
||||
'7' => array('⁷', '₇', '۷', '７'),
|
||||
'8' => array('⁸', '₈', '۸', '８'),
|
||||
'9' => array('⁹', '₉', '۹', '９'),
|
||||
'a' => array('à', 'á', 'ả', 'ã', 'ạ', 'ă', 'ắ', 'ằ', 'ẳ', 'ẵ',
|
||||
'ặ', 'â', 'ấ', 'ầ', 'ẩ', 'ẫ', 'ậ', 'ā', 'ą', 'å',
|
||||
'α', 'ά', 'ἀ', 'ἁ', 'ἂ', 'ἃ', 'ἄ', 'ἅ', 'ἆ', 'ἇ',
|
||||
'ᾀ', 'ᾁ', 'ᾂ', 'ᾃ', 'ᾄ', 'ᾅ', 'ᾆ', 'ᾇ', 'ὰ', 'ά',
|
||||
'ᾰ', 'ᾱ', 'ᾲ', 'ᾳ', 'ᾴ', 'ᾶ', 'ᾷ', 'а', 'أ', 'အ',
|
||||
'ာ', 'ါ', 'ǻ', 'ǎ', 'ª', 'ა', 'अ', 'ا', 'ａ'),
|
||||
'b' => array('б', 'β', 'Ъ', 'Ь', 'ب', 'ဗ', 'ბ', 'ｂ'),
|
||||
'c' => array('ç', 'ć', 'č', 'ĉ', 'ċ', 'ｃ'),
|
||||
'd' => array('ď', 'ð', 'đ', 'ƌ', 'ȡ', 'ɖ', 'ɗ', 'ᵭ', 'ᶁ', 'ᶑ',
|
||||
'д', 'δ', 'د', 'ض', 'ဍ', 'ဒ', 'დ', 'ｄ'),
|
||||
'e' => array('é', 'è', 'ẻ', 'ẽ', 'ẹ', 'ê', 'ế', 'ề', 'ể', 'ễ',
|
||||
'ệ', 'ë', 'ē', 'ę', 'ě', 'ĕ', 'ė', 'ε', 'έ', 'ἐ',
|
||||
'ἑ', 'ἒ', 'ἓ', 'ἔ', 'ἕ', 'ὲ', 'έ', 'е', 'ё', 'э',
|
||||
'є', 'ə', 'ဧ', 'ေ', 'ဲ', 'ე', 'ए', 'إ', 'ئ', 'ｅ'),
|
||||
'f' => array('ф', 'φ', 'ف', 'ƒ', 'ფ', 'ｆ'),
|
||||
'g' => array('ĝ', 'ğ', 'ġ', 'ģ', 'г', 'ґ', 'γ', 'ဂ', 'გ', 'گ',
|
||||
'ｇ'),
|
||||
'h' => array('ĥ', 'ħ', 'η', 'ή', 'ح', 'ه', 'ဟ', 'ှ', 'ჰ', 'ｈ'),
|
||||
'i' => array('í', 'ì', 'ỉ', 'ĩ', 'ị', 'î', 'ï', 'ī', 'ĭ', 'į',
|
||||
'ı', 'ι', 'ί', 'ϊ', 'ΐ', 'ἰ', 'ἱ', 'ἲ', 'ἳ', 'ἴ',
|
||||
'ἵ', 'ἶ', 'ἷ', 'ὶ', 'ί', 'ῐ', 'ῑ', 'ῒ', 'ΐ', 'ῖ',
|
||||
'ῗ', 'і', 'ї', 'и', 'ဣ', 'ိ', 'ီ', 'ည်', 'ǐ', 'ი',
|
||||
'इ', 'ی', 'ｉ'),
|
||||
'j' => array('ĵ', 'ј', 'Ј', 'ჯ', 'ج', 'ｊ'),
|
||||
'k' => array('ķ', 'ĸ', 'к', 'κ', 'Ķ', 'ق', 'ك', 'က', 'კ', 'ქ',
|
||||
'ک', 'ｋ'),
|
||||
'l' => array('ł', 'ľ', 'ĺ', 'ļ', 'ŀ', 'л', 'λ', 'ل', 'လ', 'ლ',
|
||||
'ｌ'),
|
||||
'm' => array('м', 'μ', 'م', 'မ', 'მ', 'ｍ'),
|
||||
'n' => array('ñ', 'ń', 'ň', 'ņ', 'ʼn', 'ŋ', 'ν', 'н', 'ن', 'န',
|
||||
'ნ', 'ｎ'),
|
||||
'o' => array('ó', 'ò', 'ỏ', 'õ', 'ọ', 'ô', 'ố', 'ồ', 'ổ', 'ỗ',
|
||||
'ộ', 'ơ', 'ớ', 'ờ', 'ở', 'ỡ', 'ợ', 'ø', 'ō', 'ő',
|
||||
'ŏ', 'ο', 'ὀ', 'ὁ', 'ὂ', 'ὃ', 'ὄ', 'ὅ', 'ὸ', 'ό',
|
||||
'о', 'و', 'θ', 'ို', 'ǒ', 'ǿ', 'º', 'ო', 'ओ', 'ｏ'),
|
||||
'p' => array('п', 'π', 'ပ', 'პ', 'پ', 'ｐ'),
|
||||
'q' => array('ყ', 'ｑ'),
|
||||
'r' => array('ŕ', 'ř', 'ŗ', 'р', 'ρ', 'ر', 'რ', 'ｒ'),
|
||||
's' => array('ś', 'š', 'ş', 'с', 'σ', 'ș', 'ς', 'س', 'ص', 'စ',
|
||||
'ſ', 'ს', 'ｓ'),
|
||||
't' => array('ť', 'ţ', 'т', 'τ', 'ț', 'ت', 'ط', 'ဋ', 'တ', 'ŧ',
|
||||
'თ', 'ტ', 'ｔ'),
|
||||
'u' => array('ú', 'ù', 'ủ', 'ũ', 'ụ', 'ư', 'ứ', 'ừ', 'ử', 'ữ',
|
||||
'ự', 'û', 'ū', 'ů', 'ű', 'ŭ', 'ų', 'µ', 'у', 'ဉ',
|
||||
'ု', 'ူ', 'ǔ', 'ǖ', 'ǘ', 'ǚ', 'ǜ', 'უ', 'उ', 'ｕ',
|
||||
'ў'),
|
||||
'v' => array('в', 'ვ', 'ϐ', 'ｖ'),
|
||||
'w' => array('ŵ', 'ω', 'ώ', 'ဝ', 'ွ', 'ｗ'),
|
||||
'x' => array('χ', 'ξ', 'ｘ'),
|
||||
'y' => array('ý', 'ỳ', 'ỷ', 'ỹ', 'ỵ', 'ÿ', 'ŷ', 'й', 'ы', 'υ',
|
||||
'ϋ', 'ύ', 'ΰ', 'ي', 'ယ', 'ｙ'),
|
||||
'z' => array('ź', 'ž', 'ż', 'з', 'ζ', 'ز', 'ဇ', 'ზ', 'ｚ'),
|
||||
'aa' => array('ع', 'आ', 'آ'),
|
||||
'ae' => array('ä', 'æ', 'ǽ'),
|
||||
'ai' => array('ऐ'),
|
||||
'at' => array('@'),
|
||||
'ch' => array('ч', 'ჩ', 'ჭ', 'چ'),
|
||||
'dj' => array('ђ', 'đ'),
|
||||
'dz' => array('џ', 'ძ'),
|
||||
'ei' => array('ऍ'),
|
||||
'gh' => array('غ', 'ღ'),
|
||||
'ii' => array('ई'),
|
||||
'ij' => array('ij'),
|
||||
'kh' => array('х', 'خ', 'ხ'),
|
||||
'lj' => array('љ'),
|
||||
'nj' => array('њ'),
|
||||
'oe' => array('ö', 'œ', 'ؤ'),
|
||||
'oi' => array('ऑ'),
|
||||
'oii' => array('ऒ'),
|
||||
'ps' => array('ψ'),
|
||||
'sh' => array('ш', 'შ', 'ش'),
|
||||
'shch' => array('щ'),
|
||||
'ss' => array('ß'),
|
||||
'sx' => array('ŝ'),
|
||||
'th' => array('þ', 'ϑ', 'ث', 'ذ', 'ظ'),
|
||||
'ts' => array('ц', 'ც', 'წ'),
|
||||
'ue' => array('ü'),
|
||||
'uu' => array('ऊ'),
|
||||
'ya' => array('я'),
|
||||
'yu' => array('ю'),
|
||||
'zh' => array('ж', 'ჟ', 'ژ'),
|
||||
'(c)' => array('©'),
|
||||
'A' => array('Á', 'À', 'Ả', 'Ã', 'Ạ', 'Ă', 'Ắ', 'Ằ', 'Ẳ', 'Ẵ',
|
||||
'Ặ', 'Â', 'Ấ', 'Ầ', 'Ẩ', 'Ẫ', 'Ậ', 'Å', 'Ā', 'Ą',
|
||||
'Α', 'Ά', 'Ἀ', 'Ἁ', 'Ἂ', 'Ἃ', 'Ἄ', 'Ἅ', 'Ἆ', 'Ἇ',
|
||||
'ᾈ', 'ᾉ', 'ᾊ', 'ᾋ', 'ᾌ', 'ᾍ', 'ᾎ', 'ᾏ', 'Ᾰ', 'Ᾱ',
|
||||
'Ὰ', 'Ά', 'ᾼ', 'А', 'Ǻ', 'Ǎ', 'Ａ'),
|
||||
'B' => array('Б', 'Β', 'ब', 'Ｂ'),
|
||||
'C' => array('Ç','Ć', 'Č', 'Ĉ', 'Ċ', 'Ｃ'),
|
||||
'D' => array('Ď', 'Ð', 'Đ', 'Ɖ', 'Ɗ', 'Ƌ', 'ᴅ', 'ᴆ', 'Д', 'Δ',
|
||||
'Ｄ'),
|
||||
'E' => array('É', 'È', 'Ẻ', 'Ẽ', 'Ẹ', 'Ê', 'Ế', 'Ề', 'Ể', 'Ễ',
|
||||
'Ệ', 'Ë', 'Ē', 'Ę', 'Ě', 'Ĕ', 'Ė', 'Ε', 'Έ', 'Ἐ',
|
||||
'Ἑ', 'Ἒ', 'Ἓ', 'Ἔ', 'Ἕ', 'Έ', 'Ὲ', 'Е', 'Ё', 'Э',
|
||||
'Є', 'Ə', 'Ｅ'),
|
||||
'F' => array('Ф', 'Φ', 'Ｆ'),
|
||||
'G' => array('Ğ', 'Ġ', 'Ģ', 'Г', 'Ґ', 'Γ', 'Ｇ'),
|
||||
'H' => array('Η', 'Ή', 'Ħ', 'Ｈ'),
|
||||
'I' => array('Í', 'Ì', 'Ỉ', 'Ĩ', 'Ị', 'Î', 'Ï', 'Ī', 'Ĭ', 'Į',
|
||||
'İ', 'Ι', 'Ί', 'Ϊ', 'Ἰ', 'Ἱ', 'Ἳ', 'Ἴ', 'Ἵ', 'Ἶ',
|
||||
'Ἷ', 'Ῐ', 'Ῑ', 'Ὶ', 'Ί', 'И', 'І', 'Ї', 'Ǐ', 'ϒ',
|
||||
'Ｉ'),
|
||||
'J' => array('Ｊ'),
|
||||
'K' => array('К', 'Κ', 'Ｋ'),
|
||||
'L' => array('Ĺ', 'Ł', 'Л', 'Λ', 'Ļ', 'Ľ', 'Ŀ', 'ल', 'Ｌ'),
|
||||
'M' => array('М', 'Μ', 'Ｍ'),
|
||||
'N' => array('Ń', 'Ñ', 'Ň', 'Ņ', 'Ŋ', 'Н', 'Ν', 'Ｎ'),
|
||||
'O' => array('Ó', 'Ò', 'Ỏ', 'Õ', 'Ọ', 'Ô', 'Ố', 'Ồ', 'Ổ', 'Ỗ',
|
||||
'Ộ', 'Ơ', 'Ớ', 'Ờ', 'Ở', 'Ỡ', 'Ợ', 'Ø', 'Ō', 'Ő',
|
||||
'Ŏ', 'Ο', 'Ό', 'Ὀ', 'Ὁ', 'Ὂ', 'Ὃ', 'Ὄ', 'Ὅ', 'Ὸ',
|
||||
'Ό', 'О', 'Θ', 'Ө', 'Ǒ', 'Ǿ', 'Ｏ'),
|
||||
'P' => array('П', 'Π', 'Ｐ'),
|
||||
'Q' => array('Ｑ'),
|
||||
'R' => array('Ř', 'Ŕ', 'Р', 'Ρ', 'Ŗ', 'Ｒ'),
|
||||
'S' => array('Ş', 'Ŝ', 'Ș', 'Š', 'Ś', 'С', 'Σ', 'Ｓ'),
|
||||
'T' => array('Ť', 'Ţ', 'Ŧ', 'Ț', 'Т', 'Τ', 'Ｔ'),
|
||||
'U' => array('Ú', 'Ù', 'Ủ', 'Ũ', 'Ụ', 'Ư', 'Ứ', 'Ừ', 'Ử', 'Ữ',
|
||||
'Ự', 'Û', 'Ū', 'Ů', 'Ű', 'Ŭ', 'Ų', 'У', 'Ǔ', 'Ǖ',
|
||||
'Ǘ', 'Ǚ', 'Ǜ', 'Ｕ', 'Ў'),
|
||||
'V' => array('В', 'Ｖ'),
|
||||
'W' => array('Ω', 'Ώ', 'Ŵ', 'Ｗ'),
|
||||
'X' => array('Χ', 'Ξ', 'Ｘ'),
|
||||
'Y' => array('Ý', 'Ỳ', 'Ỷ', 'Ỹ', 'Ỵ', 'Ÿ', 'Ῠ', 'Ῡ', 'Ὺ', 'Ύ',
|
||||
'Ы', 'Й', 'Υ', 'Ϋ', 'Ŷ', 'Ｙ'),
|
||||
'Z' => array('Ź', 'Ž', 'Ż', 'З', 'Ζ', 'Ｚ'),
|
||||
'AE' => array('Ä', 'Æ', 'Ǽ'),
|
||||
'CH' => array('Ч'),
|
||||
'DJ' => array('Ђ'),
|
||||
'DZ' => array('Џ'),
|
||||
'GX' => array('Ĝ'),
|
||||
'HX' => array('Ĥ'),
|
||||
'IJ' => array('IJ'),
|
||||
'JX' => array('Ĵ'),
|
||||
'KH' => array('Х'),
|
||||
'LJ' => array('Љ'),
|
||||
'NJ' => array('Њ'),
|
||||
'OE' => array('Ö', 'Œ'),
|
||||
'PS' => array('Ψ'),
|
||||
'SH' => array('Ш'),
|
||||
'SHCH' => array('Щ'),
|
||||
'SS' => array('ẞ'),
|
||||
'TH' => array('Þ'),
|
||||
'TS' => array('Ц'),
|
||||
'UE' => array('Ü'),
|
||||
'YA' => array('Я'),
|
||||
'YU' => array('Ю'),
|
||||
'ZH' => array('Ж'),
|
||||
' ' => array("\xC2\xA0", "\xE2\x80\x80", "\xE2\x80\x81",
|
||||
"\xE2\x80\x82", "\xE2\x80\x83", "\xE2\x80\x84",
|
||||
"\xE2\x80\x85", "\xE2\x80\x86", "\xE2\x80\x87",
|
||||
"\xE2\x80\x88", "\xE2\x80\x89", "\xE2\x80\x8A",
|
||||
"\xE2\x80\xAF", "\xE2\x81\x9F", "\xE3\x80\x80",
|
||||
"\xEF\xBE\xA0"),
|
||||
);
|
||||
return $charsArray = [
|
||||
'0' => ['°', '₀', '۰', '０'],
|
||||
'1' => ['¹', '₁', '۱', '１'],
|
||||
'2' => ['²', '₂', '۲', '２'],
|
||||
'3' => ['³', '₃', '۳', '３'],
|
||||
'4' => ['⁴', '₄', '۴', '٤', '４'],
|
||||
'5' => ['⁵', '₅', '۵', '٥', '５'],
|
||||
'6' => ['⁶', '₆', '۶', '٦', '６'],
|
||||
'7' => ['⁷', '₇', '۷', '７'],
|
||||
'8' => ['⁸', '₈', '۸', '８'],
|
||||
'9' => ['⁹', '₉', '۹', '９'],
|
||||
'a' => ['à', 'á', 'ả', 'ã', 'ạ', 'ă', 'ắ', 'ằ', 'ẳ', 'ẵ',
|
||||
'ặ', 'â', 'ấ', 'ầ', 'ẩ', 'ẫ', 'ậ', 'ā', 'ą', 'å',
|
||||
'α', 'ά', 'ἀ', 'ἁ', 'ἂ', 'ἃ', 'ἄ', 'ἅ', 'ἆ', 'ἇ',
|
||||
'ᾀ', 'ᾁ', 'ᾂ', 'ᾃ', 'ᾄ', 'ᾅ', 'ᾆ', 'ᾇ', 'ὰ', 'ά',
|
||||
'ᾰ', 'ᾱ', 'ᾲ', 'ᾳ', 'ᾴ', 'ᾶ', 'ᾷ', 'а', 'أ', 'အ',
|
||||
'ာ', 'ါ', 'ǻ', 'ǎ', 'ª', 'ა', 'अ', 'ا', 'ａ', 'ä'],
|
||||
'b' => ['б', 'β', 'ب', 'ဗ', 'ბ', 'ｂ'],
|
||||
'c' => ['ç', 'ć', 'č', 'ĉ', 'ċ', 'ｃ'],
|
||||
'd' => ['ď', 'ð', 'đ', 'ƌ', 'ȡ', 'ɖ', 'ɗ', 'ᵭ', 'ᶁ', 'ᶑ',
|
||||
'д', 'δ', 'د', 'ض', 'ဍ', 'ဒ', 'დ', 'ｄ'],
|
||||
'e' => ['é', 'è', 'ẻ', 'ẽ', 'ẹ', 'ê', 'ế', 'ề', 'ể', 'ễ',
|
||||
'ệ', 'ë', 'ē', 'ę', 'ě', 'ĕ', 'ė', 'ε', 'έ', 'ἐ',
|
||||
'ἑ', 'ἒ', 'ἓ', 'ἔ', 'ἕ', 'ὲ', 'έ', 'е', 'ё', 'э',
|
||||
'є', 'ə', 'ဧ', 'ေ', 'ဲ', 'ე', 'ए', 'إ', 'ئ', 'ｅ'],
|
||||
'f' => ['ф', 'φ', 'ف', 'ƒ', 'ფ', 'ｆ'],
|
||||
'g' => ['ĝ', 'ğ', 'ġ', 'ģ', 'г', 'ґ', 'γ', 'ဂ', 'გ', 'گ',
|
||||
'ｇ'],
|
||||
'h' => ['ĥ', 'ħ', 'η', 'ή', 'ح', 'ه', 'ဟ', 'ှ', 'ჰ', 'ｈ'],
|
||||
'i' => ['í', 'ì', 'ỉ', 'ĩ', 'ị', 'î', 'ï', 'ī', 'ĭ', 'į',
|
||||
'ı', 'ι', 'ί', 'ϊ', 'ΐ', 'ἰ', 'ἱ', 'ἲ', 'ἳ', 'ἴ',
|
||||
'ἵ', 'ἶ', 'ἷ', 'ὶ', 'ί', 'ῐ', 'ῑ', 'ῒ', 'ΐ', 'ῖ',
|
||||
'ῗ', 'і', 'ї', 'и', 'ဣ', 'ိ', 'ီ', 'ည်', 'ǐ', 'ი',
|
||||
'इ', 'ی', 'ｉ'],
|
||||
'j' => ['ĵ', 'ј', 'Ј', 'ჯ', 'ج', 'ｊ'],
|
||||
'k' => ['ķ', 'ĸ', 'к', 'κ', 'Ķ', 'ق', 'ك', 'က', 'კ', 'ქ',
|
||||
'ک', 'ｋ'],
|
||||
'l' => ['ł', 'ľ', 'ĺ', 'ļ', 'ŀ', 'л', 'λ', 'ل', 'လ', 'ლ',
|
||||
'ｌ'],
|
||||
'm' => ['м', 'μ', 'م', 'မ', 'მ', 'ｍ'],
|
||||
'n' => ['ñ', 'ń', 'ň', 'ņ', 'ʼn', 'ŋ', 'ν', 'н', 'ن', 'န',
|
||||
'ნ', 'ｎ'],
|
||||
'o' => ['ó', 'ò', 'ỏ', 'õ', 'ọ', 'ô', 'ố', 'ồ', 'ổ', 'ỗ',
|
||||
'ộ', 'ơ', 'ớ', 'ờ', 'ở', 'ỡ', 'ợ', 'ø', 'ō', 'ő',
|
||||
'ŏ', 'ο', 'ὀ', 'ὁ', 'ὂ', 'ὃ', 'ὄ', 'ὅ', 'ὸ', 'ό',
|
||||
'о', 'و', 'θ', 'ို', 'ǒ', 'ǿ', 'º', 'ო', 'ओ', 'ｏ',
|
||||
'ö'],
|
||||
'p' => ['п', 'π', 'ပ', 'პ', 'پ', 'ｐ'],
|
||||
'q' => ['ყ', 'ｑ'],
|
||||
'r' => ['ŕ', 'ř', 'ŗ', 'р', 'ρ', 'ر', 'რ', 'ｒ'],
|
||||
's' => ['ś', 'š', 'ş', 'с', 'σ', 'ș', 'ς', 'س', 'ص', 'စ',
|
||||
'ſ', 'ს', 'ｓ'],
|
||||
't' => ['ť', 'ţ', 'т', 'τ', 'ț', 'ت', 'ط', 'ဋ', 'တ', 'ŧ',
|
||||
'თ', 'ტ', 'ｔ'],
|
||||
'u' => ['ú', 'ù', 'ủ', 'ũ', 'ụ', 'ư', 'ứ', 'ừ', 'ử', 'ữ',
|
||||
'ự', 'û', 'ū', 'ů', 'ű', 'ŭ', 'ų', 'µ', 'у', 'ဉ',
|
||||
'ု', 'ူ', 'ǔ', 'ǖ', 'ǘ', 'ǚ', 'ǜ', 'უ', 'उ', 'ｕ',
|
||||
'ў', 'ü'],
|
||||
'v' => ['в', 'ვ', 'ϐ', 'ｖ'],
|
||||
'w' => ['ŵ', 'ω', 'ώ', 'ဝ', 'ွ', 'ｗ'],
|
||||
'x' => ['χ', 'ξ', 'ｘ'],
|
||||
'y' => ['ý', 'ỳ', 'ỷ', 'ỹ', 'ỵ', 'ÿ', 'ŷ', 'й', 'ы', 'υ',
|
||||
'ϋ', 'ύ', 'ΰ', 'ي', 'ယ', 'ｙ'],
|
||||
'z' => ['ź', 'ž', 'ż', 'з', 'ζ', 'ز', 'ဇ', 'ზ', 'ｚ'],
|
||||
'aa' => ['ع', 'आ', 'آ'],
|
||||
'ae' => ['æ', 'ǽ'],
|
||||
'ai' => ['ऐ'],
|
||||
'ch' => ['ч', 'ჩ', 'ჭ', 'چ'],
|
||||
'dj' => ['ђ', 'đ'],
|
||||
'dz' => ['џ', 'ძ'],
|
||||
'ei' => ['ऍ'],
|
||||
'gh' => ['غ', 'ღ'],
|
||||
'ii' => ['ई'],
|
||||
'ij' => ['ij'],
|
||||
'kh' => ['х', 'خ', 'ხ'],
|
||||
'lj' => ['љ'],
|
||||
'nj' => ['њ'],
|
||||
'oe' => ['œ', 'ؤ'],
|
||||
'oi' => ['ऑ'],
|
||||
'oii' => ['ऒ'],
|
||||
'ps' => ['ψ'],
|
||||
'sh' => ['ш', 'შ', 'ش'],
|
||||
'shch' => ['щ'],
|
||||
'ss' => ['ß'],
|
||||
'sx' => ['ŝ'],
|
||||
'th' => ['þ', 'ϑ', 'ث', 'ذ', 'ظ'],
|
||||
'ts' => ['ц', 'ც', 'წ'],
|
||||
'uu' => ['ऊ'],
|
||||
'ya' => ['я'],
|
||||
'yu' => ['ю'],
|
||||
'zh' => ['ж', 'ჟ', 'ژ'],
|
||||
'(c)' => ['©'],
|
||||
'A' => ['Á', 'À', 'Ả', 'Ã', 'Ạ', 'Ă', 'Ắ', 'Ằ', 'Ẳ', 'Ẵ',
|
||||
'Ặ', 'Â', 'Ấ', 'Ầ', 'Ẩ', 'Ẫ', 'Ậ', 'Å', 'Ā', 'Ą',
|
||||
'Α', 'Ά', 'Ἀ', 'Ἁ', 'Ἂ', 'Ἃ', 'Ἄ', 'Ἅ', 'Ἆ', 'Ἇ',
|
||||
'ᾈ', 'ᾉ', 'ᾊ', 'ᾋ', 'ᾌ', 'ᾍ', 'ᾎ', 'ᾏ', 'Ᾰ', 'Ᾱ',
|
||||
'Ὰ', 'Ά', 'ᾼ', 'А', 'Ǻ', 'Ǎ', 'Ａ', 'Ä'],
|
||||
'B' => ['Б', 'Β', 'ब', 'Ｂ'],
|
||||
'C' => ['Ç','Ć', 'Č', 'Ĉ', 'Ċ', 'Ｃ'],
|
||||
'D' => ['Ď', 'Ð', 'Đ', 'Ɖ', 'Ɗ', 'Ƌ', 'ᴅ', 'ᴆ', 'Д', 'Δ',
|
||||
'Ｄ'],
|
||||
'E' => ['É', 'È', 'Ẻ', 'Ẽ', 'Ẹ', 'Ê', 'Ế', 'Ề', 'Ể', 'Ễ',
|
||||
'Ệ', 'Ë', 'Ē', 'Ę', 'Ě', 'Ĕ', 'Ė', 'Ε', 'Έ', 'Ἐ',
|
||||
'Ἑ', 'Ἒ', 'Ἓ', 'Ἔ', 'Ἕ', 'Έ', 'Ὲ', 'Е', 'Ё', 'Э',
|
||||
'Є', 'Ə', 'Ｅ'],
|
||||
'F' => ['Ф', 'Φ', 'Ｆ'],
|
||||
'G' => ['Ğ', 'Ġ', 'Ģ', 'Г', 'Ґ', 'Γ', 'Ｇ'],
|
||||
'H' => ['Η', 'Ή', 'Ħ', 'Ｈ'],
|
||||
'I' => ['Í', 'Ì', 'Ỉ', 'Ĩ', 'Ị', 'Î', 'Ï', 'Ī', 'Ĭ', 'Į',
|
||||
'İ', 'Ι', 'Ί', 'Ϊ', 'Ἰ', 'Ἱ', 'Ἳ', 'Ἴ', 'Ἵ', 'Ἶ',
|
||||
'Ἷ', 'Ῐ', 'Ῑ', 'Ὶ', 'Ί', 'И', 'І', 'Ї', 'Ǐ', 'ϒ',
|
||||
'Ｉ'],
|
||||
'J' => ['Ｊ'],
|
||||
'K' => ['К', 'Κ', 'Ｋ'],
|
||||
'L' => ['Ĺ', 'Ł', 'Л', 'Λ', 'Ļ', 'Ľ', 'Ŀ', 'ल', 'Ｌ'],
|
||||
'M' => ['М', 'Μ', 'Ｍ'],
|
||||
'N' => ['Ń', 'Ñ', 'Ň', 'Ņ', 'Ŋ', 'Н', 'Ν', 'Ｎ'],
|
||||
'O' => ['Ó', 'Ò', 'Ỏ', 'Õ', 'Ọ', 'Ô', 'Ố', 'Ồ', 'Ổ', 'Ỗ',
|
||||
'Ộ', 'Ơ', 'Ớ', 'Ờ', 'Ở', 'Ỡ', 'Ợ', 'Ø', 'Ō', 'Ő',
|
||||
'Ŏ', 'Ο', 'Ό', 'Ὀ', 'Ὁ', 'Ὂ', 'Ὃ', 'Ὄ', 'Ὅ', 'Ὸ',
|
||||
'Ό', 'О', 'Θ', 'Ө', 'Ǒ', 'Ǿ', 'Ｏ', 'Ö'],
|
||||
'P' => ['П', 'Π', 'Ｐ'],
|
||||
'Q' => ['Ｑ'],
|
||||
'R' => ['Ř', 'Ŕ', 'Р', 'Ρ', 'Ŗ', 'Ｒ'],
|
||||
'S' => ['Ş', 'Ŝ', 'Ș', 'Š', 'Ś', 'С', 'Σ', 'Ｓ'],
|
||||
'T' => ['Ť', 'Ţ', 'Ŧ', 'Ț', 'Т', 'Τ', 'Ｔ'],
|
||||
'U' => ['Ú', 'Ù', 'Ủ', 'Ũ', 'Ụ', 'Ư', 'Ứ', 'Ừ', 'Ử', 'Ữ',
|
||||
'Ự', 'Û', 'Ū', 'Ů', 'Ű', 'Ŭ', 'Ų', 'У', 'Ǔ', 'Ǖ',
|
||||
'Ǘ', 'Ǚ', 'Ǜ', 'Ｕ', 'Ў', 'Ü'],
|
||||
'V' => ['В', 'Ｖ'],
|
||||
'W' => ['Ω', 'Ώ', 'Ŵ', 'Ｗ'],
|
||||
'X' => ['Χ', 'Ξ', 'Ｘ'],
|
||||
'Y' => ['Ý', 'Ỳ', 'Ỷ', 'Ỹ', 'Ỵ', 'Ÿ', 'Ῠ', 'Ῡ', 'Ὺ', 'Ύ',
|
||||
'Ы', 'Й', 'Υ', 'Ϋ', 'Ŷ', 'Ｙ'],
|
||||
'Z' => ['Ź', 'Ž', 'Ż', 'З', 'Ζ', 'Ｚ'],
|
||||
'AE' => ['Æ', 'Ǽ'],
|
||||
'Ch' => ['Ч'],
|
||||
'Dj' => ['Ђ'],
|
||||
'Dz' => ['Џ'],
|
||||
'Gx' => ['Ĝ'],
|
||||
'Hx' => ['Ĥ'],
|
||||
'Ij' => ['IJ'],
|
||||
'Jx' => ['Ĵ'],
|
||||
'Kh' => ['Х'],
|
||||
'Lj' => ['Љ'],
|
||||
'Nj' => ['Њ'],
|
||||
'Oe' => ['Œ'],
|
||||
'Ps' => ['Ψ'],
|
||||
'Sh' => ['Ш'],
|
||||
'Shch' => ['Щ'],
|
||||
'Ss' => ['ẞ'],
|
||||
'Th' => ['Þ'],
|
||||
'Ts' => ['Ц'],
|
||||
'Ya' => ['Я'],
|
||||
'Yu' => ['Ю'],
|
||||
'Zh' => ['Ж'],
|
||||
' ' => ["\xC2\xA0", "\xE2\x80\x80", "\xE2\x80\x81",
|
||||
"\xE2\x80\x82", "\xE2\x80\x83", "\xE2\x80\x84",
|
||||
"\xE2\x80\x85", "\xE2\x80\x86", "\xE2\x80\x87",
|
||||
"\xE2\x80\x88", "\xE2\x80\x89", "\xE2\x80\x8A",
|
||||
"\xE2\x80\xAF", "\xE2\x81\x9F", "\xE3\x80\x80",
|
||||
"\xEF\xBE\xA0"],
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns language-specific replacements for the toAscii() method.
|
||||
* For example, German will map 'ä' to 'ae', while other languages
|
||||
* will simply return 'a'.
|
||||
*
|
||||
* @param string $language Language of the source string
|
||||
* @return array An array of replacements.
|
||||
*/
|
||||
protected static function langSpecificCharsArray($language = 'en')
|
||||
{
|
||||
$split = preg_split('/[-_]/', $language);
|
||||
$language = strtolower($split[0]);
|
||||
|
||||
static $charsArray = [];
|
||||
if (isset($charsArray[$language])) {
|
||||
return $charsArray[$language];
|
||||
}
|
||||
|
||||
$languageSpecific = [
|
||||
'de' => [
|
||||
['ä', 'ö', 'ü', 'Ä', 'Ö', 'Ü' ],
|
||||
['ae', 'oe', 'ue', 'AE', 'OE', 'UE'],
|
||||
],
|
||||
'bg' => [
|
||||
['х', 'Х', 'щ', 'Щ', 'ъ', 'Ъ', 'ь', 'Ь'],
|
||||
['h', 'H', 'sht', 'SHT', 'a', 'А', 'y', 'Y']
|
||||
]
|
||||
];
|
||||
|
||||
if (isset($languageSpecific[$language])) {
|
||||
$charsArray[$language] = $languageSpecific[$language];
|
||||
} else {
|
||||
$charsArray[$language] = [];
|
||||
}
|
||||
|
||||
return $charsArray[$language];
|
||||
}
|
||||
|
||||
/**
|
||||
* Adds the specified amount of left and right padding to the given string.
|
||||
* The default character used is a space.
|
||||
*
|
||||
* @param int $left Length of left padding
|
||||
* @param int $right Length of right padding
|
||||
* @param string $padStr String used to pad
|
||||
* @param int $left Length of left padding
|
||||
* @param int $right Length of right padding
|
||||
* @param string $padStr String used to pad
|
||||
* @return static String with padding applied
|
||||
*/
|
||||
protected function applyPadding($left = 0, $right = 0, $padStr = ' ')
|
||||
@@ -1924,7 +1973,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
|
||||
|
||||
protected function supportsEncoding()
|
||||
{
|
||||
$supported = array('UTF-8' => true, 'ASCII' => true);
|
||||
$supported = ['UTF-8' => true, 'ASCII' => true];
|
||||
|
||||
if (isset($supported[$this->encoding])) {
|
||||
return true;
|
||||
|
||||
@@ -15,25 +15,38 @@ class StaticStringyTestCase extends PHPUnit_Framework_TestCase
|
||||
public function testEmptyArgsInvocation()
|
||||
{
|
||||
$result = S::toLowerCase();
|
||||
$this->assertEquals('', (string) $result);
|
||||
$this->assertEquals('', $result);
|
||||
}
|
||||
|
||||
public function testInvocation()
|
||||
{
|
||||
$result = S::toLowerCase('FOOBAR');
|
||||
$this->assertEquals('foobar', (string) $result);
|
||||
$this->assertEquals('foobar', $result);
|
||||
$this->assertInternalType('string', $result);
|
||||
}
|
||||
|
||||
public function testPartialArgsInvocation()
|
||||
{
|
||||
$result = S::slice('foobar', 0, 3);
|
||||
$this->assertEquals('foo', (string) $result);
|
||||
$this->assertEquals('foo', $result);
|
||||
$this->assertInternalType('string', $result);
|
||||
}
|
||||
|
||||
public function testFullArgsInvocation()
|
||||
{
|
||||
$result = S::slice('fòôbàř', 0, 3, 'UTF-8');
|
||||
$this->assertEquals('fòô', (string) $result);
|
||||
$this->assertEquals('fòô', $result);
|
||||
$this->assertInternalType('string', $result);
|
||||
}
|
||||
|
||||
public function testArrayReturnValue()
|
||||
{
|
||||
$result = S::lines("a\nb");
|
||||
$this->assertEquals(['a', 'b'], $result);
|
||||
$this->assertInternalType('array', $result);
|
||||
foreach ($result as $val) {
|
||||
$this->assertInternalType('string', $val);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user