https://github.com/python/cpython/commit/c24e238417c40935c30815dd6c70baeac2ee928d
commit: c24e238417c40935c30815dd6c70baeac2ee928d
branch: main
author: Stan Ulbrych <[email protected]>
committer: hugovk <[email protected]>
date: 2025-12-16T13:26:33+02:00
summary:
gh-85204: Improve `locale.setlocale` example (#132683)
files:
M Doc/library/locale.rst
diff --git a/Doc/library/locale.rst b/Doc/library/locale.rst
index 94fc046d3f3c46..ce025670c92999 100644
--- a/Doc/library/locale.rst
+++ b/Doc/library/locale.rst
@@ -48,8 +48,19 @@ The :mod:`locale` module defines the following exception and
functions:
If *locale* is omitted or ``None``, the current setting for *category* is
returned.
+ Example::
+
+ >>> import locale
+ >>> loc = locale.setlocale(locale.LC_ALL) # get current locale
+ # use German locale; name and availability varies with platform
+ >>> locale.setlocale(locale.LC_ALL, 'de_DE.UTF-8')
+ >>> locale.strcoll('f\xe4n', 'foo') # compare a string containing an
umlaut
+ >>> locale.setlocale(locale.LC_ALL, '') # use user's preferred locale
+ >>> locale.setlocale(locale.LC_ALL, 'C') # use default (C) locale
+ >>> locale.setlocale(locale.LC_ALL, loc) # restore saved locale
+
:func:`setlocale` is not thread-safe on most systems. Applications typically
- start with a call of ::
+ start with a call of::
import locale
locale.setlocale(locale.LC_ALL, '')
@@ -580,18 +591,6 @@ The :mod:`locale` module defines the following exception
and functions:
:func:`localeconv`.
-Example::
-
- >>> import locale
- >>> loc = locale.getlocale() # get current locale
- # use German locale; name might vary with platform
- >>> locale.setlocale(locale.LC_ALL, 'de_DE')
- >>> locale.strcoll('f\xe4n', 'foo') # compare a string containing an umlaut
- >>> locale.setlocale(locale.LC_ALL, '') # use user's preferred locale
- >>> locale.setlocale(locale.LC_ALL, 'C') # use default (C) locale
- >>> locale.setlocale(locale.LC_ALL, loc) # restore saved locale
-
-
Background, details, hints, tips and caveats
--------------------------------------------
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
