voku / Stringy

   *

   * @return static  Object with the first character of $str being upper case

   */

  public function upperCaseFirst()

  {

    $first = UTF8::substr($this->str, 0, 1, $this->encoding);

    $rest = UTF8::substr(

        $this->str,

        1,

        $this->length() - 1,

        $this->encoding

    );

    $str = UTF8::strtoupper($first, $this->encoding) . $rest;

    return static::create($str, $this->encoding);

  }

  /**

   * Returns the index of the last occurrence of $needle in the string,

   *

   * @return static  Object with the first character of $str being lower case

   */

  public function lowerCaseFirst()

  {

    $first = UTF8::substr($this->str, 0, 1, $this->encoding);

    $rest = UTF8::substr($this->str, 1, $this->length() - 1, $this->encoding);

    $str = UTF8::strtolower($first, $this->encoding) . $rest;

    return static::create($str, $this->encoding);

  }

  /**

   * Shorten the string after $length, but also after the next word.

   *

   * @param int    $length

   * @param string $strAddOn