freenetis-github/application/helpers/inflector.php @ 1e52b1de
| 8baed187 | Michal Kliment | <?php defined('SYSPATH') or die('No direct script access.');
|
|
/**
|
|||
* Inflector helper class.
|
|||
*
|
|||
* $Id: inflector.php 1970 2008-02-06 21:54:29Z Shadowhand $
|
|||
*
|
|||
* @package Core
|
|||
* @author Kohana Team
|
|||
* @copyright (c) 2007-2008 Kohana Team
|
|||
* @license http://kohanaphp.com/license.html
|
|||
*/
|
|||
class inflector {
|
|||
/**
|
|||
* Checks if a word is defined as uncountable.
|
|||
*
|
|||
* @param string word to check
|
|||
* @return boolean
|
|||
*/
|
|||
public static function uncountable($str)
|
|||
{
|
|||
static $uncountables = NULL;
|
|||
if ($uncountables === NULL)
|
|||
{
|
|||
// Makes a mirrored array, eg: foo => foo
|
|||
$uncountables = array_flip(Kohana::lang('inflector'));
|
|||
}
|
|||
return isset($uncountables[$str]);
|
|||
}
|
|||
/**
|
|||
* Makes a plural word singular.
|
|||
*
|
|||
* @param string word to singularize
|
|||
* @return string
|
|||
*/
|
|||
public static function singular($str, $count = NULL)
|
|||
{
|
|||
static $cache;
|
|||
$str = trim($str);
|
|||
// Cache key name
|
|||
$key = $str.$count;
|
|||
// We can just return uncountable words
|
|||
if (inflector::uncountable($str))
|
|||
return $str;
|
|||
if (is_string($count) AND ctype_digit($count))
|
|||
{
|
|||
// Convert to integer when using a digit string
|
|||
$count = (int) $count;
|
|||
}
|
|||
if ($cache === NULL)
|
|||
{
|
|||
// Initialize the cache
|
|||
$cache = array();
|
|||
}
|
|||
else
|
|||
{
|
|||
// Already pluralized
|
|||
if (isset($cache[$key]))
|
|||
return $cache[$key];
|
|||
}
|
|||
// Do nothing with a single count
|
|||
if (is_int($count) AND $count === 0 OR $count > 1)
|
|||
return $str;
|
|||
$end = substr($str, -3);
|
|||
if ($end == 'ies')
|
|||
{
|
|||
$str = substr($str, 0, strlen($str) - 3).'y';
|
|||
}
|
|||
elseif ($end == 'ses' OR $end == 'zes' OR $end == 'xes')
|
|||
{
|
|||
$str = substr($str, 0, strlen($str) - 2);
|
|||
}
|
|||
elseif (substr($str, -1) == 's')
|
|||
{
|
|||
$str = substr($str, 0, strlen($str) - 1);
|
|||
}
|
|||
return $cache[$key] = $str;
|
|||
}
|
|||
/**
|
|||
* Makes a singular word plural.
|
|||
*
|
|||
* @param string word to pluralize
|
|||
* @return string
|
|||
*/
|
|||
public static function plural($str, $count = NULL)
|
|||
{
|
|||
static $cache;
|
|||
$str = trim($str);
|
|||
// Cache key name
|
|||
$key = $str.$count;
|
|||
// We can just return uncountable words
|
|||
if (inflector::uncountable($str))
|
|||
return $str;
|
|||
if (is_string($count) AND ctype_digit($count))
|
|||
{
|
|||
// Convert to integer when using a digit string
|
|||
$count = (int) $count;
|
|||
}
|
|||
if ($cache === NULL)
|
|||
{
|
|||
// Initialize the cache
|
|||
$cache = array();
|
|||
}
|
|||
else
|
|||
{
|
|||
// Already pluralized
|
|||
if (isset($cache[$key]))
|
|||
return $cache[$key];
|
|||
}
|
|||
// If the count is one, do not pluralize
|
|||
if ($count === 1)
|
|||
return $str;
|
|||
$end = substr($str, -1);
|
|||
$low = (strcmp($end, strtolower($end)) === 0) ? TRUE : FALSE;
|
|||
if (preg_match('/[sxz]$/i', $str) OR preg_match('/[^aeioudgkprt]h$/i', $str))
|
|||
{
|
|||
$end = 'es';
|
|||
$str .= ($low == FALSE) ? strtoupper($end) : $end;
|
|||
}
|
|||
elseif (preg_match('/[^aeiou]y$/i', $str))
|
|||
{
|
|||
$end = 'ies';
|
|||
$end = ($low == FALSE) ? strtoupper($end) : $end;
|
|||
$str = substr_replace($str, $end, -1);
|
|||
}
|
|||
else
|
|||
{
|
|||
$end = 's';
|
|||
$str .= ($low == FALSE) ? strtoupper($end) : $end;
|
|||
}
|
|||
// Set the cache and return
|
|||
return $cache[$key] = $str;
|
|||
}
|
|||
/**
|
|||
* Makes a phrase camel case.
|
|||
*
|
|||
* @param string phrase to camelize
|
|||
* @return string
|
|||
*/
|
|||
public static function camelize($str)
|
|||
{
|
|||
$str = 'x'.strtolower(trim($str));
|
|||
$str = ucwords(preg_replace('/[\s_]+/', ' ', $str));
|
|||
return substr(str_replace(' ', '', $str), 1);
|
|||
}
|
|||
/**
|
|||
* Makes a phrase underscored instead of spaced.
|
|||
*
|
|||
* @param string phrase to underscore
|
|||
* @return string
|
|||
*/
|
|||
public static function underscore($str)
|
|||
{
|
|||
return preg_replace('/\s+/', '_', trim($str));
|
|||
}
|
|||
/**
|
|||
* Makes an underscored or dashed phrase human-reable.
|
|||
*
|
|||
* @param string phrase to make human-reable
|
|||
* @return string
|
|||
*/
|
|||
public static function humanize($str)
|
|||
{
|
|||
return preg_replace('/[_-]+/', ' ', trim($str));
|
|||
}
|
|||
} // End inflector
|