CFLib.org – Common Function Library Project

Description:
Limits the length of string output to a specified length and appends "..." to indicate the string has been trimmed. Ideal for limiting a string's length in a table without wrapping.

Return Values:
Returns a string.

Example:

<cfset tmp = "This a short sample string.">
<cfoutput>
    #maxLength(tmp, 12)#
</cfoutput>

Parameters:

Full UDF Source:

/**
 * Limit a string's output to the desired length.
 * 
 * @param string      The string to modify. 
 * @param length      The max length to use. 
 * @return Returns a string. 
 * @author John Reed (johnreed1972@yahoo.com.au) 
 * @version 1, February 24, 2002 
 */
function maxLength(string, length) {
    var padding = 3;
    var tmp = "...";    
        
    if ( len(string) gte length )
        return removeChars(trim(string), length, len(string) - padding) & tmp;
    else return string;
}