str.ljust() Preenche alinhando à esquerda
Última atualização: 2026-09-22
str.ljust() Preenche alinhando à esquerda
str.ljust(width[, fillchar]) retorna uma string de comprimento width, com a string original alinhada à esquerda e preenchida à direita com fillchar.
| Categoria | Métodos de string |
|---|---|
| Tipo | Método de tipo interno |
| Versão do Python | all |
📝 Sintaxe
str.ljust(width[, fillchar])
⚙️ Parâmetros
| width Obrigatório | Total width of the result string. |
|---|---|
| fillchar Opcional | Single character to pad with on the right; defaults to a space.(Padrão:' ') |
Retorno:str. A new string left-justified in width, padded on the right.
Modifica o original:Não (retorna um novo objeto)
💥 Exceções
TypeError— Raised when fillchar is not a string of length 1.
▶ Exemplo
Edite o código, clique em Executar e veja o resultado no painel de saída:
Saída:
hi........
💡 Casos relacionados
Mais estudos de caso em breve — aguarde.
❓ Perguntas frequentes
QO que acontece quando width é menor que o comprimento original?
AA string original é retornada diretamente sem truncamento. 'hi'.ljust(1) retorna 'hi'.
QQuais são os requisitos para o parâmetro fillchar?
ADeve ser uma string de um único caractere, caso contrário um TypeError é lançado. Por padrão, ele preenche com espaços.
QQual é um caso de uso comum?
AAlinhar colunas de tabelas na saída e produzir texto de largura fixa. Frequentemente usado em conjunto com rjust() e center().