Histórico da Página

Sintaxe

LTRIM( <expressão caracter> )

Propósito

Remove os espaços em branco à esquerda de uma cadeia de caracteres.

Argumentos

<expressão caracter>

Define a cadeia de caracteres cujos espaços em branco à esquerda serão removidos.

Utilização

A função LTRIM() é utilizada para remover os espaços em branco à esquerda de uma cadeia de caracteres, quando se necessita de uma adequada formatação dos dados. Por exemplo, quando se aplica a função STR(), que transforma um valor numérico em caracter, são colocados espaços em branco à esquerda do número convertido. A função LTRIM() remove esses espaços em branco.

Se a cadeia de caracteres especificada for nula (“”) ou se contiver apenas espaços em branco, a função LTRIM() fornecerá uma cadeia de caracteres nula (“”).

Dicas

A função LTRIM() está relacionada com as funções RTRIM(), que remove os espaços em branco da direita, e ALLTRIM(), que remove tanto os espaços em branco da direita como os da esquerda.

As funções PADL(), PADR() e PADC() são, respectivamente, o inverso das funções LTRIM(), RTRIM() e ALLTRIM(). Estas funções adicionam caracteres, em geral espaços em branco, alinhando cadeias de caracteres à esquerda, à direita e de ambos os lados (centralizando-as), respectivamente. Com estas quatro funções é possível obter qualquer formatação desejada numa cadeia de caracteres.

Exemplos

cNome := “          Protheus – O ERP da TOTVS”

MsgAlert( LTRIM(cNome) )     // Resulta “Protheus – O ERP da TOTVS”