Pular para o conteúdo principal

Preencher uma string à esquerda (string.lpad)

Declaração​

string_preenchida = string.lpad(string_original, comprimento, caractere_de_preenchimento)

Parâmetros​

  • string original
    String.
  • comprimento
    Inteiro; especifica o comprimento da string preenchida.
  • caractere de preenchimento
    String opcional; especifica o caractere usado no preenchimento. O padrão é um espaço.

Valor retornado​

  • string preenchida
    String.

Descrição​

Preenche a string original à esquerda até atingir o comprimento, usando o caractere de preenchimento quando necessário.
Esta função está disponível a partir da versão 20250313.

Exemplo​

nLog(string.lpad('ff',   6, '0'))  -- retorna 0000ff
nLog(string.lpad('100',  6, '0'))  -- retorna 000100
nLog(string.lpad('1234', 6, '0'))  -- retorna 001234
nLog(string.lpad('123',  6, 'xy')) -- retorna xyx123

Observação: o código acima usa a função nLog, que não pertence a este capítulo.