/*******************************************************************************
 * Autor: Adriano Pamplona
 * Data de criação: 01/05/2007
 * Versão: 1.0.0
 *******************************************************************************
 * Objetivo: 
 *		Objeto para manipulação de string's.
 *******************************************************************************
 * Dependências: 
 *		UtilObjeto		(util-objeto.js)
 *		UtilNumero		(util-numero.js)
 *******************************************************************************
 * métodos do objeto:
 *		isStringsIguais(string0, string1)
 *		isStringContidaEm(string, localizar)
 *		isLetraDefinidaContidaEm(string, localizar)
 *		isLetraContidaEm(string)
 *		substituirString(string, localizar, novaString)
 *		substituirStringNoIndice(string, indice, novaString)
 *		inserirStringNaEsquerda(string, novaString, quantidade, total)
 *		inserirStringNaDireita(string, novaString, quantidade, total)
 *		removerAcentuacao(string)
 *		removerCaracteresEspeciais(string)
 *		removerString(string, localizar)
 *		removerStringsDaEsquerda(string, localizar)
 *		removerStringsDaDireita(string, localizar)
 *		removerLetras(string)
 *		removerLetrasComExcecao(string, excecao)
 *		getTamanho(string)
 *		separarStringPor(string, separador)
 *		trim(string)
 *		maiuscula(string)
 *		minúscula(string)
 *		converterCodigoHTMLparaASCI(string)
 *******************************************************************************
 * Exemplo:
 * 		var objeto = new UtilString();
 *		alert(objeto.isStringsIguais("x", "x"));
 *******************************************************************************
 */
 
UtilString.prototype = new UtilNumero();

