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 syntaxWrap(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> |
STRING | |
LIMIT | |
STRIP | |