CFLib.org – camelToSpace

camelToSpace(str [, capitalize])

Last updated March 8, 2010

author

Version: 0 | Requires: ColdFusion MX | Library: StrLib

Rated 2 time(s). Average Rating: 4.5

Description:
This is not about furry puppets in a rocket ship, but a function that takes a camel cased string and returns it lower-cased with spaces between the words. Comes in handy if you want to generate human readable captions from (camel cased) table column names.

Return Values:
Returns a string

Example:

view plain print about

<cfoutput>
<cfset str='aCamelCasedVariable'>
#camelToSpace(str,true)#
<br/>
#camelToSpace(str)#
</cfoutput>

a very fancy column name 
id column

<cfoutput>
<cfset str='aCamelCasedVariable'>
#camelToSpace(str,true)#
<br/>
#camelToSpace(str)#
</cfoutput>

a very fancy column name
id column

Parameters:

Name	Description	Required
str	String to use	Yes
capitalize	Boolean to return capitalized words	No

Full UDF Source:

	
	
			
			
			
				
				view plain
				
				
				copy to clipboard
				
				
				
				
				print
				
				
				about
				ColdFISH is developed by Jason Delmore.  Source code and license information available at coldfish.riaforge.org.  Version 3.1.1
				
			<cfscript>
/**
 * Breaks a camelCased string into separate words
 * 8-mar-2010 added option to capitalize parsed words Brian Meloche &#98;&#114;&#105;&#97;&#110;&#109;&#101;&#108;&#111;&#99;&#104;&#101;&#64;&#103;&#109;&#97;&#105;&#108;&#46;&#99;&#111;&#109;
 * 
 * @param str 	 String to use (Required)
 * @param capitalize 	 Boolean to return capitalized words (Optional)
 * @return Returns a string 
 * @author Richard (&#98;&#114;&#105;&#97;&#110;&#109;&#101;&#108;&#111;&#99;&#104;&#101;&#64;&#103;&#109;&#97;&#105;&#108;&#46;&#99;&#111;&#109;&#97;&#99;&#100;&#104;&#105;&#114;&#114;&#64;&#116;&#114;&#105;&#108;&#111;&#98;&#105;&#101;&#116;&#46;&#110;&#108;) 
 * @version 0, March 8, 2010 
 */
function camelToSpace(str) {
	var rtnStr=lcase(reReplace(arguments.str,"([A-Z])([a-z])","&nbsp;\1\2","ALL"));
	if (arrayLen(arguments) GT 1 AND arguments[2] EQ true) {
		rtnStr=reReplace(arguments.str,"([a-z])([A-Z])","\1&nbsp;\2","ALL");
		rtnStr=uCase(left(rtnStr,1)) & right(rtnStr,len(rtnStr)-1);
	}
return trim(rtnStr);
}
</cfscript>
		<cfscript>
/**
 * Breaks a camelCased string into separate words
 * 8-mar-2010 added option to capitalize parsed words Brian Meloche brianmeloche@gmail.com
 * 
 * @param str      String to use (Required)
 * @param capitalize      Boolean to return capitalized words (Optional)
 * @return Returns a string 
 * @author Richard (brianmeloche@gmail.comacdhirr@trilobiet.nl) 
 * @version 0, March 8, 2010 
 */
function camelToSpace(str) {
    var rtnStr=lcase(reReplace(arguments.str,"([A-Z])([a-z])","&nbsp;\1\2","ALL"));
    if (arrayLen(arguments) GT 1 AND arguments[2] EQ true) {
        rtnStr=reReplace(arguments.str,"([a-z])([A-Z])","\1&nbsp;\2","ALL");
        rtnStr=uCase(left(rtnStr,1)) & right(rtnStr,len(rtnStr)-1);
    }
return trim(rtnStr);
}
</cfscript>