gh-106318: Add examples for str.ljust() method (#142719)

adorilson · StanFromIreland · web-flow · commit ec2619c0800d · 2025-12-16T13:39:20.000+02:00
Co-authored-by: Stan Ulbrych &lt;89152624+StanFromIreland@users.noreply.github.com&gt;
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
@@ -2261,6 +2261,19 @@ expression support in the :mod:`re` module).
    done using the specified *fillchar* (default is an ASCII space). The
    original string is returned if *width* is less than or equal to ``len(s)``.
 
+   For example:
+
+   .. doctest::
+
+      >>> 'Python'.ljust(10)
+      'Python    '
+      >>> 'Python'.ljust(10, '.')
+      'Python....'
+      >>> 'Monty Python'.ljust(10, '.')
+      'Monty Python'
+
+   See also :meth:`rjust`.
+
 
 .. method:: str.lower()
 
