Retorna um determinado número da caracteres à esquerda de uma string.

Sintaxe

Left( < cText >, < nCount > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cText

caractere

Indica o texto que será tratado.

X

 

nCount

numérico

Indica o número de caracteres à esquerda a serem retornados.

X

 

Retorno

Nome

Tipo

Descrição

cRet

caractere

Retorna uma cópia da string, iniciando a partir do caractere final da string (último caractere da esquerda), considerando o número de caracteres especificado no segundo parâmetro.

Observações

  • Caso o parâmetro nCount seja maior que o tamanho da string, a string informada como parâmetro será retornada.
  • Caso o parâmetro nCount seja menor ou igual a 0 (zero), a função retornará uma string vazia.

Exemplos

Exemplo 1
user function left1()
  Local cTest := "Linha para teste"
  
  conout( Left( cTest, 5 ) ) // Resultado: "Linha"
return

Abrangência

Todas as versões

Veja também

  • Sem rótulos