* @license https://raw.github.com/soloproyectos/core/master/LICENSE BSD 2-Clause License * @link https://github.com/soloproyectos/core */ namespace com\soloproyectos\common\text; /** * Class TextHelper. * * @category Text * @package Text * @author Gonzalo Chumillas * @license https://raw.github.com/soloproyectos/core/master/LICENSE BSD 2-Clause License * @link https://github.com/soloproyectos/core */ class TextHelper { /** * Is the string empty? * *

This function checks if a given variable is an empty string. * For example:

* *

// empty string examples
     * TextHelper::isEmpty('');         // returns true
     * TextHelper::isEmpty(null);       // returns true
     * TextHelper::isEmpty('testing');  // returns false
     * TextHelper::isEmpty(0);          // returns false (as 0 is not a string)
     *

* * @param string $str A string * * @return boolean */ public static function isEmpty($str) { return $str === null || is_string($str) && strlen($str) == 0; } /** * Concatenates strings. * *

This function concatenates several strings into a new one, using the * $glue parameter. It ignores empty strings. For example:

* *

     * // prints 'John, Maria, Mohamad'
     * echo TextHelper::concat(', ', 'John', '', 'Maria', null, 'Mohamad');
     * // prints 'John'
     * echo TextHelper::concat(', ', 'John');
     * // in this case we are using an array as second argument
     * echo TextHelper::concat('|', array('one', 'two', 'three'));
     *

* * @param string $glue Separator * * @return string */ public static function concat($glue) { $ret = ""; $args = array(); $len = func_num_args(); for ($i = 1; $i < $len; $i++) { $value = func_get_arg($i); $values = is_array($value)? array_values($value) : array($value); $args = array_merge($args, $values); } foreach ($args as $arg) { if (TextHelper::isempty($arg)) { continue; } if (strlen($ret) > 0) { $ret .= $glue; } $ret .= $arg; } return $ret; } /** * Removes left spaces from a multiline string. * * This function removes left spaces from a multiline string, so the first line * starts at the first column. It would be the equivalent to 'align to left' in * a text editor. * * @param string $str Multiline string * * @return string */ public static function trimText($str) { $ret = ""; $str = preg_replace("/\t/", " ", $str); $lines = explode("\n", $str); $len = count($lines); // start index. // ignores initial empty lines. $i0 = 0; for ($i = 0; $i < $len; $i++) { $line = $lines[$i]; $trimLine = trim($line); if (strlen($trimLine) > 0) { $i0 = $i; break; } } // final index. // ignores final empty lines. $i1 = count($lines) - 1; for ($i = $len - 1; $i >= 0; $i--) { $line = $lines[$i]; $trimLine = trim($line); if (strlen($trimLine) > 0) { $i1 = $i; break; } } // calculates spaces to remove $spaces = PHP_INT_MAX; for ($i = $i0; $i <= $i1; $i++) { $line = $lines[$i]; $leftTrimLine = ltrim($line); $spaces = min($spaces, strlen($line) - strlen($leftTrimLine)); } // removes left spaces for ($i = $i0; $i <= $i1; $i++) { $line = $lines[$i]; $ret = TextHelper::concat("\n", $ret, substr($line, $spaces)); } return $ret; } }