Função lpad

Aplica-se a: SQL do Databricks Databricks Runtime

Retorna expr, preenchido à esquerda com pad até o comprimento de len.

Sintaxe

lpad(expr, len [, pad] )

Argumentos

• expr: uma expressão STRING ou BINARY a ser preenchida.
• len: Uma expressão de INTEIRO especificando o comprimento da cadeia de caracteres de resultado
• pad: Uma expressão STRING ou BINARY opcional que especifica o preenchimento.

Retornos

Uma STRING.

Se expr for maior que len, o valor de retorno será reduzido para caracteres len. Se você não especificar pad, uma STRING expr será preenchida à esquerda com caracteres de espaço, enquanto um BINÁRIO expr será preenchido à esquerda com bytes x'00'. Se len for menor que 1, uma cadeia de caracteres vazia.

O BINARY tem suporte desde:Databricks Runtime 11.0.

Exemplos

> SELECT lpad('hi', 5, 'ab');
 abahi
> SELECT lpad('hi', 1, '??');
 h
> SELECT lpad('hi', 5);
    hi

> SELECT hex(lpad(x'1020', 5, x'05'))
 0505051020

Funções relacionadas

• rpad função
• ltrim função
• rtrim função
• trim função