LTRIM()
 Remove os espaços em branco à esquerda de uma cadeia de caracteres
------------------------------------------------------------------------------

 Sintaxe

     LTRIM(<cString>) --> cStringResult

 Argumentos

     <cString> é a cadeia de caracteres a ser copiada sem os espaços em
     branco à esquerda.

 Retorno

     LTRIM() retorna uma cópia de <cString>, sendo que os espaços em branco
     à esquerda foram removidos.  Caso <cString> seja uma cadeia de
     caracteres nula ("") ou toda composta de espaços em branco, LTRIM()
     retorna uma cadeia de caracteres nula ("").

 Descriçao

     LTRIM() é uma funçao de tratamento de caracteres utilizada para
     formatar cadeias de caracteres que possuam espaços em branco à
     esquerda.  Pode ser o caso de, por exemplo, números convertidos para
     cadeias de caracteres através da funçao STR().

     LTRIM() é relacionada a RTRIM(), a qual remove espaços em branco à
     direita, e a ALLTRIM(), que remove espaços tanto à esquerda quanto à
     direita.  O contrário de ALLTRIM(), LTRIM(), e RTRIM() sao as funçoes
     PADC(), PADR(), e PADL(), as quais centralizam, alinham à direita, ou
     alinham à esquerda as cadeias de caracteres, através da inserçao de
     caracteres de preenchimento.

 Exemplos

     Os exemplos a seguir ilustram LTRIM() utilizada em combinaçao com
     várias outras funçoes:

     nNumber = 18
     ? STR(nNumber)                      // Resulta:         18
     ? LEN(STR(nNumber))                 // Resulta: 10
     ? LTRIM(STR(nNumber))               // Resulta: 18
     ? LEN(LTRIM(STR(nNumber)))          // Resulta: 2

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: ALLTRIM() PAD() RTRIM() STR() SUBSTR()