$str = new Str('Hello, 世界');
$str->last(2); // 世界
$str->chars(); // ['世', '界']
$str
->ensureLeft('Hello, ') // Hello, 世界
->ensureRight('!!!') // Hello, 世界!!!
->trimRight('!') // Hello, 世界
->prepend('Str say - '); // Str say - Hello, 世界
$send = function (string $s) {};
$send((string)$str); // same
$send($str->getString()); // same- strongly typed
- no exceptions thrown
- fast
- new functions
A fast string manipulation library with multi-byte support. Inspired by the "Stringy" library, with focus on speed.
Lib uses php7 features and does not throw any exceptions (because all input parameters are strongly typed). The code is completely covered by unit tests.
Requirements:
- php7.0
composer require str/strCreate a new Str object using static method for it.
- param string $str
- return Str
Example:
$str = Str::make('Acme');
echo (string)$str;
// AcmeCheck whether $prefix exists in the string, and prepend $prefix to the string if it doesn't.
- param string $prefix
- return Str
Example:
$str = new Str('Acme/');
echo (string)$str->ensureLeft('/');
// /Acme/
$str = new Str('/Acme/');
echo (string)$str->ensureLeft('/');
// /Acme/Check whether $suffix exists in the string, and append $suffix to the string if it doesn't.
- param string $suffix
- return Str
Example:
$str = new Str('/Acme');
echo (string)$str->ensureRight('/');
// /Acme/
$str = new Str('/Acme/');
echo (string)$str->ensureRight('/');
// /Acme/Check if the string contains $needle substring.
- param string $needle
- param bool $caseSensitive Defaults to true.
- return bool
Example:
$str = new Str('/Acme/');
echo $str->contains('/');
// true
$str = new Str('/Acme/');
echo $str->contains('a', false);
// trueReplaces all occurrences of $old in the string by $new.
- param string $old
- param string $new
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->replace('/', '#');
// #Acme#Make the string lowercase.
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->toLowerCase();
// /acme/Make the string uppercase.
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->toUpperCase();
// /ACME/Returns a string with whitespace removed from the start and end of the string. Supports the removal of unicode whitespace. Accepts an optional string of characters to strip instead of the defaults.
- param string $chars Optional string of characters to strip.
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->trim('/');
// AcmeReturns a string with whitespace removed from the start of the string. Supports the removal of unicode whitespace. Accepts an optional string of characters to strip instead of the defaults.
- param string $chars Optional string of characters to strip.
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->trimLeft('/');
// Acme/Returns a string with whitespace removed from the end of the string. Supports the removal of unicode whitespace. Accepts an optional string of characters to strip instead of the defaults.
- param string $chars Optional string of characters to strip.
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->trimRight('/');
// /AcmeAppend $sub to the string.
- param string $sub
- return Str
Example:
$str = new Str('/Acme');
echo (string)$str->append('/');
// /Acme/Prepend $sub to the string.
- param string $sub
- return Str
Example:
$str = new Str('Acme/');
echo (string)$str->prepend('/');
// /Acme/Returns the character at $pos, with indexes starting at 0.
- param int $pos
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->at(2);
// cReturns the substring beginning at $start with the specified $length. It differs from the mb_substr() function in that providing a $length of 0 will return the rest of the string, rather than an empty string.
- param int $start Position of the first character to use.
- param int $length Maximum number of characters used.
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->substr(1, 4);
// AcmeReturns an array consisting of the characters in the string.
- return array An array of string chars.
Example:
$str = new Str('/Acme/');
echo (string)$str->chars();
// ['/', 'A', 'c', 'm', 'e', '/']Returns the first $length characters of the string.
- param int $length Number of characters to retrieve from the start. Defaults to 1.
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->first(2);
// /AReturns the first $length characters of the string.
- param int $length Number of characters to retrieve from the start. Defaults to 1.
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->last(2);
// e/Returns the length of the string.
- return int
Example:
$str = new Str('/Acme/');
echo $str->length();
// 6Returns the index of the first occurrence of $needle in the string, and -1 if not found. Accepts an optional $offset from which to begin the search.
- param string $needle Substring to look for.
- param int $offset Offset from which to search. Defaults to 0.
- return int The occurrence's index if found, otherwise -1.
Example:
$str = new Str('/Accmme/');
echo $str->indexOf('m');
// 4Returns the index of the last occurrence of $needle in the string, and false if not found. Accepts an optional $offset from which to begin the search. Offsets may be negative to count from the last character in the string.
- param string $needle Substring to look for.
- param int $offset Offset from which to search. Defaults to 0.
- return int The occurrence's index if found, otherwise -1.
Example:
$str = new Str('/Accmme/');
echo $str->indexOfLast('m');
// 5Returns the number of occurrences of $needle in the given string. By default the comparison is case-sensitive, but can be made insensitive by setting $caseSensitive to false.
- param string $needle Substring to look for.
- param bool $caseSensitive Whether or not to enforce case-sensitivity. Defaults to true.
- return int The number of $needle occurrences.
Example:
$str = new Str('/Accmme/');
echo $str->countSubstr('m');
// 2Returns true if the string contains all $needles, false otherwise. By default the comparison is case-sensitive, but can be made insensitive by setting $caseSensitive to false.
- param array $needles Substrings to look for.
- param bool $caseSensitive Whether or not to enforce case-sensitivity. Defaults to true.
- return bool Whether or not the string contains all $needles.
Example:
$str = new Str('/Accmme/');
echo $str->containsAll(['m', 'c', '/']);
// trueReturns true if the string contains any $needles, false otherwise. By default the comparison is case-sensitive, but can be made insensitive by setting $caseSensitive to false.
- param array $needles Substrings to look for.
- param bool $caseSensitive Whether or not to enforce case-sensitivity. Defaults to true.
- return bool Whether or not the string contains any $needles.
Example:
$str = new Str('/Accmme/');
echo $str->containsAny(['foo', 'c', 'bar']);
// trueReturns true if the string begins with $substring, false otherwise. By default the comparison is case-sensitive, but can be made insensitive by setting $caseSensitive to false.
- param string $substring Substring to look for.
- param bool $caseSensitive Whether or not to enforce case-sensitivity. Defaults to true.
- return bool Whether or not the string contains any $needles.
Example:
$str = new Str('/Accmme/');
echo $str->startsWith('/A');
// trueReturns true if the string begins with any of $substrings, false otherwise. By default the comparison is case-sensitive, but can be made insensitive by setting $caseSensitive to false.
- param array $substrings Substrings to look for.
- param bool $caseSensitive Whether or not to enforce case-sensitivity. Defaults to true.
- return bool Whether or not the string contains any $needles.
Example:
$str = new Str('/Accmme/');
echo $str->startsWithAny(['foo', '/A', 'bar']);
// trueReturns true if the string ends with $substring, false otherwise. By default the comparison is case-sensitive, but can be made insensitive by setting $caseSensitive to false.
- param string $substring Substring to look for.
- param bool $caseSensitive Whether or not to enforce case-sensitivity. Defaults to true.
- return bool Whether or not the string contains any $needles.
Example:
$str = new Str('/Accmme/');
echo $str->endsWith('e/');
// trueReturns true if the string ends with any of $substrings, false otherwise. By default the comparison is case-sensitive, but can be made insensitive by setting $caseSensitive to false.
- param array $substrings Substrings to look for.
- param bool $caseSensitive Whether or not to enforce case-sensitivity. Defaults to true.
- return bool Whether or not the string contains any $needles.
Example:
$str = new Str('/Accmme/');
echo $str->endsWithAny(['foo', 'e/', 'bar']);
// trueReturns a new string of a given length such that both sides of the string are padded.
- param int $length Desired string length after padding.
- param string $padStr String used to pad, defaults to space.
- return Str
Example:
$str = new Str('Acme');
echo (string)$str->padBoth(6, '/');
// /Acme/Returns a new string of a given length such that the beginning of the string is padded.
- param int $length Desired string length after padding.
- param string $padStr String used to pad, defaults to space.
- return Str
Example:
$str = new Str('Acme/');
echo (string)$str->padLeft(6, '/');
// /Acme/Returns a new string of a given length such that the end of the string is padded.
- param int $length Desired string length after padding.
- param string $padStr String used to pad, defaults to space.
- return Str
Example:
$str = new Str('/Acme');
echo (string)$str->padRight(6, '/');
// /Acme/Inserts $substring into the string at the $index provided.
- param string $substring String to be inserted.
- param int $index The index at which to insert the substring.
- return Str
Example:
$str = new Str('/Ace/');
echo (string)$str->insert('m', 3);
// /Acme/Returns the string with the prefix $substring removed, if present.
- param string $substring The prefix to remove.
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->removeLeft('/');
// Acme/Returns the string with the suffix $substring removed, if present.
- param string $substring The suffix to remove.
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->removeRight('/');
// /AcmeReturns a repeated string given a $multiplier. An alias for str_repeat.
- param int $multiplier The number of times to repeat the string.
- return Str
Example:
$str = new Str('Acme/');
echo (string)$str->repeat(2);
// Acme/Acme/Returns a reversed string. A multi-byte version of strrev().
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->reverse();
// /emcA/A multi-byte str_shuffle() function. It returns a string with its characters in random order.
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->shuffle();
// mAe//cReturns the substring between $start and $end, if found, or an empty string. An optional $offset may be supplied from which to begin the search for the start string.
- param string $start Delimiter marking the start of the substring.
- param string $end Delimiter marking the end of the substring.
- param int $offset Index from which to begin the search. Defaults to 0.
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->between('/', '/');
// AcmeReturns a camelCase version of the string. Trims surrounding spaces, capitalizes letters following digits, spaces, dashes and underscores, and removes spaces, dashes, as well as underscores.
- return Str
Example:
$str = new Str('ac me');
echo (string)$str->camelize();
// acMeTrims the string and replaces consecutive whitespace characters with a single space. This includes tabs and newline characters, as well as multi-byte whitespace such as the thin space and ideographic space.
- return Str
Example:
$str = new Str('foo bar baz');
echo (string)$str->collapseWhitespace();
// foo bar bazReturns a lowercase and trimmed string separated by dashes. Dashes are inserted before uppercase characters (with the exception of the first character of the string), and in place of spaces as well as underscores.
- return Str
Example:
$str = new Str('Ac me');
echo (string)$str->dasherize();
// ac-meReturns a lowercase and trimmed string separated by the given $delimiter. Delimiters are inserted before uppercase characters (with the exception of the first character of the string), and in place of spaces, dashes, and underscores. Alpha delimiters are not converted to lowercase.
- param string $delimiter Sequence used to separate parts of the string.
- return Str
Example:
$str = new Str('Ac me');
echo (string)$str->delimit('#');
// ac#meConverts the first character of the string to lower case.
- return Str
Example:
$str = new Str('Acme Foo');
echo (string)$str->lowerCaseFirst();
// acme FooConverts the first character of the string to upper case.
- return Str
Example:
$str = new Str('acme foo');
echo (string)$str->upperCaseFirst();
// Acme fooReplaces all occurrences of $pattern in the string by $replacement. An alias for mb_ereg_replace(). Note that the 'i' option with multi-byte patterns in mb_ereg_replace() requires PHP 5.6+ for correct results. This is due to a lack of support in the bundled version of Oniguruma in PHP < 5.6, and current versions of HHVM (3.8 and below).
- param string $pattern The regular expression pattern.
- param string $replacement The string to replace with.
- param string $options Matching conditions to be used. Defaults to 'msr'.
- return Str
Example:
$str = new Str('Acme Foo');
echo (string)$str->regexReplace('A', 'a');
// acme FooReturns true if the string contains a lower case char, false otherwise.
- return bool
Example:
$str = new Str('Acme');
echo $str->hasLowerCase();
// trueReturns true if the string contains an upper case char, false otherwise.
- return bool
Example:
$str = new Str('Acme');
echo $str->hasUpperCase();
// trueConvert all HTML entities to their applicable characters. An alias of html_entity_decode. For a list of flags, refer to PHP documentation.
- param int $flags Optional flags. Defaults to ENT_COMPAT.
- return Str
Example:
$str = new Str('<Acme>');
echo (string)$str->htmlDecode();
// <Acme>Convert all applicable characters to HTML entities. An alias of htmlentities. Refer to PHP documentation for a list of flags.
- param int $flags Optional flags. Defaults to ENT_COMPAT.
- return Str
Example:
$str = new Str('<Acme>');
echo (string)$str->htmlEncode();
// <Acme>Capitalizes the first word of the string, replaces underscores with spaces.
- return Str
Example:
$str = new Str('foo_id');
echo (string)$str->humanize();
// FooReturns true if the string contains only alphabetic chars, false otherwise.
- return bool
Example:
$str = new Str('Acme');
echo $str->isAlpha();
// trueReturns true if the string contains only alphabetic and numeric chars, false otherwise.
- return bool
Example:
$str = new Str('Acme1');
echo $str->isAlphanumeric();
// trueReturns true if the string is base64 encoded, false otherwise.
- return bool
Example:
$str = new Str('Acme');
echo $str->isBase64();
// falseReturns true if the string contains only whitespace chars, false otherwise.
- return bool
Example:
$str = new Str('Acme');
echo $str->isBlank();
// falseReturns true if the string contains only hexadecimal chars, false otherwise.
- return bool
Example:
$str = new Str('Acme');
echo $str->isHexadecimal();
// falseReturns true if the string is JSON, false otherwise. Unlike json_decode in PHP 5.x, this method is consistent with PHP 7 and other JSON parsers, in that an empty string is not considered valid JSON.
- return bool
Example:
$str = new Str('Acme');
echo $str->isJson();
// falseReturns true if the string contains only lower case chars, false otherwise.
- return bool
Example:
$str = new Str('Acme');
echo $str->isLowerCase();
// falseReturns true if the string contains only upper case chars, false otherwise.
- return bool
Example:
$str = new Str('Acme');
echo $str->isUpperCase();
// falseReturns true if the string is serialized, false otherwise.
- return bool
Example:
$str = new Str('Acme');
echo $str->isSerialized();
// falseSplits on newlines and carriage returns, returning an array of strings corresponding to the lines in the string.
- return array
Example:
$str = new Str("Acme\r\nAcme");
echo $str->lines();
// ['Acme', 'Acme']Splits the string with the provided $pattern, returning an array of strings. An optional integer $limit will truncate the results.
- param string $pattern The pattern with which to split the string.
- param int $limit Optional maximum number of results to return.
- return array
Example:
$str = new Str('Acme#Acme');
echo $str->split('#', 1);
// ['Acme']Returns the longest common prefix between the string and $otherStr.
- param string $otherStr Second string for comparison.
- return Str
Example:
$str = new Str('Acme');
echo (string)$str->longestCommonPrefix('Accurate');
// AcReturns the longest common suffix between the string and $otherStr.
- param string $otherStr Second string for comparison.
- return Str
Example:
$str = new Str('Acme');
echo (string)$str->longestCommonSuffix('Do believe me');
// meReturns the longest common substring between the string and $otherStr. In the case of ties, it returns that which occurs first.
- param string $otherStr Second string for comparison.
- return Str
Example:
$str = new Str('Acme');
echo (string)$str->longestCommonSubstring('meh');
// meTruncates the string to a given $length, while ensuring that it does not split words. If $substring is provided, and truncating occurs, the string is further truncated so that the $substring may be appended without exceeding the desired length.
- param int $length Desired length of the truncated string.
- param string $substring The substring to append if it can fit.
- return Str
Example:
$str = new Str('What are your plans today?');
echo (string)$str->safeTruncate(22, '...');
// What are your plans...Converts the string into an URL slug. This includes replacing non-ASCII characters with their closest ASCII equivalents, removing remaining non-ASCII and non-alphanumeric characters, and replacing whitespace with $replacement. The $replacement defaults to a single dash, and the string is also converted to lowercase. The $language of the source string can also be supplied for language-specific transliteration.
- param string $replacement The string used to replace whitespace. Defaults to '-'.
- param string $language Language of the source string. Defaults to 'en'.
- return Str
Example:
$str = new Str('Acme foo bar!');
echo (string)$str->slugify();
// acme-foo-barReturns an ASCII version of the string. A set of non-ASCII characters are replaced with their closest ASCII counterparts, and the rest are removed by default. The $language or locale of the source string can be supplied for language-specific transliteration in any of the following formats: en, en_GB, or en-GB. For example, passing "de" results in "äöü" mapping to "aeoeue" rather than "aou" as in other languages.
- param string $language Language of the source string. Defaults to 'en'.
- param bool $removeUnsupported Whether or not to remove the unsupported characters. Defaults to true.
- return Str
Example:
$str = new Str('Äcmế');
echo (string)$str->toAscii();
// AcmeReturns the substring beginning at $start, and up to, but not including the index specified by $end. If $end is omitted, the function extracts the remaining string. If $end is negative, it is computed from the end of the string.
- param int $start Initial index from which to begin extraction.
- param int $end Optional index at which to end extraction. Optional.
- return Str
Example:
$str = new Str('Acme');
echo (string)$str->slice(2);
// meStrip all whitespace characters. This includes tabs and newline characters, as well as multi-byte whitespace such as the thin space and ideographic space.
- return Str
Example:
$str = new Str('Acme foo');
echo (string)$str->stripWhitespace();
// AcmefooTruncates the string to a given $length. If $substring is provided, and truncating occurs, the string is further truncated so that the substring may be appended without exceeding the desired length.
- param int $length Desired length of the truncated string.
- param string $end $substring The substring to append if it can fit. Defaults to empty string.
- return Str
Example:
$str = new Str('What are your plans today?');
echo (string)$str->truncate(19, '...');
// What are your pl...Returns an UpperCamelCase version of the string. It trims surrounding spaces, capitalizes letters following digits, spaces, dashes and underscores, and removes spaces, dashes, underscores.
- return Str
Example:
$str = new Str('foo bar baz');
echo (string)$str->upperCamelize();
// FooBarBazSurrounds the string with the given $substring.
- param string $substring The substring to add to both sides.
- return Str
Example:
$str = new Str('Acme');
echo (string)$str->surround('/');
// /Acme/Returns a case swapped version of the string.
- return Str
Example:
$str = new Str('foObARbAz');
echo (string)$str->swapCase();
// FOoBarBaZReturns a string with smart quotes, ellipsis characters, and dashes from Windows-1252 (commonly used in Word documents) replaced by their ASCII equivalents.
- return Str
Example:
$str = new Str('“I see…”');
echo (string)$str->tidy();
// "I see..."Returns a trimmed string with the first letter of each word capitalized. Also accepts an array, $ignore, allowing you to list words not to be capitalized.
- param array $ignore An array of words not to capitalize. Defaults to empty array.
- return Str
Example:
$str = new Str('i like to watch DVDs at home');
echo (string)$str->titleize(['at', 'to', 'the']);
// I Like to Watch Dvds at HomeReturns a boolean representation of the given logical string value. For example, 'true', '1', 'on' and 'yes' will return true. 'false', '0', 'off', and 'no' will return false. In all instances, case is ignored. For other numeric strings, their sign will determine the return value. In addition, blank strings consisting of only whitespace will return false. For all other strings, the return value is a result of a boolean cast.
- return bool
Example:
$str = new Str('yes');
echo $str->toBoolean();
// trueConverts each tab in the string to some number of spaces, as defined by $tabLength. By default, each tab is converted to 4 consecutive spaces.
- param int $tabLength Number of spaces to replace each tab with. Defaults to 4.
- return Str
Example:
$str = new Str('foo bar');
echo (string)$str->toSpaces(0);
// foobarConverts each occurrence of some consecutive number of spaces, as defined by $tabLength, to a tab. By default, each 4 consecutive spaces are converted to a tab.
- param int $tabLength Number of spaces to replace each tab with. Defaults to 4.
- return Str
Example:
$str = new Str('foo bar');
echo (string)$str->toTabs();
// foo barConverts the first character of each word in the string to uppercase.
- return Str
Example:
$str = new Str('foo bar baz');
echo (string)$str->toTitleCase();
// Foo Bar BazReturns a lowercase and trimmed string separated by underscores. Underscores are inserted before uppercase characters (with the exception of the first character of the string), and in place of spaces as well as dashes.
- return Str
Example:
$str = new Str('foo Bar baz');
echo (string)$str->underscored();
// foo_bar_bazCheck if the string has $prefix at the start.
- param string $prefix
- return bool
Example:
$str = new Str('/Acme/');
echo $str->hasPrefix('/');
// trueCheck if the string has $suffix at the end.
- param string $suffix
- return bool
Example:
$str = new Str('/Acme/');
echo $str->hasSuffix('/');
// trueReplace returns a copy of the string s with the first n non-overlapping instances of old replaced by new. If old is empty, it matches at the beginning of the string and after each UTF-8 sequence, yielding up to k+1 replacements for a k-rune string. If n < 0, there is no limit on the number of replacements.
- param string $old
- param string $new
- param int $times Defaults to -1, providing unlimited replacement.
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->replaceWithLimit('/', '#', 1);
// #Acme/Move substring of desired $length to $destination index of the original string. In case $destination is less than $length returns the string untouched.
- param int $start
- param int $length
- param int $destination
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->move(0, 2, 4);
// cm/Ae/Replaces substring in the original string of $length with given $substr.
- param int $start
- param int $length
- param string $substr
- return Str
Example:
$str = new Str('/Acme/');
echo (string)$str->overwrite(0, 2, 'BAR');
// BARcme/Returns a snake_case version of the string.
- return Str
Example:
$str = new Str('Foo Bar');
echo (string)$str->snakeize();
// foo_barInserts given $substr $times into the original string after the first occurrence of $needle.
- param string $needle
- param string $substr
- param int $times Defaults to 1.
- return Str
Example:
$str = new Str('foo bar baz');
echo (string)$str->afterFirst('a', 'duh', 2);
// foo baduhduhr bazInserts given $substr $times into the original string before the first occurrence of $needle.
- param string $needle
- param string $substr
- param int $times Defaults to 1.
- return Str
Example:
$str = new Str('foo bar baz');
echo (string)$str->beforeFirst('a', 'duh');
// foo bduhar bazInserts given $substr $times into the original string after the last occurrence of $needle.
- param string $needle
- param string $substr
- param int $times Defaults to 1.
- return Str
Example:
$str = new Str('foo bar baz');
echo (string)$str->afterLast('a', 'duh', 2);
// foo bar baduhduhzInserts given $substr $times into the original string before the last occurrence of $needle.
- param string $needle
- param string $substr
- param int $times Defaults to 1.
- return Str
Example:
$str = new Str('foo bar baz');
echo (string)$str->beforeLast('a', 'duh');
// foo bar bduhazSplits the original string in pieces by '@' delimiter and returns true in case the resulting array consists of 2 parts.
- return bool
Example:
$str = new Str('test@test@example.com');
echo $str->isEmail();
// falseChecks whether the string is a valid ip v4.
- return bool
Example:
$str = new Str('192.168.1.1');
echo $str->isIpV4();
// trueChecks whether the string is a valid ip v6.
- return bool
Example:
$str = new Str('1200::AB00:1234::2552:7777:1313');
echo $str->isIpV6();
// falseChecks if the given string is a valid UUID v.4. It doesn't matter whether the given UUID has dashes.
- return bool
Example:
$str = new Str('76d7cac8-1bd7-11e8-accf-0ed5f89f718b');
echo $str->isUUIDv4();
// false
$str = new Str('ae815123-537f-4eb3-a9b8-35881c29e1ac');
echo $str->isUUIDv4();
// trueGenerates a random string consisting of $possibleChars, if specified, of given $size or random length between $size and $sizeMax. If $possibleChars is not specified, the generated string will consist of ASCII alphanumeric chars.
- param int $size The desired length of the string.
- param int $sizeMax If given and is > $size, the generated string will have random length between $size and $sizeMax. Defaults to -1.
- param string $possibleChars If given, specifies allowed characters to make the string of. Defaults to ASCII alphanumeric chars.
- return Str
Example:
$str = new Str('foo bar');
echo $str->random(3, -1, 'fobarz');
// zfa
$str = new Str('');
echo $str->random(3);
// 1hoAppends a random string consisting of $possibleChars, if specified, of given $size or random length between $size and $sizeMax to the original string.
- param int $size The desired length of the string. Defaults to 4.
- param int $sizeMax If given and is > $size, the generated string will have random length between $size and $sizeMax. Defaults to -1.
- param string $possibleChars If given, specifies allowed characters to make the string of. Defaults to ASCII alphanumeric chars.
- return Str
Example:
$str = new Str('foo');
echo $str->appendUniqueIdentifier(3, -1, 'foba_rz');
// foozroWraps each word in the string with specified $quote.
- param string $quote Defaults to ".
- return Str
Example:
$str = new Str('foo bar baz');
echo $str->quote('*');
// *foo* *bar* *baz*Unwraps each word in the original string, deleting the specified $quote.
- param string $quote Defaults to ".
- return Str
Example:
$str = new Str('*foo* bar* ***baz*');
echo $str->unquote('*');
// foo bar bazSplits on whitespace, returning an array of strings corresponding to the words in the string.
- return array
Example:
$str = new Str('foo bar baz');
echo $str->words();
// ['foo', 'bar', 'baz']Cuts the original string in pieces of $step size.
- param int $step
- return array
Example:
$str = new Str('foo bar baz');
echo $str->chop(2);
// ['fo', 'o ', 'ba', 'r ', 'ba', 'z']Joins the original string with an array of other strings with the given $separator.
- param string $separator
- param array $otherStrings Defaults to empty array.
- return Str
Example:
$str = new Str('foo');
echo $str->join('*', ['bar', 'baz']);
// foo*bar*bazReturns the substring of the string from the last occurrence of $delimiter to the end.
- param string $delimiter
- return Str
Example:
$str = new Str('Acme/foo');
echo $str->pop('/');
// fooReturns the substring of the original string from beginning to the first occurrence of $delimiter.
- param string $delimiter
- return Str
Example:
$str = new Str('Acme/foo');
echo $str->shift('/');
// AcmeReturns the substring of the original string from the first occurrence of $delimiter to the end.
- param string $delimiter
- return Str
Example:
$str = new Str('Acme/foo/bar');
echo $str->shiftReversed('/');
// foo/barReturns the substring of the original string from the beginning to the last occurrence of $delimiter.
- param string $delimiter
- return Str
Example:
$str = new Str('Acme/foo/bar');
echo $str->popReversed('/');
// Acme/foolib code tests (versus):
make lib-code-testshow to get total RANK:
make rankgenerate md:
make mdrun tests:
make testTest subjects:
- FS (str/str)
- Stringy (danielstjules/Stringy)
RANK (sum time of all benchmarks): smaller - is better!
| Target | Total Time | Diff |
|---|---|---|
| Str | 5.505 s. | 1x |
| Stringy | 10.840 s. | 2.0x |
| subject | mode | mem_peak | diff |
|---|---|---|---|
| bench_common_Str | 811.098μs | 1,929,728b | 1.00x |
| bench_common_Stringy | 5,310.290μs | 1,879,272b | 6.55x |