LEFT()
 Extrai um substring que começa com o primeiro caractere em um string
------------------------------------------------------------------------------

 Sintaxe

     LEFT(<cString>, <nCont>) --> cSubString

 Argumentos

     <cString> é uma cadeia de caracteres da qual serao extraidos
     caracteres.  O tamanho máximo de <cString> é 65.535 (64K) bytes.

     <nCont> é a quantidade de caracteres a serem extraidos.

 Retorno

     LEFT() retorna os caracteres <nCont> mais à esquerda de <cString> na
     forma de uma cadeia de caracteres.  Caso <nCont> seja negativo ou zero,
     LEFT() retorna uma cadeia de caracteres nula ("").  Se <nCont> for
     maior do que o tamanho da cadeia de caracteres, LEFT() retorna toda a
     cadeia de caracteres.

 Descriçao

     LEFT() é uma funçao de tratamento de caracteres que retorna um
     substring de uma cadeia de caracteres especificada.  É o mesmo que
     SUBSTR(<cString>, 1, <nCont>).  LEFT() também é semelhante a RIGHT(),
     funçao que retorna um substring que começa com o último caractere em um
     string.

     LEFT(), RIGHT(), e SUBSTR() sao frequentemente utilizadas juntamente
     com ambas as funçoes AT() e RAT() para localizar a primeira e/ou a
     última posiçao de um substring antes que o mesmo seja extraido.

 Exemplos

       Este exemplo extrai os três primeiros caracteres da esquerda
        de um string:

        ? LEFT("ABCDEF", 3)                // Resulta: ABC

       Este exemplo extrai um substring a partir do início de um
        string até a primeira ocorrência de uma vírgula:

        LOCAL cName := "James, William"
        ? LEFT(cName, AT(",", cName) - 1)  // Resulta: James

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

See Also: AT() LTRIM() RAT() RIGHT() RTRIM() STUFF() SUBSTR()