CFLib.org – Common Function Library Project

Description:
Parameters are the same as left(). 0 Length returns no value. Negative lengths will return the the full string minus the specified number of characters from the right.

Return Values:
Returns a string.

Example:

<cfoutput>
left2( "CFlib.org", 0 ) = #left2( "CFlib.org", 0 )#<br>
left2( "CFlib.org", 2 ) = #left2( "CFlib.org", 2 )#<br>
left2( "CFlib.org", -3 ) = #left2( "CFlib.org", -3 )#<br>
</cfoutput>

Parameters:

Full UDF Source:

/**
 * Adds zero and negative support to the length parameter of left().
 * 
 * @param string      The string to modify. 
 * @param length      The length to use. 
 * @return Returns a string. 
 * @author Jordan Clark (JordanClark@Telus.net) 
 * @version 1, February 24, 2002 
 */
function left2( string, length )
{
  if( length GT 0 )
    return left( string, length );
  else if( length LT 0 )
    return left( string, len( string ) + length );
  else return "";
}