MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION MX, Reference

Page: 906 / 1108

906 Chapter 3: ColdFusion Functions
Wrap
Description
Wraps text so that each line has a specified maximum number of characters.
Returns
String containing the wrapped text.
Category
String functions
Function syntax
Wrap ( string, limit [, strip ])
See also
cfmail
History
ColdFusion MX 6.1: Added this function
Parameters
Usage
Inserts line break at the location of the first white space character (such as a space, tab, or new
line) before the specified limit on a line. If a line has no whitespace characters before the limit,
inserts a line break at the limit. Uses the operating-system specific line break: newline for UNIX,
carriage return and newline on Windows.
If you specify the
strip
parameter, all existing line breaks are removed, so any paragraph
formatting is lost.
Use this function to limit the length of text lines, such as text to be included in a mail message.
The
cfmail
and
cfmailpart
tag
wraptext
attributes use this function
Example
<h3>Wrap Example</h3>
<cfset inputText="This is an example of a text message that we want to wrap. It
is rather long and needs to be broken into shorter lines.">
<cfoutput>#Wrap(inputText, 59)#</cfoutput>
Parameter Description
string String or variable that contains one. The text to wrap.
limit Positive integer maximum number of characters to allow on a line.
strip Boolean specifying whether to remove all existing newline and carriage return
characters in the input string with spaces before wrapping the text. The default
value is False.