voku / portable-utf8

   *

   * @return string <p>The string with unwanted characters stripped from the left.</p>

   */

  public static function ltrim(string $str = '', $chars = INF): string

  {

    if (!isset($str[0])) {

      return '';

    }

    // Info: http://nadeausoftware.com/articles/2007/9/php_tip_how_strip_punctuation_characters_web_page#Unicodecharactercategories

    if ($chars === INF || !$chars) {

      $pattern = "^[\pZ\pC]+";

    } else {

      $chars = \preg_quote($chars, '/');

      $pattern = "^[$chars]+";

    }

    return self::regexReplace($str, $pattern, '', '', '/');

  }

  /**

   * Returns true if $str matches the supplied pattern, false otherwise.

   *

   * @return string <p>The string with unwanted characters stripped from the right.</p>

   */

  public static function rtrim(string $str = '', $chars = INF): string

  {

    if (!isset($str[0])) {

      return '';

    }

    // Info: http://nadeausoftware.com/articles/2007/9/php_tip_how_strip_punctuation_characters_web_page#Unicodecharactercategories

    if ($chars === INF || !$chars) {

      $pattern = "[\pZ\pC]+\$";

    } else {

      $chars = \preg_quote($chars, '/');

      $pattern = "[$chars]+\$";

    }

    return self::regexReplace($str, $pattern, '', '', '/');

  }

  /**

   * rxClass

   *

   * @return string <p>The trimmed string.</p>

   */

  public static function trim(string $str = '', $chars = INF): string

  {

    if (!isset($str[0])) {

      return '';

    }

    // Info: http://nadeausoftware.com/articles/2007/9/php_tip_how_strip_punctuation_characters_web_page#Unicodecharactercategories

    if ($chars === INF || !$chars) {

      $pattern = "^[\pZ\pC]+|[\pZ\pC]+\$";

    } else {

      $chars = \preg_quote($chars, '/');

      $pattern = "^[$chars]+|[$chars]+\$";

    }

    return self::regexReplace($str, $pattern, '', '', '/');

  }

  /**

   * Makes string's first char uppercase.