From 99bfc56ebedea6b90f4343a41813f7d75d56ef3d Mon Sep 17 00:00:00 2001 From: Sergey B Kirpichev Date: Tue, 10 Mar 2026 16:46:19 +0300 Subject: [PATCH] gh-61449: document present 0-padding option behavior for builtin numeric types --- Doc/library/string.rst | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/Doc/library/string.rst b/Doc/library/string.rst index 8096d90317d93f..ac86d1075da022 100644 --- a/Doc/library/string.rst +++ b/Doc/library/string.rst @@ -428,10 +428,12 @@ The *width* is a decimal integer defining the minimum total field width, including any prefixes, separators, and other formatting characters. If not specified, then the field width will be determined by the content. -When no explicit alignment is given, preceding the *width* field by a zero -(``'0'``) character enables sign-aware zero-padding for numeric types, -excluding :class:`complex`. This is equivalent to a *fill* character of -``'0'`` with an *alignment* type of ``'='``. +When no explicit *fill* character and/or alignment is given, preceding the +*width* field by a zero (``'0'``) character enables sign-aware zero-padding for +numeric types, excluding :class:`complex`. This is equivalent to a *fill* +character of ``'0'`` with an *alignment* type of ``'='``. If *fill* character +is specified, ``'0'`` option is ignored. If alignment is explicitly specified, +it's value take preference over provided by ``'0'`` option. .. versionchanged:: 3.10 Preceding the *width* field by ``'0'`` no longer affects the default