mirror/stringy
1
0
Fork 0
mirror of https://github.com/danielstjules/Stringy.git synced 2025-08-11 07:44:12 +02:00
Code Issues Releases Wiki Activity

Updating examples, adding tests

Browse Source
This commit is contained in:
Daniel St. Jules
2015-07-28 23:06:44 -07:00
parent cde0740118
commit 6667ca1aed
3 changed files with 75 additions and 57 deletions
Download Patch File Download Diff File Expand all files Collapse all files

62
README.md
View File

@@ -140,7 +140,7 @@ The library offers OO method chaining, as seen below:
```php
use Stringy\Stringy as S;
echo S::create('Fòô Bàř')->collapseWhitespace()->swapCase(); // 'fÒÔ bÀŘ'
echo S::create('fòô bàř')->collapseWhitespace()->swapCase(); // 'FÒÔ BÀŘ'
```
`Stringy\Stringy` has a __toString() method, which returns the current string
@@ -153,18 +153,18 @@ when the object is used in a string context, ie:
`foreach` can be used with an instance of the class:
``` php
$stringy = S::create('Fòô Bàř');
$stringy = S::create('fòôbàř');
foreach ($stringy as $char) {
echo $char;
}
// 'Fòô Bàř'
// 'fòôbàř'
```
It implements the `Countable` interface, enabling the use of `count()` to
retrieve the number of characters in the string:
``` php
$stringy = S::create('Fòô');
$stringy = S::create('fòô');
count($stringy); // 3
```
@@ -176,7 +176,7 @@ both positive and negative indexes. Invalid indexes result in an
`OutOfBoundsException`.
``` php
$stringy = S::create('Bàř');
$stringy = S::create('bàř');
echo $stringy[2]; // 'ř'
echo $stringy[-2]; // 'à'
isset($stringy[-4]); // false
@@ -196,8 +196,8 @@ you can take advantage of an even simpler API as seen below:
``` php
use function Stringy\create as s;
// Instead of: S::create('Fòô Bàř')
s('Fòô Bàř')->collapseWhitespace()->swapCase();
// Instead of: S::create('fòô bàř')
s('fòô bàř')->collapseWhitespace()->swapCase();
```
## Class methods
@@ -217,7 +217,10 @@ $stringy = S::create('fòô bàř', 'UTF-8'); // 'fòô bàř'
## Instance Methods
Stringy objects are immutable. All examples below make use of PHP 5.6
function importing, and PHP 5.4 short array syntax.
function importing, and PHP 5.4 short array syntax. They also assume the
encoding returned by mb_internal_encoding() is UTF-8. For further details,
see the documentation for the create method above, as well as the notes
on PHP 5.6 creation.
##### append(string $string)
@@ -232,7 +235,7 @@ s('fòô')->append('bàř'); // 'fòôbàř'
Returns the character at $index, with indexes starting at 0.
```php
s('fòô bàř')->at(6); // 'ř'
s('fòôbàř')->at(3); // 'b'
```
##### between(string $start, string $end [, int $offset])
@@ -290,7 +293,7 @@ default the comparison is case-sensitive, but can be made insensitive by
setting $caseSensitive to false.
```php
s('Str contains foo and bar')->containsAll(['foo', 'bar']); // true
s('foo & bar')->containsAll(['foo', 'bar']); // true
```
##### containsAny(array $needles [, boolean $caseSensitive = true ])
@@ -300,7 +303,7 @@ default the comparison is case-sensitive, but can be made insensitive by
setting $caseSensitive to false.
```php
s('Str contains foo')->containsAny(['foo', 'bar']); // true
s('str contains foo')->containsAny(['foo', 'bar']); // true
```
##### countSubstr(string $substring [, boolean $caseSensitive = true ])
@@ -320,7 +323,7 @@ inserted before uppercase characters (with the exception of the first
character of the string), and in place of spaces as well as underscores.
```php
s('TestDCase')->dasherize(); // 'test-d-case'
s('fooBar')->dasherize(); // 'foo-bar'
```
##### delimit(int $delimiter)
@@ -331,7 +334,7 @@ of the first character of the string), and in place of spaces, dashes,
and underscores. Alpha delimiters are not converted to lowercase.
```php
s('TestDCase')->delimit('>>'); // 'test>>case'
s('fooBar')->delimit('::'); // 'foo::bar'
```
##### endsWith(string $substring [, boolean $caseSensitive = true ])
@@ -341,7 +344,7 @@ default, the comparison is case-sensitive, but can be made insensitive by
setting $caseSensitive to false.
```php
s('FÒÔ bàřs')->endsWith('àřs', true); // true
s('fòôbàř')->endsWith('bàř', true); // true
```
##### ensureLeft(string $substring)
@@ -425,7 +428,7 @@ s('author_id')->humanize(); // 'Author'
Returns the index of the first occurrence of $needle in the string,
and false if not found. Accepts an optional offset from which to begin
the search.
the search. A negative index searches from the end
```php
s('string')->indexOf('ing'); // 3
@@ -435,10 +438,11 @@ s('string')->indexOf('ing'); // 3
Returns the index of the last occurrence of $needle in the string,
and false if not found. Accepts an optional offset from which to begin
the search.
the search. Offsets may be negative to count from the last character
in the string.
```php
s('string')->indexOfLast('ing'); // 10
s('foobarfoo')->indexOfLast('foo'); // 10
```
##### insert(int $index, string $substring)
@@ -446,7 +450,7 @@ s('string')->indexOfLast('ing'); // 10
Inserts $substring into the string at the $index provided.
```php
s('fòô bà')->insert('ř', 6); // 'fòô bàř'
s('fòôbř')->insert('à', 4); // 'fòôbàř'
```
##### isAlpha()
@@ -527,7 +531,7 @@ s('fòô bàř')->last(3); // 'bàř'
Returns the length of the string. An alias for PHP's mb_strlen() function.
```php
s('fòô bàř')->length(); // 7
s('fòôbàř')->length(); // 6
```
##### lines()
@@ -544,7 +548,7 @@ s("fòô\r\nbàř\n")->lines(); // ['fòô', 'bàř', '']
Returns the longest common prefix between the string and $otherStr.
```php
s('fòô bar')->longestCommonPrefix('fòr bar'); // 'fò'
s('foobar')->longestCommonPrefix('foobaz'); // 'fooba'
```
##### longestCommonSuffix(string $otherStr)
@@ -569,7 +573,7 @@ s('foo bar')->longestCommonSubstring('boo far'); // 'oo '
Converts the first character of the supplied string to lower case.
```php
s('Σ test')->lowerCaseFirst(); // 'σ test'
s('Σ foo')->lowerCaseFirst(); // 'σ foo'
```
##### pad(int $length [, string $padStr = ' ' [, string $padType = 'right' ]])
@@ -581,7 +585,7 @@ string used for padding is a space, and the default type (one of 'left',
$padType isn't one of those 3 values.
```php
s('fòô bàř')->pad( 10, '¬ø', 'left'); // '¬ø¬fòô bàř'
s('fòôbàř')->pad(9, '-/', 'left'); // '-/-fòôbàř'
```
##### padBoth(int $length [, string $padStr = ' ' ])
@@ -599,7 +603,7 @@ 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'.
```php
s('foo bar')->padLeft($length, $padStr); // ' foo bar'
s('foo bar')->padLeft(9, ' '); // ' foo bar'
```
##### padRight(int $length [, string $padStr = ' ' ])
@@ -652,7 +656,7 @@ s('fòô bàř')->removeRight(' bàř'); // 'fòô'
Returns a repeated string given a multiplier. An alias for str_repeat.
```php
s('à')->repeat(3); // 'ààà'
s('α')->repeat(3); // 'ααα'
```
##### replace(string $search, string $replacement)
@@ -711,7 +715,7 @@ By default, the comparison is case-sensitive, but can be made insensitive
by setting $caseSensitive to false.
```php
s('FÒÔ bàřs')->startsWith('fòô bàř', false); // true
s('FÒÔbàřbaz')->startsWith('fòôbàř', false); // true
```
##### slice(int $start [, int $end ])
@@ -742,7 +746,7 @@ 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.
```php
s('fòô bàř')->substr(2, 3); // 'ô b'
s('fòôbàř')->substr(2, 3); // 'ôbà'
```
##### surround(string $substring)
@@ -778,8 +782,8 @@ an array, $ignore, allowing you to list words not to be capitalized.
```php
$ignore = ['at', 'by', 'for', 'in', 'of', 'on', 'out', 'to', 'the'];
s('i like to watch DVDs at home')->titleize($ignore);
// 'I Like to Watch DVDs at Home'
s('If you optimize everything, you will always be unhappy.')->titleize($ignore);
// 'I Like to Watch television'
```
##### toAscii()
@@ -917,7 +921,7 @@ s('Upper Camel-Case')->upperCamelize(); // 'UpperCamelCase'
Converts the first character of the supplied string to upper case.
```php
s('σ test')->upperCaseFirst(); // 'Σ test'
s('σ foo')->upperCaseFirst(); // 'Σ foo'
```
## Extensions

3
src/Stringy.php
View File

@@ -504,7 +504,8 @@ class Stringy implements \Countable, \IteratorAggregate, \ArrayAccess
/**
* Returns the index of the last occurrence of $needle in the string,
* and false if not found. Accepts an optional offset from which to begin
* the search.
* the search. Offsets may be negative to count from the last character
* in the string.
*
* @param string $needle Substring to look for
* @param int $offset Offset from which to search

29
tests/StringyTest.php
View File

@@ -175,10 +175,16 @@ class StringyTestCase extends PHPUnit_Framework_TestCase
public function indexOfProvider()
{
return array(
array(2, 'This is the string', 'is'),
array(2, 'This is the string', 'is', 0, 'UTF-8'),
array(false, 'This is the string', 'not-found', 0, 'UTF-8'),
array(32, 'This is the string... and there is another thing', 'is', 10, 'UTF-8'),
array(6, 'foo & bar', 'bar'),
array(6, 'foo & bar', 'bar', 0),
array(false, 'foo & bar', 'baz'),
array(false, 'foo & bar', 'baz', 0),
array(0, 'foo & bar & foo', 'foo', 0),
array(12, 'foo & bar & foo', 'foo', 5),
array(6, 'fòô & bàř', 'bàř', 0, 'UTF-8'),
array(false, 'fòô & bàř', 'baz', 0, 'UTF-8'),
array(0, 'fòô & bàř & fòô', 'fòô', 0, 'UTF-8'),
array(12, 'fòô & bàř & fòô', 'fòô', 5, 'UTF-8'),
);
}
@@ -194,10 +200,16 @@ class StringyTestCase extends PHPUnit_Framework_TestCase
public function indexOfLastProvider()
{
return array(
array(5, 'This is the string', 'is'),
array(5, 'This is the string', 'is', 0, 'UTF-8'),
array(false, 'This is the string', 'not-found', 0, 'UTF-8'),
array(32, 'This is the string... and there is another thing', 'is', 0, 'UTF-8'),
array(6, 'foo & bar', 'bar'),
array(6, 'foo & bar', 'bar', 0),
array(false, 'foo & bar', 'baz'),
array(false, 'foo & bar', 'baz', 0),
array(12, 'foo & bar & foo', 'foo', 0),
array(0, 'foo & bar & foo', 'foo', -5),
array(6, 'fòô & bàř', 'bàř', 0, 'UTF-8'),
array(false, 'fòô & bàř', 'baz', 0, 'UTF-8'),
array(12, 'fòô & bàř & fòô', 'fòô', 0, 'UTF-8'),
array(0, 'fòô & bàř & fòô', 'fòô', -5, 'UTF-8'),
);
}
@@ -1259,6 +1271,7 @@ class StringyTestCase extends PHPUnit_Framework_TestCase
array('foo bar', 'f bar', 'oo', 1),
array('f bar', 'f bar', 'oo', 20),
array('foo bar', 'foo ba', 'r', 6),
array('fòôbàř', 'fòôbř', 'à', 4, 'UTF-8'),
array('fòô bàř', 'òô bàř', 'f', 0, 'UTF-8'),
array('fòô bàř', 'f bàř', 'òô', 1, 'UTF-8'),
array('fòô bàř', 'fòô bà', 'ř', 6, 'UTF-8')