joomla_test/libraries/joomla/string/normalise.php
2020-01-02 22:20:31 +07:00

166 lines
4.2 KiB
PHP

<?php
/**
* @package Joomla.Platform
* @subpackage String
*
* @copyright Copyright (C) 2005 - 2013 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE
*/
defined('JPATH_PLATFORM') or die;
/**
* Joomla Platform String Normalise Class
*
* @package Joomla.Platform
* @subpackage String
* @since 11.3
*/
abstract class JStringNormalise
{
/**
* Method to convert a string from camel case.
*
* This method offers two modes. Grouped allows for splitting on groups of uppercase characters as follows:
*
* "FooBarABCDef" becomes array("Foo", "Bar", "ABC", "Def")
* "JFooBar" becomes array("J", "Foo", "Bar")
* "J001FooBar002" becomes array("J001", "Foo", "Bar002")
* "abcDef" becomes array("abc", "Def")
* "abc_defGhi_Jkl" becomes array("abc_def", "Ghi_Jkl")
* "ThisIsA_NASAAstronaut" becomes array("This", "Is", "A_NASA", "Astronaut"))
* "JohnFitzgerald_Kennedy" becomes array("John", "Fitzgerald_Kennedy"))
*
* Non-grouped will split strings at each uppercase character.
*
* @param string $input The string input (ASCII only).
* @param boolean $grouped Optionally allows splitting on groups of uppercase characters.
*
* @return string The space separated string.
*
* @since 12.1
*/
public static function fromCamelCase($input, $grouped = false)
{
return $grouped
? preg_split('/(?<=[^A-Z_])(?=[A-Z])|(?<=[A-Z])(?=[A-Z][^A-Z_])/x', $input)
: trim(preg_replace('#([A-Z])#', ' $1', $input));
}
/**
* Method to convert a string into camel case.
*
* @param string $input The string input (ASCII only).
*
* @return string The camel case string.
*
* @since 11.3
*/
public static function toCamelCase($input)
{
// Convert words to uppercase and then remove spaces.
$input = self::toSpaceSeparated($input);
$input = ucwords($input);
$input = str_ireplace(' ', '', $input);
return $input;
}
/**
* Method to convert a string into dash separated form.
*
* @param string $input The string input (ASCII only).
*
* @return string The dash separated string.
*
* @since 11.3
*/
public static function toDashSeparated($input)
{
// Convert spaces and underscores to dashes.
$input = preg_replace('#[ \-_]+#', '-', $input);
return $input;
}
/**
* Method to convert a string into space separated form.
*
* @param string $input The string input (ASCII only).
*
* @return string The space separated string.
*
* @since 11.3
*/
public static function toSpaceSeparated($input)
{
// Convert underscores and dashes to spaces.
$input = preg_replace('#[ \-_]+#', ' ', $input);
return $input;
}
/**
* Method to convert a string into underscore separated form.
*
* @param string $input The string input (ASCII only).
*
* @return string The underscore separated string.
*
* @since 11.3
*/
public static function toUnderscoreSeparated($input)
{
// Convert spaces and dashes to underscores.
$input = preg_replace('#[ \-_]+#', '_', $input);
return $input;
}
/**
* Method to convert a string into variable form.
*
* @param string $input The string input (ASCII only).
*
* @return string The variable string.
*
* @since 11.3
*/
public static function toVariable($input)
{
// Remove dashes and underscores, then convert to camel case.
$input = self::toSpaceSeparated($input);
$input = self::toCamelCase($input);
// Remove leading digits.
$input = preg_replace('#^[0-9]+.*$#', '', $input);
// Lowercase the first character.
$first = substr($input, 0, 1);
$first = strtolower($first);
// Replace the first character with the lowercase character.
$input = substr_replace($input, $first, 0, 1);
return $input;
}
/**
* Method to convert a string into key form.
*
* @param string $input The string input (ASCII only).
*
* @return string The key string.
*
* @since 11.3
*/
public static function toKey($input)
{
// Remove spaces and dashes, then convert to lower case.
$input = self::toUnderscoreSeparated($input);
$input = strtolower($input);
return $input;
}
}