From 5aafa548794d23b6d4cafb4fd88289cd0ba2a2a8 Mon Sep 17 00:00:00 2001 From: Cajetan Rodrigues Date: Sat, 25 Apr 2020 01:39:04 +0200 Subject: [PATCH] bpo-40340: Separate examples more clearly in the programming FAQ (GH-19688) --- Doc/faq/programming.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/Doc/faq/programming.rst b/Doc/faq/programming.rst index 70b11d6e930..68f9ce811a6 100644 --- a/Doc/faq/programming.rst +++ b/Doc/faq/programming.rst @@ -851,10 +851,11 @@ For integers, use the built-in :func:`int` type constructor, e.g. ``int('144') e.g. ``float('144') == 144.0``. By default, these interpret the number as decimal, so that ``int('0144') == -144`` and ``int('0x144')`` raises :exc:`ValueError`. ``int(string, base)`` takes -the base to convert from as a second optional argument, so ``int('0x144', 16) == -324``. If the base is specified as 0, the number is interpreted using Python's -rules: a leading '0o' indicates octal, and '0x' indicates a hex number. +144`` holds true, and ``int('0x144')`` raises :exc:`ValueError`. ``int(string, +base)`` takes the base to convert from as a second optional argument, so ``int( +'0x144', 16) == 324``. If the base is specified as 0, the number is interpreted +using Python's rules: a leading '0o' indicates octal, and '0x' indicates a hex +number. Do not use the built-in function :func:`eval` if all you need is to convert strings to numbers. :func:`eval` will be significantly slower and it presents a