The Stringler
A simple class to manipulate strings in an OO way. Inspired by Spatie's String. Just built this for fun. Hope you like it.
Install
Via composer:
composer require thestringler/manipulatorUsing Laravel? Checkout The Stringler Laravel Package.
Methods
append($string)
Manipulator::make('Freak')->append(' Out!');
// Freak Out!camelToSnake
Manipulator::make('camelCase')->camelToSnake();
// camel_casecamelToClass
Manipulator::make('className')->camelToClass();
// ClassNamecapitalize
Manipulator::make('hello')->capitalize();
// HellocapitalizeEach
Manipulator::make('i like toast!')->capitalizeEach();
// I Like Toast!custom
Manipulator::make('Some String')->custom(function ($string) {
// This is just a sample, this can be achieved with existing methods,
// But you can do whatever string manipulation you want here.
return ucfirst(strtolower($string));
});
// Some stringeachCharacter($closure)
Manipulator::make('hello')->eachCharacter(function($char) {
return strtoupper($char);
});
// HELLOeachWord($closure, $preserveSpaces = false)
Manipulator::make('hello moto')->eachWord(function($word) {
return strrev($word);
});
// ollehotom
Manipulator::make('hello moto')->eachWord(function($word) {
return strrev($word);
}, true);
// olleh otomgetPossessive
Manipulator::make('Bob')->getPossessive();
// Bob's
Manipulator::make('Silas')->getPossessive();
// Silas'htmlEntities($flags = ENT_HTML5, $encoding = 'UTF-8', $doubleEncode = true)
Manipulator::make('&')->htmlEntities();
// &htmlEntitiesDecode($flags = ENT_HTML5, $encoding = 'UTF-8')
Manipulator::make('&')->htmlEntitiesDecode();
// &htmlSpecialCharacters($flags = ENT_HTML5, $encoding = 'UTF-8', $doubleEncode = true)
Manipulator::make('&<>')->htmlSpecialCharacters();
// &<>lowercaseFirst
Manipulator::make('HELLO')->lowercaseFirst();
// hELLOmake($string)
// Named constructor
Manipulator::make('string');pad($length, $string, $type = null)
Manipulator::make('Hello')->pad(2, '!!', STR_PAD_RIGHT);
// Hello!!prepend($string)
Manipulator::make('is the one.')->prepend('Neo ');
// Neo is the one.pluralize($items = null)
Manipulator::make('Potato')->pluralize();
// PotatoesYou can optionally pass an array or numeric value to pluaralize to determine if the given string should be pluaralized.
$dogs = ['Zoe', 'Spot', 'Pickles'];
Manipulator::make('Dog')->pluralize($dogs);
// Dogs
$cats = ['Whiskers'];
Manipulator::make('Cat')->pluralize($cats);
// CatnthCharacter($nth, $closure)
Manipulator::make('Wordpress')->nthCharacter(5, function($character) {
return mb_strtoupper($character);
});
// WordPressnthWord($nth, $closure, $preserveSpaces = true)
Manipulator::make('Oh hello there!')->nthWord(2, function($word) {
return mb_strtoupper($word);
});
// Oh HELLO there!remove($string, $caseSensitive = true)
Manipulator::make('Dog Gone')->remove('Gone');
// DogremoveSpecialCharacters($exceptions = [])
Manipulator::make('Hello!!')->removeSpecialCharacters();
// Hello
Manipulator::make('Hello!!')->removeSpecialCharacters(['!']);
// Hello!!repeat($multiplier = 1)
Manipulator::make('la')->repeat(3);
// lalalareplace($find, $replace = '', $caseSensitive = true)
Manipulator::make('Pickles are good.')->replace('good', 'terrible');
// Pickles are terrible.reverse
Manipulator::make('Whoa!')->reverse();
// !aohWsnakeToCamel
Manipulator::make('snake_case')->snakeToCamel();
// snakeCasesnakeToClass
Manipulator::make('class_name')->snakeToClass();
// ClassNamestripTags($allowed = '')
Manipulator::make('<i>Hello</i>')->stripTags();
// HellotoCamelCase
Manipulator::make('camel case')->toCamelCase();
// camelCasetoL33t
Manipulator::make('Hack The Planet!')->toL33t();
// (-)@{|< +/-/€ |O7@|\|€][!toLower
Manipulator::make('LOWER')->toLower();
// lowertoSlug
Manipulator::make('This is a slug!')->toSlug();
// this-is-a-slugtoSnakeCase
Manipulator::make('snake case')->toSnakeCase();
// snake_casetoString
This method just returns the string.
toUpper
Manipulator::make('upper')->toUpper();
// UPPERtrim
Manipulator::make(' trimmed ')->trim();
// trimmedtrimBeginning
Manipulator::make(' trimmed')->trimBeginning();
// trimmedtrimEnd
Manipulator::make('trimmed ')->trimEnd();
// trimmedtruncate($length = 100, $append = '...')
Manipulator::make('This is a sentence and will be truncated.')->truncate(10, '...');
// This is a ...urlDecode
Manipulator::make('hello%21')->urlDecode();
// hello!urlEncode
Manipulator::make('hello!')->urlEncode();
// hello%21Chainable
All of these methods (minus toString) can be chained.
Manipulator::make('hello')->toUpper()->reverse();
// OLLEHContribute
Contributions are very welcome!
- Follow the PSR-2 Standard
- Send a pull request.
That's pretty much it!