gears/string

A collection of basic string manipulation functions.

Thursday, December 1, 2016
by brad-jones
Repository
1 Watchers
4 Stars
22,389 Installations

PHP
10 Dependents
0 Suggesters
4 Forks
0 Open issues
15 Versions
19 % Grown

The README.md

Looking for maintainers, I no longer do much if any PHP dev, I have moved on, mostly work in dotnet core, node.js & golang these days. If anyone is keen to take over these projects, get in touch - brad@bjc.id.au, _(*1)

The String Gear

, _(*2)

An object oriented way to work with strings in PHP, with multibyte support baked in., _(*3)

Credit & Inspiration

The original library https://github.com/danielstjules/Stringy The voku fork https://github.com/voku/Stringy, _(*4)

This version builds on voku's work. The main aim was to make the management of the code base easier by splitting the mountain of methods that make up the Stringy class into traits., _(*5)

This does mean we have bumped the minimum PHP version to 5.4+, _(*6)

NOTE: There are also a few other changes, this is not an API compatible fork., _(*7)

How to Install

Installation via composer is easy:, _(*8)

composer require gears/string

Then import the Str class into your script:, _(*9)

use Gears\String\Str;

OO and Chaining

The library offers OO method chaining, as seen below:, _(*10)

echo Str::s('fòô     bàř')->removeWhitespace()->swapCase(); // 'FÒÔ BÀŘ'

Gears\String\Str has a __toString() method, which returns the current string when the object is used in a string context, ie: (string) Str::s('foo'), _(*11)

Implemented Interfaces

Gears\String\Str implements the IteratorAggregate interface, meaning that foreach can be used with an instance of the class:, _(*12)

``` php $str = Str::s('fòôbàř'); foreach ($str as $char) { echo $char; } // 'fòôbàř', _(*13)


It implements the `Countable` interface, enabling the use of `count()` to
retrieve the number of characters in the string:

``` php
$str = Str::s('fòô');
count($str);  // 3

Furthermore, the ArrayAccess interface has been implemented. As a result, isset() can be used to check if a character at a specific index exists. And since Gears\String\Str is immutable, any call to offsetSet or offsetUnset will throw an exception. offsetGet has been implemented, however, and accepts both positive and negative indexes. Invalid indexes result in an OutOfBoundsException., _(*14)

``` php $str = Str::s('bàř'); echo $str[2]; // 'ř' echo $str[-2]; // 'à' isset($str[-4]); // false, _(*15)

$str[3]; // OutOfBoundsException $str[2] = 'a'; // Exception ```, _(*16)

The Methods

All methods are documented with PSR-5 docblocks that provide autocomplete hints to any decent IDE such as PHP Storm or Atom with atom-autocomplete-php., _(*17)

Developed by Brad Jones - brad@bjc.id.au, _(*18)

The Versions

01/12 2016

dev-master

9999999-dev https://github.com/phpgearbox/string

A collection of basic string manipulation functions.

library string

A collection of basic string manipulation functions.

gears/string

The README.md

The String Gear

Credit & Inspiration

How to Install

OO and Chaining

Implemented Interfaces

The Methods

The Versions

dev-master

The Requires

The Development Requires

v1.1.1

The Requires

The Development Requires

v1.1.0

The Requires

The Development Requires

v1.0.0

The Requires

The Development Requires

v1.0.0-RC3

The Requires

The Development Requires

v1.0.0-RC2

The Requires

The Development Requires

v1.0.0-RC1

The Requires

The Development Requires

v0.6.0

The Requires

The Development Requires

v0.5.2

The Requires

The Development Requires

v0.5.1

The Requires

The Development Requires

v0.5.0

The Requires

The Development Requires

v0.4.0

The Requires

The Development Requires

v0.3

The Requires

v0.2

The Requires

v0.1

The Requires