wuzzitor/string-util

Provides a consistent, self-explaining layer to accomplish common string operations.

1.0.0 2015-07-19 23:21 UTC

Requires

• php: >=5.3.0

Requires (Dev)

• phpunit/phpunit: ~4.0
• satooshi/php-coveralls: ~0.6

MIT

• Matthias Molitor

README

Overview

This library provides a consistent, self-explaining layer to accomplish string related tasks.

Speaking method names make string operations more readable and reveal the intention clearly. Please compare the following, common snippets regarding readability:

// Native:
if (strpos($log, 'failure') !== false) {
    // [...]
}

// With StringUtil:
if (StringUtil::contains($log, 'failure')) {
    // [...]
}

In contrast to the built-in PHP string functions, the library provides methods with consistent signatures, which always expect the subject string as first parameter.

Known Restrictions

This library is meant for common, light-weight string operations. It is currently not designed for heavy, complex string tasks such as transparent charset handling.

Installation

Add the following to your composer.json (see getcomposer.org):

"require" :  {
    // ...
    "wuzzitor/string-util": "~1.0"
}

Concept

The library provides a single class (Wuzzitor\StringUtil), whose static methods are the entry points for all string operations.

All methods are stateless to ensure full testability and to avoid code that is hard to debug.

Usage

Example:

use Wuzzitor\StringUtil;

$filename = 'example.php';
$withoutExtension = StringUtil::removeSuffix($filename, '.php);
// $withoutExtension == 'example'

The following signatures show all available operations:

• StringUtil::startsWith(string $subject, string $prefix) : boolean
• StringUtil::endsWith(string $subject, string $suffix) : boolean
• StringUtil::contains(string $subject, string $needle) : boolean
• StringUtil::containsAny(string $subject, string[] $needles) : boolean
• StringUtil::containsAll(string $subject, string[] $needles) : boolean
• StringUtil::removePrefix(string $subject, string $prefix) : string
• StringUtil::removeSuffix(string $subject, string $suffix) : string
• StringUtil::replace(string $subject, string $search, string $replace) : string
• StringUtil::replace(string $subject, array<string, string> $searchReplaceMapping) : string

License

Code released under the MIT license.