Sumário

Search

  1. Prefácio
  2. A Linguagem de Transformação
  3. Constantes
  4. Operadores
  5. Variáveis
  6. Datas
  7. Funções
  8. Criação de funções personalizadas
  9. Referência de API da Função Personalizada

Referência de Linguagem de Transformação

Referência de Linguagem de Transformação

LTRIM

LTRIM

Remove espaços em branco ou caracteres do início de uma string. Você pode usar LTRIM com IIF ou DECODE em uma transformações de Expressão ou Estratégia de Atualização para evitar espaços em uma tabela de destino.
Se você não especificar um parâmetro
trim_set
na expressão:
  • No modo UNICODE, LTRIM remove espaços de byte único e duplo do início de uma string.
  • No modo ASCII, LTRIM remove apenas espaços de byte único.
Se você usar LTRIM para remover caracteres de uma string, LTRIM compara o
trim_set
a cada caractere no argumento
string
, caractere-por-caractere, a partir do lado esquerdo da string. Se o caractere na string corresponder a qualquer caractere no
trim_set
, LTRIM o removerá. LTRIM continua a comparar e remover caracteres até que ele não consiga encontrar um caractere correspondente no
trim_set
. Em seguida, ele retorna a string, que não inclui caracteres correspondentes.

Sintaxe

LTRIM(
string
[,
trim_set
] )
A tabela a seguir descreve os argumentos para este comando:
Argumentos
Requerido/
Opcional
Descrição
string
Requerido
Qualquer valor de string. Passa as strings que você deseja modificar. Você pode inserir qualquer expressão de transformação válida. Use operadores para executar comparações ou concatenar strings antes de remover caracteres a partir do início de uma string.
trim_set
Opcional
Qualquer valor de string. Passa os caracteres que você deseja remover a partir do início da primeira string. Você pode inserir qualquer expressão de transformação válida. Você também pode inserir uma string de caracteres. No entanto, você deve anexar os caracteres que deseja remover do início da string entre aspas simples, por exemplo, 'abc'. Se você omitir a segunda string, a função removerá todos os espaços em branco do início da string.
LTRIM diferencia maiúsculas de minúsculas. Por exemplo, se você quiser remover o caractere 'A' da string 'Alfredo', insira 'A', não 'a'.

Valor de Retorno

String. Os valores de string com os caracteres especificados no argumento
trim_set
removido.
NULL se um valor transmitido para a função for NULL. Se o
trim_set
for NULL, a função retornará NULL.

Exemplo

A seguinte expressão remove os caracteres 'S' e '.' das strings na porta LAST_NAME:
LTRIM( LAST_NAME, 'S.')
LAST_NAME
RETURN VALUE
Nelson
Nelson
Osborne
Osborne
NULL
NULL
S. MacDonald
MacDonald
Sawyer
awyer
H. Bender
H. Bender
Steadman
teadman
LTRIM remove ‘S.’ de S. MacDonald e o ‘S’ de Sawyer e Steadman, mas não o ponto final de H. Bender. Isso porque LTRIM pesquisa, caractere-por-caractere, o conjunto de caracteres que você especifica no argumento
trim_set
. Se o primeiro caractere na string corresponder ao primeiro caractere em
trim_set
, LTRIM o removerá. Em seguida, LTRIM pesquisa o segundo caractere na string. Se ele corresponder ao segundo caractere em
trim_set
, LTRIM o removerá, e assim por diante. Quando o primeiro caractere na string não combinar com o caractere correspondente em
trim_set
, LTRIM retornará a string e avaliará a linha seguinte.
No exemplo de H. Bender, H não corresponde ao caractere no argumento
trim_set
, então LTRIM retorna a string na porta LAST_NAME e transfere para a linha seguinte.

Dicas para LTRIM

Use RTRIM e LTRIM com || ou CONCAT para remover espaços em branco à direita e à esquerda depois de concatenar duas strings.
Você também pode remover vários conjuntos de caracteres ao aninhar LTRIM. Por exemplo, se quiser remover espaços em branco à esquerda e o caractere 'T' de uma coluna de nomes, você poderá criar uma expressão semelhante a seguinte:
LTRIM( LTRIM( NAMES ), 'T' )