Truncate a string at a word boundary close to the given position.

Syntax

Smartsite SXML	Copy Code
string string.truncate(string data, integer targetLength) string string.truncate(string data, integer targetLength, integer maxDeviation) string string.truncate(string data, integer targetLength, integer maxDeviation, string suffix) string string.truncate(string data, integer targetLength, string suffix)

Smartsite SXML

Copy Code

string string.truncate(string data, integer targetLength)
string string.truncate(string data, integer targetLength, integer maxDeviation)
string string.truncate(string data, integer targetLength, integer maxDeviation, string suffix)
string string.truncate(string data, integer targetLength, string suffix)

Parameters

Name	Data Type	Description
data	String	The input string.
targetLength	Integer	The optimal length for the truncated string.
maxDeviation	Integer	The allowed difference in length between the optimal length and the actual length. Default is 20% of targetLength.
suffix	String	String to append to output if the input is actually truncated.

Return Value

Data Type	Description
String	The truncated string.

Example

Smartsite SXML	Copy Code
<se:text save="mytext"> Yes. This is a short story. This is short story about how string.truncate works. It right trims sentences up to a given length, attempting to use word boundaries to the a nice looking substring. </se:text> {string.length(string.truncate($mytext, 5))} {string.truncate($mytext, 5)} {string.length(string.truncate($mytext, 20))} {string.truncate($mytext, 20)} {string.length(string.truncate($mytext, 50))} {string.truncate($mytext, 50)}

SXML

Macro
Macro Parameters
Macro Parameter Properties
Vipers
- Global Viper Methods
- Local Viper Methods
SXML Data Types
Examples
Tips & Tricks