CFLib.org – Common Function Library Project

FullLeft(str, count)

Last updated April 16, 2002

author

Marc Esher

Version: 2 | Requires: CF5 | Library: StrLib

Description:
An enhanced version of left() that doesn't cut words off in the middle; instead, it searches backward until it finds a full word.

Return Values:
Returns a string.

Example:

<cfset text="You wouldn't see words chopped in half on the front page of the New York Times">

<cfoutput>
Full String: #text#<BR>
FullLeft(text, 25): #fullLeft(text, 25)#<BR>
FullLeft(text, 34): #fullLeft(text, 34)#<BR>
</cfoutput>

Parameters:

Name Description Required
str String to be checked. Yes
count Number of characters from the left to return. Yes

Full UDF Source:

/**
 * An enhanced version of left() that doesn't cut words off in the middle.
 * Minor edits by Rob Brooks-Bilson (rbils@amkor.com) and Raymond Camden (ray@camdenfamily.com)
 * 
 * Updates for version 2 include fixes where count was very short, and when count+1 was a space. Done by RCamden.
 * 
 * @param str 	 String to be checked. 
 * @param count 	 Number of characters from the left to return. 
 * @return Returns a string. 
 * @author Marc Esher (jonnycattt@aol.com) 
 * @version 2, April 16, 2002 
 */
function fullLeft(str, count) {
	if (not refind("[[:space:]]", str) or (count gte len(str)))
		return Left(str, count);
	else if(reFind("[[:space:]]",mid(str,count+1,1))) {
	  	return left(str,count);
	} else { 
		if(count-refind("[[:space:]]", reverse(mid(str,1,count)))) return Left(str, (count-refind("[[:space:]]", reverse(mid(str,1,count))))); 
		else return(left(str,1));
	}
}
blog comments powered by Disqus

Search CFLib.org


Latest Additions

Kevin Cotton added
date2ExcelDate
May 5, 2016

Raymond Camden added
CapFirst
April 25, 2016

Chris Wigginton added
loremIpsum
January 18, 2016

Gary Stanton added
calculateArrival...
November 19, 2015

Sebastiaan Naafs - van Dijk added
getDaysInQuarter
November 13, 2015

Created by Raymond Camden / Design by Justin Johnson