/**
* Truncates a string to the given length. It will optionally preserve
* HTML tags if $is_html is set to true.
*
* Adapted from FuelPHP Str::truncate (https://github.com/fuelphp/common/blob/master/src/Str.php)
*
* @param string $string
* @param int $charactersCount
*
* @return string the truncated string
*/
private function truncateHtml($string, $charactersCount)
{
$limit = $charactersCount;
$offset = 0;
$tags = array();
// Handle special characters.
preg_match_all('/&[a-z]+;/i', strip_tags($string), $matches, PREG_OFFSET_CAPTURE | PREG_SET_ORDER);
foreach ($matches as $match) {
if ($match[0][1] >= $limit) {
break;
}
$limit += mb_strlen($match[0][0]) - 1;
}
// Handle all the html tags.
preg_match_all('/<[^>]+>([^<]*)/', $string, $matches, PREG_OFFSET_CAPTURE | PREG_SET_ORDER);
foreach ($matches as $match) {
if ($match[0][1] - $offset >= $limit) {
break;
}
$tag = mb_substr(strtok($match[0][0], " \t\n\r\v>"), 1);
if ($tag[0] != '/') {
$tags[] = $tag;
} elseif (end($tags) == mb_substr($tag, 1)) {
array_pop($tags);
}
$offset += $match[1][1] - $match[0][1];
}
$newString = mb_substr($string, 0, $limit = min(mb_strlen($string), $this->breakpoint->calculatePosition($string, $limit + $offset)));
$newString .= mb_strlen($string) > $limit ? $this->append : '';
$newString .= count($tags = array_reverse($tags)) ? '</' . implode('></', $tags) . '>' : '';
return $newString;
}
/**
* @param string $text
* @param int $charactersCount
* @return string
*/
public function truncate($text, $charactersCount)
{
if ($charactersCount < 0 || mb_strlen($text) <= $charactersCount) {
return $text;
}
$truncatedText = rtrim(mb_substr($text, 0, $this->breakpoint->calculatePosition($text, $charactersCount)));
return $truncatedText === $text ? $truncatedText : $truncatedText . $this->append;
}
