, (*1)
String manipulation, leveled up! -- by, Chris Kankiewicz (@phlak.dev)
, (*2)
, (*3)
Introduction
Twine is a string manipulation library with an expressive, fluent syntax., (*4)
Requirements
Install with Composer
composer require phlak/twine
Getting Started
First, import Twine:, (*5)
use PHLAK\Twine;
Then instantiate a Twine object by newing up a Twine\Str object and passing
your string as the first parameter., (*6)
$string = new Twine\Str('john pinkerton');
You may also instantiate a Twine\Str object statically via the make() method., (*7)
$string = Twine\Str::make('john pinkerton');
Or use the global str() helper method. The method takes a string as the only
parameter and returns a Twine\Str object., (*8)
$string = str('john pinkerton');
Once you have a concrete Twine\Str instance you may treat it like any other
string. This includes echoing it or using any of PHP's built-in string functions
against it., (*9)
echo $string; // Echos 'john pinkerton'
str_shuffle($string) // Returns something like 'enoipo ktnjhnr'
strlen($string); // Returns 14
The strength of Twine, however comes from its built-in methods., (*10)
$string->echo(); // Echos 'john pinkerton'
$string->shuffle(); // Returns something like 'enoipo ktnjhnr'
$string->length(); // Returns 14
// or some more interesting methods
$string->reverse(); // Returns 'notreknip nhoj'
$string->contains('pink'); // Returns true
$string->replace('pink', 'purple'); // Returns 'john purpleton'
$string->snakeCase(); // Returns 'john_pinkerton'
At this point you're ready to start using Twine by calling any of its many
built-in methods., (*11)
Available Methods
after •
append •
base64 •
base64Decode •
base64Encode •
bcrypt •
before •
camelCase •
characters •
chunk •
contains •
count •
crc32 •
crypt •
decrypt •
echo •
encoding •
encrypt •
endsWith •
equals •
explode •
first •
format •
from •
hex •
hexEncode •
hexDecode •
insensitiveMatch •
insert •
in •
isAlphabetic •
isAlphanumeric •
isEmpty •
isLowercase •
isNotEmpty •
isNumeric •
isPrintable •
isPunctuation •
isUppercase •
isWhitespace •
join •
kebabCase •
last •
length •
lowercase •
lowercaseFirst •
lowercaseWords •
match •
matchAll •
matches •
md5 •
nth •
pad •
padBoth •
padLeft •
padRight •
pascalCase •
prepend •
repeat •
replace •
reverse •
sha1 •
sha256 •
shuffle •
similarity •
snakeCase •
split •
startsWith •
strip •
studlyCase •
substring •
to •
trim •
trimLeft •
trimRight •
truncate •
uppercase •
uppercaseFirst •
uppercaseWords •
url •
words •
wrap •
wrapHard •
wrapSoft, (*12)
Method Chaining
A Twine string can be manipulated fluently by chaining methods. Here are a few
example chains:, (*13)
Perform a substring comparison:, (*14)
$string = new Twine\Str('john pinkerton');
$string->substring(5, 4)->equals('pink'); // Returns true
Encode a file in compliance with RFC 2045., (*15)
$string = new Twine\Str(file_get_contents('garbage.bin'));
$string->base64()->wrap(76, "\r\n", Twine\Config\Wrap::HARD);
Additional details available in the full documentation at https://twine.phlak.net., (*16)
MultiByte Strings
Twine aims for multibyte string compatibility by relying on PHP's
Multibyte String extension
(mbstring) to perform string operations. For this reason, the mbstring extension
is required. Multibyte strings include Unicode encodings such as UTF-8 and UCS-2., (*17)
Changelog
A list of changes can be found on the GitHub Releases page., (*18)
Troubleshooting
For general help and support join our GitHub Discussion or reach out on Bluesky., (*19)
Please report bugs to the GitHub Issue Tracker., (*20)
Copyright
This project is licensed under the MIT License., (*21)
Wallogit.com
