//======================================
//Nome: GenJsStrPadding
//Linguagem: JavaScript
//Descrição: Essa função recebe uma string e concatena um caracter informado à esquerda ou à direita até a string resultante ter um determinado tamanho
//
//Autor: Equipe Biblioteca Marlin
//
//Data: 12/06/2002
//
//Parâmetros de entrada:
//	- pStrFormattedR	=> String de retorno
//	- pStrToPad			=> String de entrada
//	- pStrPadCarac		=> Caracter para completar na string
//	- pIntTam			=> Tamanho da string final (opcional)
//	- pIntSideToPad		=> Extremidade em que o caracter será acrescentado (opcional)
//	- 
//Retorno: A string resultante
//
//Informações adicionais:
//	+ Funções:
//		- FncJsVerifyIntParameter(pParam, pIntDefValue)
//		-
//	+ Includes:
//		-
//	+ Objetos:
//		-
//	+ Stored Procedures:
//		-
//Historico Alteracao:
//	- 12/06/2002 Thyago Consort
//	-
//======================================
function GenJsStrPadding(pStrFormattedR, pStrToPad, pStrPadCarac, pIntTam, pIntSideToPad) {
	var lStrAux;
	var lIntConcat;
	var lStrFormatted;
	var p = new Array();
	
	lStrFormatted = pStrToPad;
        pStrFormattedR[0] = lStrFormatted;
	
	//Verificando parâmetros de entrada e valores default
	p[0] = pIntTam;
	if (!FncJsVerifyIntParameter(p,0)) {
 		return -11;
        }
	pIntTam = p[0];

	p[0] = pIntSideToPad;
	if (!FncJsVerifyIntParameter(p,0)) {
		return -11;
        }
	pIntSideToPad = p[0];
	
	if ((pStrPadCarac.length > 0) && (pIntTam > pStrToPad.length)) {
		lStrAux = '';
		for (lIntConcat = 0; lIntConcat < (pIntTam - lStrFormatted.length); lIntConcat++)
			lStrAux = lStrAux + pStrPadCarac.substr(0,1);
		
		switch (pIntSideToPad) {
		case 0: //Concatenar na extremidade esquerda
			lStrFormatted = lStrAux + lStrFormatted;
			break;
		
		case 1: //Concatenar na extremidade direita
			lStrFormatted = lStrFormatted + lStrAux;
			break;
					
		default:
			return -11;
		}
	}
	
        pStrFormattedR[0] = lStrFormatted;
	
	return 0;
}