text = $text;
}
/**
* Read tab data (tab-separated data).
*
* @return array
*/
public function readTab() {
$pieces = explode("\n", $this->text);
$result = [];
foreach ($pieces as $piece) {
$tmp = explode("\t", trim($piece, "\r\n"));
$result[] = $tmp;
}
return $result;
}
/**
* Read with a specific pattern.
*
* E.g.: '%s,%s,%s'
*
* @param string $pattern
* @return array
*/
public function readWithPattern($pattern) {
$pieces = explode("\n", $this->text);
$result = [];
foreach ($pieces as $piece) {
$result[] = sscanf(trim($piece, "\r\n"), $pattern);
}
return $result;
}
/**
* Count words in a text.
*
* //TODO use str_word_count() instead!!!
*
* @param string $text
* @return int
*/
public static function numberOfWords($text) {
$count = 0;
$words = explode(' ', $text);
foreach ($words as $word) {
$word = trim($word);
if (!empty($word)) {
$count++;
}
}
return $count;
}
/**
* Count chars in a text.
*
* Options:
* - 'whitespace': If whitespace should be counted, as well, defaults to false
*
* @param string $text
* @return int
*/
public static function numberOfChars($text, $options = []) {
$text = str_replace(["\r", "\n", "\t", ' '], '', $text);
$count = mb_strlen($text);
return $count;
}
/**
* Return an abbreviated string, with characters in the middle of the
* excessively long string replaced by $ending.
*
* @param string $text The original string.
* @param int $length The length at which to abbreviate.
* @return string The abbreviated string, if longer than $length.
*/
public static function abbreviate($text, $length = 20, $ending = '...') {
if (mb_strlen($text) <= $length) {
return $text;
}
return rtrim(mb_substr($text, 0, round(($length - 3) / 2))) . $ending . ltrim(mb_substr($text, (($length - 3) / 2) * -1));
}
/**
* TextLib::convertToOrd()
*
* @param string $str
* @param string $separator
* @return string
*/
public function convertToOrd($str = null, $separator = '-') {
/*
if (!class_exists('UnicodeLib')) {
App::uses('UnicodeLib', 'Tools.Lib');
}
*/
if ($str === null) {
$str = $this->text;
}
$chars = preg_split('//', $str, -1);
$res = [];
foreach ($chars as $char) {
//$res[] = UnicodeLib::ord($char);
$res[] = ord($char);
}
return implode($separator, $res);
}
public static function convertToOrdTable($str, $maxCols = 20) {
$res = '';
$r = ['chr' => [], 'ord' => []];
$chars = preg_split('//', $str, -1);
$count = 0;
foreach ($chars as $key => $char) {
if ($maxCols && $maxCols < $count || $key === count($chars) - 1) {
$res .= '| ' . implode(' | ', $r['chr']) . ' | ';
$res .= '
|---|
';
$res .= '';
$res .= '| ' . implode(' | ', $r['ord']) . ' |
';
$count = 0;
$r = ['chr' => [], 'ord' => []];
}
$count++;
//$res[] = UnicodeLib::ord($char);
$r['ord'][] = ord($char);
$r['chr'][] = $char;
}
$res .= '
';
return $res;
}
/**
* Explode a string of given tags into an array.
*/
public function explodeTags($tags) {
// This regexp allows the following types of user input:
// this, "somecompany, llc", "and ""this"" w,o.rks", foo bar
$regexp = '%(?:^|,\ *)("(?>[^"]*)(?>""[^"]* )*"|(?: [^",]*))%x';
preg_match_all($regexp, $tags, $matches);
$typedTags = array_unique($matches[1]);
$tags = [];
foreach ($typedTags as $tag) {
// If a user has escaped a term (to demonstrate that it is a group,
// or includes a comma or quote character), we remove the escape
// formatting so to save the term into the database as the user intends.
$tag = trim(str_replace('""', '"', preg_replace('/^"(.*)"$/', '\1', $tag)));
if ($tag) {
$tags[] = $tag;
}
}
return $tags;
}
/**
* Implode an array of tags into a string.
*/
public function implodeTags($tags) {
$encodedTags = [];
foreach ($tags as $tag) {
// Commas and quotes in tag names are special cases, so encode them.
if (strpos($tag, ',') !== false || strpos($tag, '"') !== false) {
$tag = '"' . str_replace('"', '""', $tag) . '"';
}
$encodedTags[] = $tag;
}
return implode(', ', $encodedTags);
}
/**
* Prevents [widow words](http://www.shauninman.com/archive/2006/08/22/widont_wordpress_plugin)
* by inserting a non-breaking space between the last two words.
*
* echo Text::widont($text);
*
* @param string text to remove widows from
* @return string
*/
public function widont($str = null) {
if ($str === null) {
$str = $this->text;
}
$str = rtrim($str);
$space = strrpos($str, ' ');
if ($space !== false) {
$str = substr($str, 0, $space) . ' ' . substr($str, $space + 1);
}
return $str;
}
/* text object specific */
/**
* Extract words
*
* @param options
* - min_char, max_char, case_sensititive, ...
* @return array
*/
public function words($options = []) {
if (true || !$this->xrWord) {
$text = str_replace([PHP_EOL, NL, TB], ' ', $this->text);
$pieces = explode(' ', $text);
$pieces = array_unique($pieces);
// strip chars like . or ,
foreach ($pieces as $key => $piece) {
if (empty($options['case_sensitive'])) {
$piece = mb_strtolower($piece);
}
$search = [',', '.', ';', ':', '#', '', '(', ')', '{', '}', '[', ']', '$', '%', '"', '!', '?', '<', '>', '=', '/'];
$search = array_merge($search, [1, 2, 3, 4, 5, 6, 7, 8, 9, 0]);
$piece = str_replace($search, '', $piece);
$piece = trim($piece);
if (empty($piece) || !empty($options['min_char']) && mb_strlen($piece) < $options['min_char'] || !empty($options['max_char']) && mb_strlen($piece) > $options['max_char']) {
unset($pieces[$key]);
} else {
$pieces[$key] = $piece;
}
}
$pieces = array_unique($pieces);
//$this->xrWord = $pieces;
}
return $pieces;
}
/**
* Limit the number of words in a string.
*
*
* // Returns "This is a..."
* echo TextExt::maxWords('This is a sentence.', 3);
*
* // Limit the number of words and append a custom ending
* echo Str::words('This is a sentence.', 3, '---');
*
*
* @param string $value
* @param int $words
* @param array $options
* - ellipsis
* - html
* @return string
*/
public static function maxWords($value, $words = 100, $options = []) {
$defaults = [
'ellipsis' => '...'
];
if (!empty($options['html']) && Configure::read('App.encoding') === 'UTF-8') {
$defaults['ellipsis'] = "\xe2\x80\xa6";
}
$options += $defaults;
if (trim($value) === '') {
return '';
}
preg_match('/^\s*+(?:\S++\s*+){1,' . $words . '}/u', $value, $matches);
$end = $options['ellipsis'];
if (mb_strlen($value) === mb_strlen($matches[0])) {
$end = '';
}
return rtrim($matches[0]) . $end;
}
/**
* High ASCII to Entities
*
* Converts High ascii text and MS Word special characters to character entities
*
* @param string
* @return string
*/
public function asciiToEntities($str) {
$count = 1;
$out = '';
$temp = [];
for ($i = 0, $s = strlen($str); $i < $s; $i++) {
$ordinal = ord($str[$i]);
if ($ordinal < 128) {
/*
If the $temp array has a value but we have moved on, then it seems only
fair that we output that entity and restart $temp before continuing. -Paul
*/
if (count($temp) == 1) {
$out .= '&#' . array_shift($temp) . ';';
$count = 1;
}
$out .= $str[$i];
} else {
if (count($temp) == 0) {
$count = ($ordinal < 224) ? 2 : 3;
}
$temp[] = $ordinal;
if (count($temp) == $count) {
$number = ($count == 3) ? (($temp['0'] % 16) * 4096) + (($temp['1'] % 64) * 64) + ($temp['2'] %
64) : (($temp['0'] % 32) * 64) + ($temp['1'] % 64);
$out .= '&#' . $number . ';';
$count = 1;
$temp = [];
}
}
}
return $out;
}
/**
* Entities to ASCII
*
* Converts character entities back to ASCII
*
* @param string
* @param bool
* @return string
*/
public function EntitiesToAscii($str, $all = true) {
if (preg_match_all('/\&#(\d+)\;/', $str, $matches)) {
for ($i = 0, $s = count($matches['0']); $i < $s; $i++) {
$digits = $matches['1'][$i];
$out = '';
if ($digits < 128) {
$out .= chr($digits);
} elseif ($digits < 2048) {
$out .= chr(192 + (($digits - ($digits % 64)) / 64));
$out .= chr(128 + ($digits % 64));
} else {
$out .= chr(224 + (($digits - ($digits % 4096)) / 4096));
$out .= chr(128 + ((($digits % 4096) - ($digits % 64)) / 64));
$out .= chr(128 + ($digits % 64));
}
$str = str_replace($matches['0'][$i], $out, $str);
}
}
if ($all) {
$str = str_replace(["&", "<", ">", """, "'", "-"],
["&", "<", ">", "\"", "'", "-"], $str);
}
return $str;
}
/**
* Reduce Double Slashes
*
* Converts double slashes in a string to a single slash,
* except those found in http://
*
* http://www.some-site.com//index.php
*
* becomes:
*
* http://www.some-site.com/index.php
*
* @param string
* @return string
*/
public function reduce_double_slashes($str) {
return preg_replace("#([^:])//+#", "\\1/", $str);
}
// ------------------------------------------------------------------------
/**
* Reduce Multiples
*
* Reduces multiple instances of a particular character. Example:
*
* Fred, Bill,, Joe, Jimmy
*
* becomes:
*
* Fred, Bill, Joe, Jimmy
*
* @param string
* @param string the character you wish to reduce
* @param bool TRUE/FALSE - whether to trim the character from the beginning/end
* @return string
*/
public function reduce_multiples($str, $character = ',', $trim = false) {
$str = preg_replace('#' . preg_quote($character, '#') . '{2,}#', $character, $str);
if ($trim === true) {
$str = trim($str, $character);
}
return $str;
}
}