Pular para o conteúdo principal

Preencher uma string à direita (string.rpad)

Declaração​

string_preenchida = string.rpad(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 à direita 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.rpad('ff',   6, '0'))  -- retorna ff0000
nLog(string.rpad('100',  6, '0'))  -- retorna 100000
nLog(string.rpad('1234', 6, '0'))  -- retorna 123400
nLog(string.rpad('123',  6, 'xy')) -- retorna 123xyx

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