From: Adorilson Bezerra <adorilson@gmail.com>
Date: Mon, 24 Nov 2025 11:47:54 +0000 (+0000)
Subject: gh-106318: Add example for str.isdecimal() (#137559)
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=6462322840ad42f841e382d0a238ac026e6f711b;p=thirdparty%2FPython%2Fcpython.git

gh-106318: Add example for str.isdecimal() (#137559)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index f3a99c4448b9..7eb4f743d5ab 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -2073,9 +2073,18 @@ expression support in the :mod:`re` module).
    Return ``True`` if all characters in the string are decimal
    characters and there is at least one character, ``False``
    otherwise. Decimal characters are those that can be used to form
-   numbers in base 10, e.g. U+0660, ARABIC-INDIC DIGIT
+   numbers in base 10, such as U+0660, ARABIC-INDIC DIGIT
    ZERO.  Formally a decimal character is a character in the Unicode
-   General Category "Nd".
+   General Category "Nd". For example:
+
+   .. doctest::
+
+      >>> '0123456789'.isdecimal()
+      True
+      >>> '٠١٢٣٤٥٦٧٨٩'.isdecimal()  # Arabic-Indic digits zero to nine
+      True
+      >>> 'alphabetic'.isdecimal()
+      False
 
 
 .. method:: str.isdigit()