/**
* Trims a string to a specified length.
* It will allow tags listed in 'KeepTags' to remain and will intelligently
* append the trimmed text with '...' or '-' depending on if the trim ends on a word or a space.
*
* Expected Params:
* len integer The length to trim the string to
* value string The string to trim
* KeepTags string A list of tags (like '<p><a>') that are allowed in the trimmed text.
*
* @return string
*/
public function trim()
{
return StringUtils::trim($this->getParameter('value'), $this->getParameter('len'), $this->getParameter('keeptags'), $this->getParameter('decodehtml'), $this->getParameter('stripurls'));
}