Current File : /var/www/html/diaspora/api/vendor/anahkiasen/underscore-php/src/Methods/StringsMethods.php
<?php
namespace Underscore\Methods;
use Doctrine\Common\Inflector\Inflector;
use Patchwork\Utf8;
use RuntimeException;
use Underscore\Types\Strings;
/**
* Methods to manage strings.
*/
class StringsMethods
{
////////////////////////////////////////////////////////////////////
////////////////////////////// CREATE /////////////////////////////
////////////////////////////////////////////////////////////////////
/**
* Create a string from a number.
*
* @param int $count A number
* @param string $many If many
* @param string $one If one
* @param string $zero If one
*
* @return string A string
*/
public static function accord($count, $many, $one, $zero = null)
{
if ($count === 1) {
$output = $one;
} else {
if ($count === 0 and !empty($zero)) {
$output = $zero;
} else {
$output = $many;
}
}
return sprintf($output, $count);
}
/**
* Generate a more truly "random" alpha-numeric string.
*
* @param int $length
*
* @throws \RuntimeException
* @return string
*
*
* @author Taylor Otwell
*/
public static function random($length = 16)
{
if (function_exists('openssl_random_pseudo_bytes')) {
$bytes = openssl_random_pseudo_bytes($length * 2);
if ($bytes === false) {
throw new RuntimeException('Unable to generate random string.');
}
return substr(str_replace(['/', '+', '='], '', base64_encode($bytes)), 0, $length);
}
return static::quickRandom($length);
}
/**
* Generate a "random" alpha-numeric string.
*
* Should not be considered sufficient for cryptography, etc.
*
* @param int $length
*
* @return string
*
* @author Taylor Otwell
*/
public static function quickRandom($length = 16)
{
$pool = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
return substr(str_shuffle(str_repeat($pool, $length)), 0, $length);
}
/**
* Generates a random suite of words.
*
* @param int $words The number of words
* @param int $length The length of each word
*
* @return string
*/
public static function randomStrings($words, $length = 10)
{
return Strings::from('0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ')
->shuffle()
->split($length)
->slice(0, $words)
->implode(' ')
->obtain();
}
////////////////////////////////////////////////////////////////////
////////////////////////////// ANALYZE /////////////////////////////
////////////////////////////////////////////////////////////////////
/**
* Determine if a given string ends with a given substring.
*
* @param string $haystack
* @param string|array $needles
*
* @return bool
*
* @author Taylor Otwell
*/
public static function endsWith($haystack, $needles)
{
foreach ((array) $needles as $needle) {
if ((string) $needle === substr($haystack, -strlen($needle))) {
return true;
}
}
return false;
}
/**
* Check if a string is an IP.
*
* @return bool
*/
public static function isIp($string)
{
return filter_var($string, FILTER_VALIDATE_IP) !== false;
}
/**
* Check if a string is an email.
*
* @return bool
*/
public static function isEmail($string)
{
return filter_var($string, FILTER_VALIDATE_EMAIL) !== false;
}
/**
* Check if a string is an url.
*
* @return bool
*/
public static function isUrl($string)
{
return filter_var($string, FILTER_VALIDATE_URL) !== false;
}
/**
* Determine if a given string starts with a given substring.
*
* @param string $haystack
* @param string|array $needles
*
* @return bool
*
* @author Taylor Otwell
*/
public static function startsWith($haystack, $needles)
{
foreach ((array) $needles as $needle) {
if ($needle !== '' && strpos($haystack, $needle) === 0) {
return true;
}
}
return false;
}
////////////////////////////////////////////////////////////////////
///////////////////////////// FETCH FROM ///////////////////////////
////////////////////////////////////////////////////////////////////
/**
* Find one or more needles in one or more haystacks.
*
* @param array|string $string The haystack(s) to search in
* @param array|string $needle The needle(s) to search for
* @param bool $caseSensitive Whether the function is case sensitive or not
* @param bool $absolute Whether all needle need to be found or whether one is enough
*
* @return bool Found or not
*/
public static function find($string, $needle, $caseSensitive = false, $absolute = false)
{
// If several needles
if (is_array($needle) or is_array($string)) {
if (is_array($needle)) {
$sliceFrom = $needle;
$sliceTo = $string;
} else {
$sliceFrom = $string;
$sliceTo = $needle;
}
$found = 0;
foreach ($sliceFrom as $need) {
if (static::find($sliceTo, $need, $absolute, $caseSensitive)) {
$found++;
}
}
return ($absolute) ? count($sliceFrom) === $found : $found > 0;
}
// If not case sensitive
if (!$caseSensitive) {
$string = strtolower($string);
$needle = strtolower($needle);
}
// If string found
$pos = strpos($string, $needle);
return !($pos === false);
}
/**
* Slice a string with another string.
*/
public static function slice($string, $slice)
{
$sliceTo = static::sliceTo($string, $slice);
$sliceFrom = static::sliceFrom($string, $slice);
return [$sliceTo, $sliceFrom];
}
/**
* Slice a string from a certain point.
*/
public static function sliceFrom($string, $slice)
{
$slice = strpos($string, $slice);
return substr($string, $slice);
}
/**
* Slice a string up to a certain point.
*/
public static function sliceTo($string, $slice)
{
$slice = strpos($string, $slice);
return substr($string, 0, $slice);
}
/**
* Get the base class in a namespace.
*
* @param string $string
*
* @return string
*/
public static function baseClass($string)
{
$string = static::replace($string, '\\', '/');
return basename($string);
}
////////////////////////////////////////////////////////////////////
/////////////////////////////// ALTER //////////////////////////////
////////////////////////////////////////////////////////////////////
/**
* Prepend a string with another.
*
* @param string $string The string
* @param string $with What to prepend with
*
* @return string
*/
public static function prepend($string, $with)
{
return $with.$string;
}
/**
* Append a string to another.
*
* @param string $string The string
* @param string $with What to append with
*
* @return string
*/
public static function append($string, $with)
{
return $string.$with;
}
/**
* Limit the number of characters in a string.
*
* @param string $value
* @param int $limit
* @param string $end
*
* @return string
*
* @author Taylor Otwell
*/
public static function limit($value, $limit = 100, $end = '...')
{
if (mb_strlen($value) <= $limit) {
return $value;
}
return rtrim(mb_substr($value, 0, $limit, 'UTF-8')).$end;
}
/**
* Remove part of a string.
*/
public static function remove($string, $remove)
{
// If we only have one string to remove
if (!is_array($remove)) {
$string = str_replace($remove, null, $string);
} // Else, use Regex
else {
$string = preg_replace('#('.implode('|', $remove).')#', null, $string);
}
// Trim and return
return trim($string);
}
/**
* Correct arguments order for str_replace.
*/
public static function replace($string, $replace, $with)
{
return str_replace($replace, $with, $string);
}
/**
* Toggles a string between two states.
*
* @param string $string The string to toggle
* @param string $first First value
* @param string $second Second value
* @param bool $loose Whether a string neither matching 1 or 2 should be changed
*
* @return string The toggled string
*/
public static function toggle($string, $first, $second, $loose = false)
{
// If the string given match none of the other two, and we're in strict mode, return it
if (!$loose and !in_array($string, [$first, $second], true)) {
return $string;
}
return $string === $first ? $second : $first;
}
/**
* Generate a URL friendly "slug" from a given string.
*
* @param string $title
* @param string $separator
*
* @return string
*
* @author Taylor Otwell
*/
protected static function slug($title, $separator = '-')
{
$title = Utf8::toAscii($title);
// Convert all dashes/underscores into separator
$flip = $separator === '-' ? '_' : '-';
$title = preg_replace('!['.preg_quote($flip).']+!u', $separator, $title);
// Remove all characters that are not the separator, letters, numbers, or whitespace.
$title = preg_replace('![^'.preg_quote($separator).'\pL\pN\s]+!u', '', mb_strtolower($title));
// Replace all separator characters and whitespace by a single separator
$title = preg_replace('!['.preg_quote($separator).'\s]+!u', $separator, $title);
return trim($title, $separator);
}
/**
* Slugifies a string.
*/
public static function slugify($string, $separator = '-')
{
$string = str_replace('_', ' ', $string);
return static::slug($string, $separator);
}
/**
* Explode a string into an array.
*/
public static function explode($string, $with, $limit = null)
{
if (!$limit) {
return explode($with, $string);
}
return explode($with, $string, $limit);
}
/**
* Lowercase a string.
*
* @param string $string
*
* @return string
*/
public static function lower($string)
{
return mb_strtolower($string, 'UTF-8');
}
/**
* Get the plural form of an English word.
*
* @param string $value
* @param int $count
*
* @return string
*/
public static function plural($value)
{
return Inflector::pluralize($value);
}
/**
* Get the singular form of an English word.
*
* @param string $value
*
* @return string
*/
public static function singular($value)
{
return Inflector::singularize($value);
}
/**
* Lowercase a string.
*
* @param string $string
*
* @return string
*/
public static function upper($string)
{
return mb_strtoupper($string, 'UTF-8');
}
/**
* Convert a string to title case.
*
* @param string $string
*
* @return string
*/
public static function title($string)
{
return mb_convert_case($string, MB_CASE_TITLE, 'UTF-8');
}
/**
* Limit the number of words in a string.
*
* @param string $value
* @param int $words
* @param string $end
*
* @return string
*
* @author Taylor Otwell
*/
public static function words($value, $words = 100, $end = '...')
{
preg_match('/^\s*+(?:\S++\s*+){1,'.$words.'}/u', $value, $matches);
if (!isset($matches[0]) || strlen($value) === strlen($matches[0])) {
return $value;
}
return rtrim($matches[0]).$end;
}
////////////////////////////////////////////////////////////////////
/////////////////////////// CASE SWITCHERS /////////////////////////
////////////////////////////////////////////////////////////////////
/**
* Convert a string to PascalCase.
*
* @param string $string
*
* @return string
*/
public static function toPascalCase($string)
{
return Inflector::classify($string);
}
/**
* Convert a string to snake_case.
*
* @param string $string
*
* @return string
*/
public static function toSnakeCase($string)
{
return preg_replace_callback('/([A-Z])/', function ($match) {
return '_'.strtolower($match[1]);
}, $string);
}
/**
* Convert a string to camelCase.
*
* @param string $string
*
* @return string
*/
public static function toCamelCase($string)
{
return Inflector::camelize($string);
}
}
Mini Shell