`locale.md`

435 строк · 41.2 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.12/library/locale.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# `locale` – Службы интернационализации89**Исходный код:** [Lib/locale.py](https://python-all.ru/src/3.12/Lib/locale.py)1011---1213Модуль [`locale`](https://python-all.ru/3.12/library/locale.html#module-locale) предоставляет доступ к базе данных локалей POSIX и её функциональности. Механизм локалей POSIX позволяет разработчикам решать задачи, связанные с культурными особенностями приложения, не требуя от них знания всех тонкостей каждой страны, где выполняется программа.1415Модуль [`locale`](https://python-all.ru/3.12/library/locale.html#module-locale) реализован поверх модуля `_locale`, который, в свою очередь, использует реализацию локали ANSI C, если она доступна.1617Модуль [`locale`](https://python-all.ru/3.12/library/locale.html#module-locale) определяет следующее исключение и функции:1819#### `exception locale.Error`2021Исключение возникает, когда локаль, переданная в [`setlocale()`](https://python-all.ru/3.12/library/locale.html#locale.setlocale), не распознана.2223#### `locale.setlocale(category, locale=None)`2425Если передан *locale* и он не равен `None`, то [`setlocale()`](https://python-all.ru/3.12/library/locale.html#locale.setlocale) изменяет настройки локали для категории *category*. Доступные категории перечислены ниже в описании данных. *locale* может быть строкой или итерируемым объектом из двух строк (код языка и кодировка). Если это итерируемый объект, он преобразуется в имя локали с помощью механизма псевдонимов локалей. Пустая строка задаёт настройки пользователя по умолчанию. Если изменение локали не удаётся, вызывается исключение [`Error`](https://python-all.ru/3.12/library/locale.html#locale.Error). В случае успеха возвращается новая настройка локали.2627Если *locale* опущен или равен `None`, возвращается текущая настройка для категории *category*.2829[`setlocale()`](https://python-all.ru/3.12/library/locale.html#locale.setlocale) не является потокобезопасной на большинстве систем. Приложения обычно начинают с вызова3031```python32import locale33locale.setlocale(locale.LC_ALL, '')34```3536Это устанавливает локаль для всех категорий в пользовательскую настройку по умолчанию (обычно заданную в переменной окружения `LANG`). Если впоследствии локаль не изменять, использование многопоточности не должно вызывать проблем.3738#### `locale.localeconv()`3940Возвращает словарь с данными о локальных соглашениях. Ключами этого словаря являются следующие строки:4142| Категория | Клавиша | Значение |43| --- | --- | --- |44| [`LC_NUMERIC`](https://python-all.ru/3.12/library/locale.html#locale.LC_NUMERIC) | `'decimal_point'` | Символ десятичной точки. |45|  | `'grouping'` | Последовательность чисел, указывающая, в каких относительных позициях ожидается `'thousands_sep'`. Если последовательность завершается значением [`CHAR_MAX`](https://python-all.ru/3.12/library/locale.html#locale.CHAR_MAX), дальнейшая группировка не выполняется. Если последовательность завершается значением `0`, размер последней группы используется повторно. |46|  | `'thousands_sep'` | Символ, используемый между группами. |47| [`LC_MONETARY`](https://python-all.ru/3.12/library/locale.html#locale.LC_MONETARY) | `'int_curr_symbol'` | Международный символ валюты. |48|  | `'currency_symbol'` | Локальный символ валюты. |49|  | `'p_cs_precedes/n_cs_precedes'` | Предшествует ли символ валюты значению (для положительных и отрицательных значений соответственно). |50|  | `'p_sep_by_space/n_sep_by_space'` | Отделяется ли символ валюты от значения пробелом (для положительных и отрицательных значений соответственно). |51|  | `'mon_decimal_point'` | Десятичная точка, используемая для денежных значений. |52|  | `'frac_digits'` | Количество дробных цифр, используемых в локальном форматировании денежных значений. |53|  | `'int_frac_digits'` | Количество дробных цифр, используемых в международном форматировании денежных значений. |54|  | `'mon_thousands_sep'` | Разделитель групп, используемый для денежных значений. |55|  | `'mon_grouping'` | Эквивалентно `'grouping'`, используется для денежных значений. |56|  | `'positive_sign'` | Символ, используемый для обозначения положительного денежного значения. |57|  | `'negative_sign'` | Символ, используемый для обозначения отрицательного денежного значения. |58|  | `'p_sign_posn/n_sign_posn'` | Положение знака (для положительных и отрицательных значений соответственно), см. ниже. |5960Все числовые значения можно задать как [`CHAR_MAX`](https://python-all.ru/3.12/library/locale.html#locale.CHAR_MAX), чтобы указать, что в данной локали значение не задано.6162Возможные значения для `'p_sign_posn'` и `'n_sign_posn'` приведены ниже.6364| Значение | Пояснение |65| --- | --- |66| `0` | Валюта и значение заключаются в скобки. |67| `1` | Знак должен стоять перед значением и символом валюты. |68| `2` | Знак должен следовать после значения и символа валюты. |69| `3` | Знак должен стоять непосредственно перед значением. |70| `4` | Знак должен стоять непосредственно после значения. |71| `CHAR_MAX` | В этой локали ничего не указано. |7273Функция временно устанавливает локали `LC_CTYPE`, `LC_NUMERIC` или `LC_MONETARY`, если локали различаются, а числовые или денежные строки содержат не-ASCII символы. Это временное изменение влияет на другие потоки.7475Изменено в версии 3.7: Теперь функция в некоторых случаях временно устанавливает локаль `LC_CTYPE` в локаль `LC_NUMERIC`.7677#### `locale.nl_langinfo(option)`7879Возвращает строку с информацией, зависящей от локали. Эта функция доступна не на всех системах, и набор возможных опций может различаться на разных платформах. Аргументы – числа, для которых в модуле locale определены символьные константы.8081Функция [`nl_langinfo()`](https://python-all.ru/3.12/library/locale.html#locale.nl_langinfo) принимает один из следующих ключей. Большинство описаний взяты из соответствующих описаний в библиотеке GNU C.8283#### `locale.CODESET`8485Возвращает строку с именем кодировки символов, используемой в выбранной локали.8687#### `locale.D_T_FMT`8889Возвращает строку, которую можно использовать как строку форматирования для [`time.strftime()`](https://python-all.ru/3.12/library/time.html#time.strftime) для представления даты и времени с учётом локали.9091#### `locale.D_FMT`9293Возвращает строку, которую можно использовать как строку форматирования для [`time.strftime()`](https://python-all.ru/3.12/library/time.html#time.strftime) для представления даты с учётом локали.9495#### `locale.T_FMT`9697Возвращает строку, которую можно использовать как строку форматирования для [`time.strftime()`](https://python-all.ru/3.12/library/time.html#time.strftime) для представления времени с учётом локали.9899#### `locale.T_FMT_AMPM`100101Возвращает строку форматирования для [`time.strftime()`](https://python-all.ru/3.12/library/time.html#time.strftime) для представления времени в формате AM/PM.102103#### `locale.DAY_1`104105#### `locale.DAY_2`106107#### `locale.DAY_3`108109#### `locale.DAY_4`110111#### `locale.DAY_5`112113#### `locale.DAY_6`114115#### `locale.DAY_7`116117Возвращает название n-го дня недели.118119> **Примечание**120>121> В соответствии с американским соглашением [`DAY_1`](https://python-all.ru/3.12/library/locale.html#locale.DAY_1) – воскресенье, а не международным (ISO 8601), где первый день недели – понедельник.122123#### `locale.ABDAY_1`124125#### `locale.ABDAY_2`126127#### `locale.ABDAY_3`128129#### `locale.ABDAY_4`130131#### `locale.ABDAY_5`132133#### `locale.ABDAY_6`134135#### `locale.ABDAY_7`136137Возвращает сокращённое название n-го дня недели.138139#### `locale.MON_1`140141#### `locale.MON_2`142143#### `locale.MON_3`144145#### `locale.MON_4`146147#### `locale.MON_5`148149#### `locale.MON_6`150151#### `locale.MON_7`152153#### `locale.MON_8`154155#### `locale.MON_9`156157#### `locale.MON_10`158159#### `locale.MON_11`160161#### `locale.MON_12`162163Возвращает название n-го месяца.164165#### `locale.ABMON_1`166167#### `locale.ABMON_2`168169#### `locale.ABMON_3`170171#### `locale.ABMON_4`172173#### `locale.ABMON_5`174175#### `locale.ABMON_6`176177#### `locale.ABMON_7`178179#### `locale.ABMON_8`180181#### `locale.ABMON_9`182183#### `locale.ABMON_10`184185#### `locale.ABMON_11`186187#### `locale.ABMON_12`188189Получить сокращённое название n-го месяца.190191#### `locale.RADIXCHAR`192193Получить символ десятичного разделителя (десятичная точка, десятичная запятая и т.д.).194195#### `locale.THOUSEP`196197Получить символ разделителя тысяч (групп по три цифры).198199#### `locale.YESEXPR`200201Получить регулярное выражение, которое можно использовать с функцией regex для распознавания положительного ответа на вопрос «да/нет».202203#### `locale.NOEXPR`204205Получить регулярное выражение, которое можно использовать с функцией `regex(3)` для распознавания отрицательного ответа на вопрос «да/нет».206207> **Примечание**208>209> Регулярные выражения для [`YESEXPR`](https://python-all.ru/3.12/library/locale.html#locale.YESEXPR) и [`NOEXPR`](https://python-all.ru/3.12/library/locale.html#locale.NOEXPR) используют синтаксис, подходящий для функции `regex` из библиотеки C, который может отличаться от синтаксиса, используемого в [`re`](https://python-all.ru/3.12/library/re.html#module-re).210211#### `locale.CRNCYSTR`212213Получить символ валюты, перед которым стоит «-», если символ должен отображаться перед значением, «+», если символ должен отображаться после значения, или «.», если символ должен заменить десятичный разделитель.214215#### `locale.ERA`216217Получить строку, описывающую, как подсчитываются и отображаются годы для каждой эры в локали.218219Большинство локалей не определяют это значение. Примером локали, которая определяет это значение, является японская. В Японии традиционное представление дат включает название эры, соответствующей правлению действующего императора.220221Обычно нет необходимости использовать это значение напрямую. Указание модификатора `E` в строках формата заставляет функцию [`time.strftime()`](https://python-all.ru/3.12/library/time.html#time.strftime) использовать эту информацию. Формат возвращаемой строки описан в *The Open Group Base Specifications Issue 8*, параграф [7.3.5.2 LC\_TIME C-Language Access](https://python-all.ru/3.12/library/locale.html).222223#### `locale.ERA_D_T_FMT`224225Получить строку формата для [`time.strftime()`](https://python-all.ru/3.12/library/time.html#time.strftime) для представления даты и времени в локализованном формате, основанном на эре.226227#### `locale.ERA_D_FMT`228229Получить строку формата для [`time.strftime()`](https://python-all.ru/3.12/library/time.html#time.strftime) для представления даты в локализованном формате, основанном на эре.230231#### `locale.ERA_T_FMT`232233Получить строку формата для [`time.strftime()`](https://python-all.ru/3.12/library/time.html#time.strftime) для представления времени в локализованном формате, основанном на эре.234235#### `locale.ALT_DIGITS`236237Получить строку, состоящую из не более чем 100 символов, разделённых точкой с запятой, используемых для представления значений от 0 до 99 в локализованном виде. В большинстве локалей это пустая строка.238239#### `locale.getdefaultlocale([envvars])`240241Пытается определить настройки локали по умолчанию и возвращает их в виде кортежа вида `(language code, encoding)`.242243Согласно POSIX, программа, которая не вызывала `setlocale(LC_ALL, '')`, работает с переносимой локалью `'C'`. Вызов `setlocale(LC_ALL, '')` позволяет ей использовать локаль по умолчанию, определённую переменной `LANG`. Поскольку мы не хотим вмешиваться в текущую настройку локали, мы имитируем описанное выше поведение.244245Для поддержания совместимости с другими платформами тестируется не только переменная `LANG`, но и список переменных, задаваемый параметром envvars. Первая обнаруженная определённая переменная будет использована. *envvars* по умолчанию равен пути поиска, используемому в GNU gettext; он всегда должен содержать имя переменной `'LANG'`. Путь поиска GNU gettext содержит `'LC_ALL'`, `'LC_CTYPE'`, `'LANG'` и `'LANGUAGE'` в указанном порядке.246247За исключением кода `'C'`, код языка соответствует [**RFC 1766**](https://python-all.ru/3.12/library/locale.html). *Код языка* и *кодировка* могут быть `None`, если их значения не удаётся определить.248249Устарело с версии 3.11, будет удалено в версии 3.15.250251#### `locale.getlocale(category=LC_CTYPE)`252253Возвращает текущую настройку для указанной категории локали в виде последовательности, содержащей *код языка*, *кодировку*. *Категория* может быть одним из значений `LC_*`, кроме [`LC_ALL`](https://python-all.ru/3.12/library/locale.html#locale.LC_ALL). По умолчанию [`LC_CTYPE`](https://python-all.ru/3.12/library/locale.html#locale.LC_CTYPE).254255За исключением кода `'C'`, код языка соответствует [**RFC 1766**](https://python-all.ru/3.12/library/locale.html). *Код языка* и *кодировка* могут быть `None`, если их значения не удаётся определить.256257#### `locale.getpreferredencoding(do_setlocale=True)`258259Возвращает [кодировку локали](https://python-all.ru/3.12/glossary.html#term-locale-encoding), используемую для текстовых данных, в соответствии с пользовательскими предпочтениями. В разных системах пользовательские предпочтения выражаются по-разному, и на некоторых системах их может быть невозможно получить программно, поэтому эта функция возвращает только предположительное значение.260261На некоторых системах для получения пользовательских предпочтений необходимо вызывать [`setlocale()`](https://python-all.ru/3.12/library/locale.html#locale.setlocale), поэтому эта функция не является потокобезопасной. Если вызывать setlocale не требуется или нежелательно, *do\_setlocale* следует установить в `False`.262263На Android или если включен [режим Python UTF-8](https://python-all.ru/3.12/library/os.html#utf8-mode), всегда возвращается `'utf-8'`; аргументы [кодировка локали](https://python-all.ru/3.12/glossary.html#term-locale-encoding) и *do\_setlocale* игнорируются.264265[Предварительная инициализация Python](https://python-all.ru/3.12/c-api/init_config.html#c-preinit) настраивает локаль LC\_CTYPE. См. также [кодировку файловой системы и обработчик ошибок](https://python-all.ru/3.12/glossary.html#term-filesystem-encoding-and-error-handler).266267Изменено в версии 3.7: Теперь функция всегда возвращает `"utf-8"` на Android или если включен [режим Python UTF-8](https://python-all.ru/3.12/library/os.html#utf8-mode).268269#### `locale.getencoding()`270271Возвращает текущую [кодировку локали](https://python-all.ru/3.12/glossary.html#term-locale-encoding):272273- На Android и VxWorks возвращает `"utf-8"`.274- На Unix возвращает кодировку текущей локали [`LC_CTYPE`](https://python-all.ru/3.12/library/locale.html#locale.LC_CTYPE). Возвращает `"utf-8"`, если `nl_langinfo(CODESET)` возвращает пустую строку: например, если текущая локаль LC\_CTYPE не поддерживается.275- На Windows возвращает кодовую страницу ANSI.276277[Предварительная инициализация Python](https://python-all.ru/3.12/c-api/init_config.html#c-preinit) настраивает локаль LC\_CTYPE. См. также [кодировку файловой системы и обработчик ошибок](https://python-all.ru/3.12/glossary.html#term-filesystem-encoding-and-error-handler).278279Эта функция аналогична [`getpreferredencoding(False)`](https://python-all.ru/3.12/library/locale.html#locale.getpreferredencoding), за исключением того, что она игнорирует [режим Python UTF-8](https://python-all.ru/3.12/library/os.html#utf8-mode).280281Добавлено в версии 3.12.282283#### `locale.normalize(localename)`284285Возвращает нормализованный код локали для заданного имени локали. Возвращённый код локали отформатирован для использования с [`setlocale()`](https://python-all.ru/3.12/library/locale.html#locale.setlocale). Если нормализация не удалась, исходное имя возвращается без изменений.286287Если заданная кодировка неизвестна, функция использует кодировку по умолчанию для кода локали, как и [`setlocale()`](https://python-all.ru/3.12/library/locale.html#locale.setlocale).288289#### `locale.resetlocale(category=LC_ALL)`290291Устанавливает локаль для *category* в значение по умолчанию.292293Значение по умолчанию определяется вызовом [`getdefaultlocale()`](https://python-all.ru/3.12/library/locale.html#locale.getdefaultlocale). *category* по умолчанию равен [`LC_ALL`](https://python-all.ru/3.12/library/locale.html#locale.LC_ALL).294295Устарело с версии 3.11, будет удалено в версии 3.13.296297#### `locale.strcoll(string1, string2)`298299Сравнивает две строки в соответствии с текущей настройкой [`LC_COLLATE`](https://python-all.ru/3.12/library/locale.html#locale.LC_COLLATE). Как и любая другая функция сравнения, возвращает отрицательное, положительное значение или `0` в зависимости от того, располагается ли *string1* до или после *string2* или равна ей.300301#### `locale.strxfrm(string)`302303Преобразует строку в форму, пригодную для сравнений с учётом локали. Например, `strxfrm(s1) < strxfrm(s2)` эквивалентно `strcoll(s1, s2) < 0`. Эта функция может использоваться, когда одна и та же строка сравнивается многократно, например, при сортировке последовательности строк.304305#### `locale.format_string(format, val, grouping=False, monetary=False)`306307Форматирует число *val* в соответствии с текущей настройкой [`LC_NUMERIC`](https://python-all.ru/3.12/library/locale.html#locale.LC_NUMERIC). Формат следует соглашениям оператора `%`. Для чисел с плавающей точкой десятичный разделитель при необходимости изменяется. Если *grouping* равно `True`, также учитывается группировка разрядов.308309Если *monetary* истинно, преобразование использует денежные разделители тысяч и строки группировки.310311Обрабатывает спецификаторы форматирования, как в `format % val`, но с учётом текущих настроек локали.312313Изменено в версии 3.7: Добавлен ключевой параметр *monetary*.314315#### `locale.currency(val, symbol=True, grouping=False, international=False)`316317Форматирует число *val* в соответствии с текущими настройками [`LC_MONETARY`](https://python-all.ru/3.12/library/locale.html#locale.LC_MONETARY).318319Возвращаемая строка включает символ валюты, если *symbol* истинно (значение по умолчанию). Если *grouping* равно `True` (не по умолчанию), группировка выполняется с учётом этого значения. Если *international* равно `True` (не по умолчанию), используется международный символ валюты.320321> **Примечание**322>323> Эта функция не работает с локалью «C», поэтому сначала необходимо задать локаль через [`setlocale()`](https://python-all.ru/3.12/library/locale.html#locale.setlocale).324325#### `locale.str(float)`326327Форматирует число с плавающей запятой в том же формате, что и встроенная функция `str(float)`, но с учётом десятичного разделителя.328329#### `locale.delocalize(string)`330331Преобразует строку в нормализованное строковое представление числа в соответствии с настройками [`LC_NUMERIC`](https://python-all.ru/3.12/library/locale.html#locale.LC_NUMERIC).332333Добавлено в версии 3.5.334335#### `locale.localize(string, grouping=False, monetary=False)`336337Преобразует нормализованное строковое представление числа в отформатированную строку в соответствии с настройками [`LC_NUMERIC`](https://python-all.ru/3.12/library/locale.html#locale.LC_NUMERIC).338339Добавлено в версии 3.10.340341#### `locale.atof(string, func=float)`342343Преобразует строку в число, следуя настройкам [`LC_NUMERIC`](https://python-all.ru/3.12/library/locale.html#locale.LC_NUMERIC), вызывая *func* для результата вызова [`delocalize()`](https://python-all.ru/3.12/library/locale.html#locale.delocalize) для *string*.344345#### `locale.atoi(string)`346347Преобразует строку в целое число, следуя соглашениям [`LC_NUMERIC`](https://python-all.ru/3.12/library/locale.html#locale.LC_NUMERIC).348349#### `locale.LC_CTYPE`350351Категория локали для функций работы с типами символов. Самое важное: эта категория определяет кодировку текста, то есть как байты интерпретируются как кодовые точки Unicode. См. [**PEP 538**](https://python-all.ru/3.12/library/locale.html) и [**PEP 540**](https://python-all.ru/3.12/library/locale.html) о том, как эта переменная может автоматически приводиться к `C.UTF-8` для предотвращения проблем, вызванных некорректными настройками в контейнерах или несовместимыми настройками, переданными через удалённые SSH-соединения.352353Внутренне Python не использует зависящие от локали функции преобразования символов из `ctype.h`. Вместо этого внутренний `pyctype.h` предоставляет не зависящие от локали аналоги, такие как `Py_TOLOWER`.354355#### `locale.LC_COLLATE`356357Категория локали для сортировки строк. Функции [`strcoll()`](https://python-all.ru/3.12/library/locale.html#locale.strcoll) и [`strxfrm()`](https://python-all.ru/3.12/library/locale.html#locale.strxfrm) модуля [`locale`](https://python-all.ru/3.12/library/locale.html#module-locale) затрагиваются.358359#### `locale.LC_TIME`360361Категория локали для форматирования времени. Функция [`time.strftime()`](https://python-all.ru/3.12/library/time.html#time.strftime) следует этим соглашениям.362363#### `locale.LC_MONETARY`364365Категория локали для форматирования денежных значений. Доступные параметры можно получить из функции [`localeconv()`](https://python-all.ru/3.12/library/locale.html#locale.localeconv).366367#### `locale.LC_MESSAGES`368369Категория локали для отображения сообщений. В настоящее время Python не поддерживает сообщения, учитывающие локаль, для конкретных приложений. Сообщения, выводимые операционной системой, например возвращаемые [`os.strerror()`](https://python-all.ru/3.12/library/os.html#os.strerror), могут затрагиваться этой категорией.370371Это значение может быть недоступно в операционных системах, не соответствующих стандарту POSIX, в первую очередь в Windows.372373#### `locale.LC_NUMERIC`374375Категория локали для форматирования чисел. Функции [`format_string()`](https://python-all.ru/3.12/library/locale.html#locale.format_string), [`atoi()`](https://python-all.ru/3.12/library/locale.html#locale.atoi), [`atof()`](https://python-all.ru/3.12/library/locale.html#locale.atof) и [`str()`](https://python-all.ru/3.12/library/locale.html#locale.str) модуля [`locale`](https://python-all.ru/3.12/library/locale.html#module-locale) затрагиваются этой категорией. Все остальные операции форматирования чисел не затрагиваются.376377#### `locale.LC_ALL`378379Комбинация всех настроек локали. Если этот флаг используется при изменении локали, предпринимается попытка установить локаль для всех категорий. Если это не удаётся для какой-либо категории, ни одна категория не изменяется. При получении локали с помощью этого флага возвращается строка, указывающая настройки для всех категорий. Эту строку можно впоследствии использовать для восстановления настроек.380381#### `locale.CHAR_MAX`382383Это символическая константа, используемая для различных значений, возвращаемых [`localeconv()`](https://python-all.ru/3.12/library/locale.html#locale.localeconv).384385Пример:386387```python388>>> import locale389>>> loc = locale.getlocale()  # получить текущую локаль390# use German locale; name might vary with platform391>>> locale.setlocale(locale.LC_ALL, 'de_DE')392>>> locale.strcoll('f\xe4n', 'foo')  # сравнить строку, содержащую умлаут393>>> locale.setlocale(locale.LC_ALL, '')   # использовать предпочтительную локаль пользователя394>>> locale.setlocale(locale.LC_ALL, 'C')  # использовать локаль по умолчанию (C)395>>> locale.setlocale(locale.LC_ALL, loc)  # восстановить сохранённую локаль396```397398## Предыстория, подробности, подсказки, советы и предостережения399400Стандарт C определяет локаль как свойство всей программы, изменение которого может быть относительно дорогим. Кроме того, некоторые реализации сломаны таким образом, что частая смена локали может вызывать дампы памяти. Это делает локаль несколько болезненной для правильного использования.401402Изначально при запуске программы локалью является `C`, независимо от того, какая локаль предпочтительна для пользователя. Есть одно исключение: категория [`LC_CTYPE`](https://python-all.ru/3.12/library/locale.html#locale.LC_CTYPE) изменяется при запуске, чтобы установить текущую кодировку локали на предпочтительную кодировку локали пользователя. Программа должна явно указать, что она хочет использовать предпочтительные настройки локали пользователя для других категорий, вызвав `setlocale(LC_ALL, '')`.403404Обычно плохая идея вызывать [`setlocale()`](https://python-all.ru/3.12/library/locale.html#locale.setlocale) в какой-либо библиотечной функции, так как побочный эффект затрагивает всю программу. Сохранение и восстановление почти так же плохо: это дорого и затрагивает другие потоки, которые могут выполняться до восстановления настроек.405406Если при написании модуля общего назначения требуется независимая от локали версия операции, на которую влияет локаль (например, определённые форматы, используемые с [`time.strftime()`](https://python-all.ru/3.12/library/time.html#time.strftime)), необходимо найти способ сделать это без использования процедур из стандартной библиотеки. Ещё лучше убедиться, что использование настроек локали допустимо. И только в крайнем случае стоит документировать, что модуль несовместим с настройками локали, отличными от `C`.407408Единственный способ выполнять числовые операции в соответствии с локалью – использовать специальные функции, определённые в этом модуле: [`atof()`](https://python-all.ru/3.12/library/locale.html#locale.atof), [`atoi()`](https://python-all.ru/3.12/library/locale.html#locale.atoi), [`format_string()`](https://python-all.ru/3.12/library/locale.html#locale.format_string), [`str()`](https://python-all.ru/3.12/library/locale.html#locale.str).409410Не существует способа выполнять преобразование регистра и классификацию символов в соответствии с локалью. Для текстовых строк (Unicode) они выполняются только по значению символа, тогда как для байтовых строк преобразования и классификации выполняются по значению ASCII байта, а байты, у которых установлен старший бит (т.е. не-ASCII байты), никогда не преобразуются и не считаются частью какого-либо класса символов, такого как буква или пробел.411412## Для разработчиков расширений и программ, встраивающих Python413414Модули расширений никогда не должны вызывать [`setlocale()`](https://python-all.ru/3.12/library/locale.html#locale.setlocale), за исключением случаев, когда нужно узнать текущую локаль. Но поскольку возвращаемое значение можно переносимо использовать только для её восстановления, это не очень полезно (кроме, возможно, выяснения, является ли локаль `C` или нет).415416Когда код Python использует модуль [`locale`](https://python-all.ru/3.12/library/locale.html#module-locale) для смены локали, это также влияет на встраиваемое приложение. Если встраиваемое приложение не хочет, чтобы это происходило, оно должно удалить модуль расширения `_locale` (который выполняет всю работу) из таблицы встроенных модулей в файле `config.c`, и убедиться, что модуль `_locale` недоступен как разделяемая библиотека.417418## Доступ к каталогам сообщений419420#### `locale.gettext(msg)`421422#### `locale.dgettext(domain, msg)`423424#### `locale.dcgettext(domain, msg, category)`425426#### `locale.textdomain(domain)`427428#### `locale.bindtextdomain(domain, dir)`429430#### `locale.bind_textdomain_codeset(domain, codeset)`431432Модуль locale предоставляет интерфейс gettext библиотеки C на системах, которые поддерживают этот интерфейс. Он состоит из функций [`gettext()`](https://python-all.ru/3.12/library/gettext.html#module-gettext), [`dgettext()`](https://python-all.ru/3.12/library/locale.html#locale.dgettext), [`dcgettext()`](https://python-all.ru/3.12/library/locale.html#locale.dcgettext), [`textdomain()`](https://python-all.ru/3.12/library/locale.html#locale.textdomain), [`bindtextdomain()`](https://python-all.ru/3.12/library/locale.html#locale.bindtextdomain), и [`bind_textdomain_codeset()`](https://python-all.ru/3.12/library/locale.html#locale.bind_textdomain_codeset). Они аналогичны одноимённым функциям в модуле [`gettext`](https://python-all.ru/3.12/library/gettext.html#module-gettext), но используют бинарный формат библиотеки C для каталогов сообщений и алгоритмы поиска библиотеки C для нахождения каталогов сообщений.433434Обычно приложениям Python нет необходимости вызывать эти функции, и вместо них следует использовать [`gettext`](https://python-all.ru/3.12/library/gettext.html#module-gettext). Известным исключением из этого правила являются приложения, которые связываются с дополнительными библиотеками C, внутренне вызывающими функции C `gettext` или `dcgettext`. Для таких приложений может потребоваться привязать текстовый домен, чтобы библиотеки могли правильно найти свои каталоги сообщений.435