function UtilString() {
	var CARACTERES_ESPECIAIS = "<>!@#$%¨&§";
	
	/**
	 * Retorna true se as strings forem iguais.
	 *
	 * @string0
	 * @string1 
	 */
	this.isStringsIguais = function(string0, string1) {
		return (string0 == string1);
	}
	
	/**
	 * Retorna true se a string localizada exitir na string definida.
	 *
	 * @string String que sofrerá a localização.
	 * @localizar String que será localizada.
	 */
	this.isStringContidaEm = function(string, localizar) {
		var res = false;

		if (!this.isStringVazia(string) && !this.isStringVazia(localizar)) {
			string = new String(string);
			localizar = new RegExp(localizar, "g");
			res = string.search(localizar) != -1
		}
		
		return res;
	}
	
	/**
	 * Retorna true se a string possuir alguma letra definida no parâmetro localizar.
	 *
	 * @string String que será verificada
	 * @localizar Lista de strings
	 */
	this.isLetraDefinidaContidaEm = function(string, localizar) {
		var res = false;

		if (!this.isStringVazia(string) && !this.isStringVazia(localizar)) {
			string = new String(string);
			localizar = this.separarStringPor(localizar, "|");
			localizar = "["+ localizar +"]";
			localizar = new RegExp(localizar, "g");
			res = string.search(localizar) != -1
		}
		
		return res;
	}
	
	/**
	 * Retorna true se existir alguma letra na string passada por parâmetro.
	 *
	 * string String validada.
	 */
	this.isLetraContidaEm = function(string) {
		var res = false;
		
		if (!this.isStringVazia(string)) {
			res = this.isStringContidaEm(string, "[^0-9]");
		}
	
		return res;
	}
	
	/**
	 * Substitui a string localizada caso ela exista.
	 *
	 * @string String que será alterada. 
	 * @localizar String que será localizada.
	 * @novaString Nova string.
	 */
	this.substituirString = function(string, localizar, novaString) {
		if (!this.isStringVazia(string) && !this.isStringVazia(localizar)) {
			string = new String(string);
			localizar = new RegExp(localizar, "g");
			string = string.replace(localizar, novaString);	
		}
		
		return string;
	}
	
	/**
	 * Substitui a string do índice determinado por uma nova String.
	 *
	 * @string String que será alterada.  
	 * @indice Índice da String
	 * @novaString  Nova string.
	 */
	this.substituirStringNoIndice = function(string, indice, novaString) {
		if (!this.isStringVazia(string) && !this.isStringVazia(indice)) {
			if (this.isStringVazia(novaString)) {
				novaString = "";
			}
			indice =  this.novoInteiro(indice);
			var prefixo = string.substring(0, indice);
			var sufixo = string.substring(indice+1, string.length);

			string = prefixo + novaString + sufixo;
		}
		
		return string;
	}
	
	/**
	 * Insere uma cadeia de strings à esquerda.
	 *
	 * @string String que será usada para inserir os novos valores.
	 * @novaString String que será adicionada.
	 * @quantidade Quantidade de ocorrências.
	 * @total Total de ocorrências permitida.
	 */
	this.inserirStringNaEsquerda = function(string, novaString, quantidade, total) {
		if (!this.isStringVazia(novaString)) {
			if (!this.isReferencia(string)) {
				string = "";
			}
			var inicio = string.length;
			var fim = inicio + this.novoInteiro(quantidade);
			if (!this.isStringVazia(total)) {
				fim = this.novoInteiro(total);
			}
			
			for (var tamanho = inicio; tamanho < fim; tamanho = string.length) {
				string = novaString + string;
			}
		}
		return string;
	}
	
	/**
	 * Insere uma cadeia de strings à direita.
	 *
	 * @string String que será usada para inserir os novos valores.
	 * @novaString String que será adicionada.
	 * @quantidade Quantidade de ocorrências.
	 * @total Total de ocorrências permitida.
	 */
	this.inserirStringNaDireita = function(string, novaString, quantidade, total) {
		if (!this.isStringVazia(novaString)) {
			var inicio = string.length;
			var fim = inicio + this.novoInteiro(quantidade);
			if (!isStringVazia(total)) {
				fim = this.novoInteiro(total);
			}
			
			for (var tamanho = inicio; tamanho < fim; tamanho = string.length) {
				string += novaString;
			}
		}
		return string;
	}
	
	/**
	 * Remove os caracteres acentuados de uma string.
	 *
	 * @string String que será usada para remover os caractes acentuados.
	 */
	this.removerAcentuacao = function(string) {
		if (!this.isStringVazia(string)) {
			string = this.substituirString(string, "[ÁÀÂÃ]", "A");
			string = this.substituirString(string, "[áàâãª]", "a");
			string = this.substituirString(string, "[ÉÈÊ]", "E");
			string = this.substituirString(string, "[éèê]", "e");
			string = this.substituirString(string, "[ÍÌÎÏ]", "I");
			string = this.substituirString(string, "[íìîï]", "i");
			string = this.substituirString(string, "[ÓÒÔÕÖ]", "O");
			string = this.substituirString(string, "[óòôõºö]", "o");
			string = this.substituirString(string, "[ÚÙÛÜ]", "U");
			string = this.substituirString(string, "[úùûü]", "u");
			string = this.substituirString(string, "[Ç]", "C");
			string = this.substituirString(string, "[ç]", "c");
			string = this.substituirString(string, "[~\\d^´`]", "");
			string = this.substituirString(string, "[¨]", "");
		}
		
		return string;
	}

	/**
	 * Remove os caracteres especiais de uma string.
	 *
	 * @string String que será usada para remover os caractes acentuados.
	 */
	this.removerCaracteresEspeciais = function(string) {
		if (!this.isStringVazia(string)) {
			string = this.substituirString(string, "["+ CARACTERES_ESPECIAIS +"]", "");
		}
		
		return string;
	}
	
	/**
	 * Remove uma string.
	 *
	 * @string String que sofrerá a remoção dos caracteres.
	 * @localizar String que será removida.
	 */
	this.removerString = function(string, localizar) {
		
		if (!this.isStringVazia(string) && !this.isStringVazia(localizar)) {
			string = this.substituirString(string, localizar, "");
		}
		return string;
	}
	
	/**
	 * Remove as string's à esquerda.
	 *
	 * @string String que sofrerá a remoção dos caracteres.
	 * @localizar String que será removida.
	 */
	this.removerStringsDaEsquerda = function(string, localizar) {
		if (!this.isStringVazia(string)) {
			while (string.charAt(0) == localizar) {
				string = string.substring(1);
			}
		}
		return string;
	}

	/**
	 * Remove as string's à direita.
	 *
	 * @string String que sofrerá a remoção dos caracteres.
	 * @localizar String que será removida.
	 */
	this.removerStringsDaDireita = function(string, localizar) {
		if (!this.isStringVazia(string)) {
			while (string.charAt(string.length-1) == localizar) {
				string = string.substring(0, string.length-1);
			}
		}
		return string;
	}
	
	/**
	 * Remove as letras da string, restando somente os números.
	 * 
	 * @string String que sofrerá a remoção. 
	 */
	this.removerLetras = function(string) {
		var res = null;
		
		if (!this.isStringVazia(string)) {
			res = string.replace(/[^0-9]/g, "");
		}
		return res;
	}
	
	/**
	 * Remove todos os caracteres da string, exceto os determinados por parâmetro.
	 *
	 * @string String que será alterada
	 * @excecao Strings que não serão removidas.
	 */
	this.removerLetrasComExcecao = function(string, excecao) {
		
		if (!this.isStringVazia(string) && !this.isStringVazia(excecao)) {
			string = this.substituirString(string, "[^"+ excecao +"]", "");
		}
		return string;
	}

	/**
	 * Retorna o tamanho da string.
	 * 
	 * @string String
	 */
	this.getTamanho = function(string) {
		return (this.isStringVazia(string) ? 0: string.length);
	}
	
	/**
	 * Adiciona um separador na string.
	 *
	 * @string String que será alterada.
	 * @separador Separador que será usado.
	 */
	this.separarStringPor = function(string, separador) {
		
		if (!this.isStringVazia(string) && !this.isStringVazia(separador)) {
			var nova = "";
			for (var indice = 0; indice < this.getTamanho(string); indice++) {
				nova += string.charAt(indice);
				if (indice < (this.getTamanho(string) - 1)) {
					nova += separador;
				}
			}
			string = nova;
		}
		return string;
	}
	
	/**
	 * Função responsável em remover os espaços iniciais e finais de uma string.
	 *
	 * @string String que será alterada.
	 */
	this.trim = function(string) {

		if (!this.isStringVazia(string)) {
			string = string.replace(/^\s+|\s+$/g, "")
		}
		
		return string;
	}

	/**
	 * Converte todas as letras da string em maiúscula.
	 *
	 * @string String que será alterada.
	 */
	this.maiuscula = function(string) {

		if (!this.isStringVazia(string)) {
			string = string.toLocaleUpperCase();
		}
		
		return string;
	}

	/**
	 * Converte todas as letras da string em minúscula.
	 *
	 * @string String que será alterada.
	 */
	this.minuscula = function(string) {

		if (!this.isStringVazia(string)) {
			string = string.toLocaleLowerCase();
		}
		
		return string;
	}
	
	/**
	 * Converte os códigos HTML de uma string em ASCI.
	 * Ex: &aacute; para "á"
	 * 
	 * @string String que será convertida.
	 */
	this.converterCodigoHTMLparaASCI = function(string) {
		var htmlCode = new Array('&aacute;', '&acirc;', '&acirc;', '&acute;', '&aelig;', '&agrave;', '&amp;', '&aring;', '&atilde;', '&auml;', '&brvbar;', '&ccedil;', '&cedil;', '&cent;', '&copy;', '&curren;', '&deg;', '&divide;', '&eacute;', '&ecirc;', '&egrave;', '&eth;', '&euml;', '&frac12;', '&frac14;', '&frac34;', '&iacute;', '&icirc;', '&iexcl;', '&igrave;', '&iquest;', '&iuml;', '&laquo;', '&ldquo;', '&lsquo;', '&macr;', '&mdash;', '&micro;', '&middot;', '&nbsp;', '&ndash;', '&not;', '&ntilde;', '&oacute;', '&ocirc;', '&ograve;', '&ordf;', '&ordm;', '&oslash;', '&otilde;', '&ouml;', '&para;', '&plusmn;', '&pound;', '&quot;', '&raquo;', '&rdquo;', '&reg;', '&rsquo;', '&sect;', '&shy;', '&sup1;', '&sup2;', '&sup3;', '&szlig;', '&thorn;', '&times;', '&uacute;', '&ucirc;', '&ugrave;', '&uml;', '&uuml;', '&yacute;', '&yen;');
		var charCode = new Array(225, 226, 226, 180, 230, 224, 38, 229, 227, 228, 124, 231, 184, 162, 169, 63, 176, 247, 233, 234, 232, 60, 235, 49, 49, 51, 237, 238, 161, 236, 191, 239, 171, 32, 32, 175, 32, 181, 183, 160, 32, 172, 241, 243, 244, 242, 170, 186, 248, 245, 246, 182, 177, 163, 34, 187, 32, 174, 32, 167, 45, 49, 50, 51, 223, 60, 42, 250, 251, 249, 168, 252, 121, 165);
		var stripped = string.replace(/(<([^>]+)>)/ig,""); 
		stripped = stripped.replace(/\t/g," "); 
		stripped = stripped.replace(/(  )*/g,"");
		for(x=0;x<htmlCode.length;x++) {
			var reg = new RegExp(htmlCode[x], "ig");
			stripped = stripped.replace(reg,String.fromCharCode(charCode[x]));
		}
		for(x=32;x<=127;x++) {
			var reg = new RegExp('&#'+x+';', "ig"); 
			stripped = stripped.replace(reg,String.fromCharCode(x));
		}
		
		return stripped;
	}
	
/*******************************************************************************
 * Funções privadas do objeto.
 ******************************************************************************/

}