bentools/violin

A multibyte string manipulation library focused on performance.

dev-master / 1.0.x-dev 2019-05-07 14:37 UTC

Requires

• php: >=7.1
• symfony/polyfill-mbstring: ~1.1

Requires (Dev)

• php-coveralls/php-coveralls: ^2.1
• phpstan/phpstan: ^0.11.5
• phpunit/phpunit: ^7.0
• squizlabs/php_codesniffer: ^3.4
• symfony/var-dumper: ^4.1

MIT

• OOP
• utf8
• utf-8
• multibyte
• string
• ascii
• strings
• manipulation
• mbstring
• str

README

Violin 🎻

Violin is a multibyte-compliant, OOP string manipulation library.

It is heavily inspired by Stringy, with a main focus on performance: when dealing with thousands of strings, it is sometimes counter-productive to rely on mb_* functions, which perform up to 4 times slower than normal str_* functions, when you manipulate ASCII strings.

Violin will detect the string's encoding, then decide wether or not to use the mbstring extension (or the Symfony polyfill if the extension is not loaded).

Installation

PHP 7.1+ is required.

composer require bentools/violin 1.0.x-dev

Tests

./vendor/bin/phpunit

Usage

use BenTools\Violin\Violin;

$str = 'fòöbàř     🤗';
print Violin::tune($str)
        ->toUpperCase()
        ->ensureLeft('Welcome ')
        ->collapseWhitespace(); // Welcome FÒÖBÀŘ 🤗

License

MIT