Skip to content

Commit

Permalink
Update PR pythonGH-118970 with some format changes
Browse files Browse the repository at this point in the history
I made some formatting changes to some examples in PR python#118970 from @uatach
The idea was to get this merged quickly.
  • Loading branch information
blaisep committed May 20, 2024
1 parent 2166f58 commit 4e3a051
Showing 1 changed file with 11 additions and 6 deletions.
17 changes: 11 additions & 6 deletions Doc/tutorial/inputoutput.rst
Original file line number Diff line number Diff line change
Expand Up @@ -37,18 +37,23 @@ printing space-separated values. There are several ways to format output.
* The :meth:`str.format` method of strings requires more manual
effort. You'll still use ``{`` and ``}`` to mark where a variable
will be substituted and can provide detailed formatting directives,
but you'll also need to provide the information to be formatted.
but you'll also need to provide the information to be formatted. In the following code
block there are two examples of how to format variables:


::

>>> yes_votes = 42_572_654
>>> no_votes = 43_132_495
>>> percentage = yes_votes / (yes_votes + no_votes)
>>> # Print yes_votes padded with spaces and a negative sign only for negative numbers
>>> # Also print percentage multiplied by 100, with 2 decimal places and followed by a percent sign:
>>> total_votes = 43_132_495
>>> percentage = yes_votes / (yes_votes + total_votes)
>>> '{:-9} YES votes {:2.2%}'.format(yes_votes, percentage)
' 42572654 YES votes 49.67%'

Notice how the ``yes_votes`` are padded with spaces and a negative sign only for negative numbers.
The example also prints ``percentage`` multiplied by 100, with 2 decimal
places and followed by a percent sign (see :ref:`formatspec` for details).


* Finally, you can do all the string handling yourself by using string slicing and
concatenation operations to create any layout you can imagine. The
string type has some methods that perform useful operations for padding
Expand Down Expand Up @@ -204,7 +209,7 @@ This is particularly useful in combination with the built-in function
>>> table = {k: str(v) for k, v in vars().items()}
>>> message = " ".join([f'{k}: ' + '{' + k +'};' for k in table.keys()])
>>> print(message.format(**table))
__name__: __main__; __doc__: None; __package__: None; __loader__: <class '_frozen_importlib.BuiltinImporter'>; __spec__: None; __annotations__: {}; __builtins__: <module 'builtins' (built-in)>;
__name__: __main__; __doc__: None; __package__: None; __loader__: ...

As an example, the following lines produce a tidily aligned
set of columns giving integers and their squares and cubes::
Expand Down

0 comments on commit 4e3a051

Please sign in to comment.