str.ljust() Left-justify
Last updated: 2026-09-22
str.ljust() Left-justify
str.ljust(width[, fillchar]) left-justifies in a field of width, padded with fillchar.
| Category | String Methods |
|---|---|
| Kind | Built-in Type Method |
| Python Version | all |
📝 Syntax
str.ljust(width[, fillchar])⚙️ Parameters
| width Required | Total width of the result string. |
|---|---|
| fillchar Optional | Single character to pad with on the right; defaults to a space.（Default：' '） |
Returns：str. A new string left-justified in width, padded on the right.
Mutates the original：No (returns a new object)
💥 Raises
TypeError— Raised when fillchar is not a string of length 1.
▶ Example
Edit the code, press Run, and see the result in the output panel:
Output：
hi........💡 Related Cases
More case studies coming soon — check back later.
❓ FAQ
QWhat happens when width is smaller than the original length?
AThe original string is returned directly without truncation. 'hi'.ljust(1) returns 'hi'.
QWhat are the requirements for the fillchar parameter?
AIt must be a single-character string, otherwise a TypeError is raised. By default it pads with spaces.
QWhat is a common use case?
AAligning table columns in output and producing fixed-width text. Often used together with rjust() and center().
