Software Público Brasileiro

<?php

/**
 * i-Educar - Sistema de gestão escolar
 *
 * Copyright (C) 2006  Prefeitura Municipal de Itajaí
 *                     <ctima@itajai.sc.gov.br>
 *
 * Este programa é software livre; você pode redistribuí-lo e/ou modificá-lo
 * sob os termos da Licença Pública Geral GNU conforme publicada pela Free
 * Software Foundation; tanto a versão 2 da Licença, como (a seu critério)
 * qualquer versão posterior.
 *
 * Este programa é distribuí­do na expectativa de que seja útil, porém, SEM
 * NENHUMA GARANTIA; nem mesmo a garantia implí­cita de COMERCIABILIDADE OU
 * ADEQUAÇÃO A UMA FINALIDADE ESPECÍFICA. Consulte a Licença Pública Geral
 * do GNU para mais detalhes.
 *
 * Você deve ter recebido uma cópia da Licença Pública Geral do GNU junto
 * com este programa; se não, escreva para a Free Software Foundation, Inc., no
 * endereço 59 Temple Street, Suite 330, Boston, MA 02111-1307 USA.
 *
 * @author    Lucas D'Avila <lucasdavila@portabilis.com.br>
 * @category  i-Educar
 * @license   @@license@@
 * @package   Portabilis
 * @since     Arquivo disponível desde a versão 1.1.0
 * @version   $Id$
 */

require_once 'lib/Portabilis/Array/Utils.php';

/**
 * Portabilis_String_Utils class.
 *
 * @author    Lucas D'Avila <lucasdavila@portabilis.com.br>
 * @category  i-Educar
 * @license   @@license@@
 * @package   Portabilis
 * @since     Classe disponível desde a versão 1.1.0
 * @version   @@package_version@@
 */
class Portabilis_String_Utils {

  // wrapper for Portabilis_Array_Utils::merge
  protected static function mergeOptions($options, $defaultOptions) {
    return Portabilis_Array_Utils::merge($options, $defaultOptions);
  }


  /* splits a string in a array, eg:

    $divisors = array('-', ' '); // or $divisors = '-';
    $options = array('limit' => 2, 'trim' => true);

    Portabilis_String_Utils::split($divisors, '123 - Some value', $options);
      => array([0] => '123', [1] => 'Some value');
   */
  public static function split($divisors, $string, $options = array()) {
    $result         = array($string);

    $defaultOptions = array('limit' => -1, 'trim' => true);
    $options        = self::mergeOptions($options, $defaultOptions);

    if (! is_array($divisors))
      $divisors = array($divisors);

    foreach ($divisors as $divisor) {
      if (is_numeric(strpos($string, $divisor))) {
        $result = split($divisor, $string, $options['limit']);
        break;
      }
    }

    if ($options['trim'])
      $result = Portabilis_Array_Utils::trim($result);

    return $result;
  }


  /* scapes a string, adding backslashes before characters that need to be quoted,
     this method is useful to scape values to be inserted via database queries. */
  public static function escape($str) {
    return addslashes($str);
  }


  /* encodes latin1 strings to utf-8,
     this method is useful to return latin1 strings (with accents) stored in db, in json api's.
  */
  public static function toUtf8($str, $options = array()) {
    $defaultOptions = array('transform' => false, 'escape' => false, 'convert_html_special_chars' => false);
    $options        = self::mergeOptions($options, $defaultOptions);

    if ($options['escape'])
      $str = self::escape($str);

    if ($options['transform'])
      $str = ucwords(mb_strtolower($str));


    $str = utf8_encode($str);

    if ($options['convert_html_special_chars'])
      $str = htmlspecialchars($str, ENT_QUOTES, 'UTF-8');

    return $str;
  }


  /* encodes utf-8 strings to latin1,
     this method is useful to store utf-8 string (with accents) get from json api's, in latin1 db's.
  */
  public static function toLatin1($str, $options = array()) {
    $defaultOptions = array('transform' => false, 'escape' => true, 'convert_html_special_chars' => false);
    $options        = self::mergeOptions($options, $defaultOptions);

    if ($options['escape'])
      $str = self::escape($str);

    if ($options['transform'])
      $str = ucwords(mb_strtolower($str));


    // apenas converte para latin1, strings utf-8
    // impedindo assim, converter para latin1 strings que já sejam latin1

    if (Portabilis_String_Utils::encoding($str) == 'UTF-8')
      $str = utf8_decode($str);

    if ($options['convert_html_special_chars'])
      $str = htmlspecialchars($str, ENT_QUOTES, 'ISO-8859-1');

    return $str;
  }

  public static function unaccent($str) {
    $fromEncoding = Portabilis_String_Utils::encoding($str);
    return iconv($fromEncoding, 'US-ASCII//TRANSLIT', $str);
  }


  public static function encoding($str) {
    return mb_detect_encoding($str, 'UTF-8, ISO-8859-1', $strict = true);
  }

  public static function camelize($str) {
    return str_replace(' ', '', ucwords(str_replace('_', ' ', $str)));
  }


  public static function underscore($str) {
    $words = preg_split('/(?=[A-Z])/', $str, -1, PREG_SPLIT_NO_EMPTY);
    return strtolower(implode('_', $words));
  }


  public static function humanize($str) {
    $robotWords = array('_id', 'ref_cod_', 'ref_ref_cod_');

    foreach ($robotWords as $word)
      $str = str_replace($word, '', $str);

    return str_replace('_', ' ', ucwords($str));
  }
}