Inflector helper class. Inflection is changing the form of a word based on the context it is used in. For example, changing a word into a plural form.
Inflection is only tested with English, and is will not work with other languages.
Class declared in SYSPATH/classes/Inflector.php on line 3.
array $cachelink to thiscached inflections
array(0) array $irregularlink to thisirregular words
NULL
array $uncountablelink to thisuncountable words
NULL
Makes a phrase camel case. Spaces and underscores will be removed.
$str= Inflector::camelize('mother cat');// "motherCat"$str= Inflector::camelize('kittens in bed');// "kittensInBed"
string
$str
required - Phrase to camelize string
publicstaticfunctioncamelize($str){$str='x'.strtolower(trim($str));$str= ucwords(preg_replace('/[\s_]+/',' ',$str));returnsubstr(str_replace(' ','',$str), 1);}
Converts a camel case phrase into a spaced phrase.
$str= Inflector::decamelize('houseCat');// "house cat"$str= Inflector::decamelize('kingAllyCat');// "king ally cat"
string
$str
required - Phrase to camelize string
$sep
= string(1) " " - Word separator string
publicstaticfunctiondecamelize($str,$sep=' '){returnstrtolower(preg_replace('/([a-z])([A-Z])/','$1'.$sep.'$2', trim($str)));}
Makes an underscored or dashed phrase human-readable.
$str= Inflector::humanize('kittens-are-cats');// "kittens are cats"$str= Inflector::humanize('dogs_as_well');// "dogs as well"
string
$str
required - Phrase to make human-readable string
publicstaticfunctionhumanize($str){returnpreg_replace('/[_-]+/',' ', trim($str));}
Makes a singular word plural.
echoInflector::plural('fish');// "fish", uncountableechoInflector::plural('cat');// "cats"
You can also provide the count to make inflection more intelligent. In this case, it will only return the plural value if the count is not one.
echoInflector::singular('cats', 3);// "cats"
Special inflections are defined in config/inflector.php.
string
$str
required - Word to pluralize integer
$count
= NULL - Count of thing string
publicstaticfunctionplural($str,$count= null){// $count should always be a float$count= ($count=== null) ? 0.0 : (float)$count;// Do nothing with singularif($count== 1)return$str;// Remove garbage$str= trim($str);// Cache key name$key='plural_'.$str.$count;// Check uppercase$is_uppercase= ctype_upper($str);if(isset(Inflector::$cache[$key]))returnInflector::$cache[$key];if(Inflector::uncountable($str))returnInflector::$cache[$key] =$str;if(empty(Inflector::$irregular)) {// Cache irregular wordsInflector::$irregular= Kohana::$config->load('inflector')->irregular;}if(isset(Inflector::$irregular[$str])) {$str= Inflector::$irregular[$str];}elseif(in_array($str, Inflector::$irregular)) {// Do nothing}elseif(preg_match('/[sxz]$/',$str) OR preg_match('/[^aeioudgkprt]h$/',$str)) {$str.='es';}elseif(preg_match('/[^aeiou]y$/',$str)) {// Change "y" to "ies"$str= substr_replace($str,'ies', -1);}else{$str.='s';}// Convert to uppercase if necessaryif($is_uppercase) {$str=strtoupper($str);}// Set the cache and returnreturnInflector::$cache[$key] =$str;}
Makes a plural word singular.
echoInflector::singular('cats');// "cat"echoInflector::singular('fish');// "fish", uncountable
You can also provide the count to make inflection more intelligent. In this case, it will only return the singular value if the count is greater than one and not zero.
echoInflector::singular('cats', 2);// "cats"
Special inflections are defined in config/inflector.php.
string
$str
required - Word to make singular integer
$count
= NULL - Count of thing string
publicstaticfunctionsingular($str,$count= null){// $count should always be a float$count= ($count=== null) ? 1.0 : (float)$count;// Do nothing when $count is not 1if($count!= 1)return$str;// Remove garbage$str=strtolower(trim($str));// Cache key name$key='singular_'.$str.$count;if(isset(Inflector::$cache[$key]))returnInflector::$cache[$key];if(Inflector::uncountable($str))returnInflector::$cache[$key] =$str;if(empty(Inflector::$irregular)) {// Cache irregular wordsInflector::$irregular= Kohana::$config->load('inflector')->irregular;}if($irregular=array_search($str, Inflector::$irregular)) {$str=$irregular;}elseif(preg_match('/us$/',$str)) {// Already singular, do nothing}elseif(preg_match('/[sxz]es$/',$str) OR preg_match('/[^aeioudgkprt]hes$/',$str)) {// Remove "es"$str=substr($str, 0, -2);}elseif(preg_match('/[^aeiou]ies$/',$str)) {// Replace "ies" with "y"$str=substr($str, 0, -3) .'y';}elseif(substr($str, -1) ==='s'ANDsubstr($str, -2) !=='ss') {// Remove singular "s"$str=substr($str, 0, -1);}returnInflector::$cache[$key] =$str;}
Checks if a word is defined as uncountable. An uncountable word has a single form. For instance, one "fish" and many "fish", not "fishes".
Inflector::uncountable('fish');// trueInflector::uncountable('cat');// false
If you find a word is being pluralized improperly, it has probably not
been defined as uncountable in config/inflector.php. If this is the
case, please report an issue.
string
$str
required - Word to check boolean
publicstaticfunctionuncountable($str){if(Inflector::$uncountable=== null) {// Cache uncountablesInflector::$uncountable= Kohana::$config->load('inflector')->uncountable;// Make uncountables mirroredInflector::$uncountable=array_combine(Inflector::$uncountable, Inflector::$uncountable);}returnisset(Inflector::$uncountable[strtolower($str)]);}
Makes a phrase underscored instead of spaced.
$str= Inflector::underscore('five cats');// "five_cats";
string
$str
required - Phrase to underscore string
publicstaticfunctionunderscore($str){returnpreg_replace('/\s+/','_', trim($str));}