string.md
1> **Источник:** https://python-all.ru/3.10/library/string.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# [`string`](https://python-all.ru/3.10/library/string.html#module-string) – Общие операции со строками89**Исходный код:** [Lib/string.py](https://python-all.ru/src/3.10/Lib/string.py)1011---1213> **См. также**14>15> [Тип текстовой последовательности – str](https://python-all.ru/3.10/library/stdtypes.html#textseq)16>17> [Методы строк](https://python-all.ru/3.10/library/stdtypes.html#string-methods)1819## Константы строк2021Константы, определённые в этом модуле:2223#### `string.ascii_letters`2425Конкатенация констант [`ascii_lowercase`](https://python-all.ru/3.10/library/string.html#string.ascii_lowercase) и [`ascii_uppercase`](https://python-all.ru/3.10/library/string.html#string.ascii_uppercase), описанных ниже. Это значение не зависит от локали.2627#### `string.ascii_lowercase`2829Строчные буквы `'abcdefghijklmnopqrstuvwxyz'`. Это значение не зависит от локали и не изменится.3031#### `string.ascii_uppercase`3233Заглавные буквы `'ABCDEFGHIJKLMNOPQRSTUVWXYZ'`. Это значение не зависит от локали и не изменится.3435#### `string.digits`3637Строка `'0123456789'`.3839#### `string.hexdigits`4041Строка `'0123456789abcdefABCDEF'`.4243#### `string.octdigits`4445Строка `'01234567'`.4647#### `string.punctuation`4849Строка ASCII-символов, которые считаются знаками пунктуации в локали `C`: `` !"#$%&'()*+,-./:;<=>?@[\]^_`{|}~ ``.5051#### `string.printable`5253Строка ASCII-символов, которые считаются печатаемыми. Представляет собой комбинацию [`digits`](https://python-all.ru/3.10/library/string.html#string.digits), [`ascii_letters`](https://python-all.ru/3.10/library/string.html#string.ascii_letters), [`punctuation`](https://python-all.ru/3.10/library/string.html#string.punctuation), и [`whitespace`](https://python-all.ru/3.10/library/string.html#string.whitespace).5455#### `string.whitespace`5657Строка, содержащая все ASCII-символы, которые считаются пробельными. Включает символы: пробел, табуляция, перевод строки, возврат каретки, прогон страницы и вертикальная табуляция.5859## Пользовательское форматирование строк6061Встроенный класс строк предоставляет возможность выполнять сложные замены переменных и форматирование значений с помощью метода [`format()`](https://python-all.ru/3.10/library/stdtypes.html#str.format), описанного в [**PEP 3101**](https://python-all.ru/3.10/library/string.html). Класс [`Formatter`](https://python-all.ru/3.10/library/string.html#string.Formatter) из модуля [`string`](https://python-all.ru/3.10/library/string.html#module-string) позволяет создавать и настраивать собственное поведение форматирования строк, используя ту же реализацию, что и встроенный метод [`format()`](https://python-all.ru/3.10/library/stdtypes.html#str.format).6263#### `class string.Formatter`6465Класс [`Formatter`](https://python-all.ru/3.10/library/string.html#string.Formatter) имеет следующие открытые методы:6667#### `format(format_string, /, *args, **kwargs)`6869Основной метод API. Принимает строку форматирования и произвольный набор позиционных и именованных аргументов. Это просто обёртка, вызывающая [`vformat()`](https://python-all.ru/3.10/library/string.html#string.Formatter.vformat).7071Изменено в версии 3.7: Аргумент строки форматирования теперь является [только позиционным](https://python-all.ru/3.10/glossary.html#positional-only-parameter).7273#### `vformat(format_string, args, kwargs)`7475Эта функция выполняет фактическую работу по форматированию. Она представлена как отдельная функция на случай, если нужно передать предопределённый словарь аргументов, вместо распаковки и повторной упаковки словаря в отдельные аргументы с помощью синтаксиса `*args` и `**kwargs`. [`vformat()`](https://python-all.ru/3.10/library/string.html#string.Formatter.vformat) выполняет разбивку строки форматирования на символьные данные и поля замены. Затем вызываются различные методы, описанные ниже.7677Кроме того, [`Formatter`](https://python-all.ru/3.10/library/string.html#string.Formatter) определяет ряд методов, предназначенных для переопределения в подклассах:7879#### `parse(format_string)`8081Перебирает format\_string и возвращает итерируемый объект кортежей (*literal\_text*, *field\_name*, *format\_spec*, *conversion*). Используется в [`vformat()`](https://python-all.ru/3.10/library/string.html#string.Formatter.vformat) для разбивки строки на буквальный текст или поля замены.8283Значения в кортеже концептуально представляют собой фрагмент литерального текста, за которым следует одно поле подстановки. Если литерального текста нет (что может произойти, когда два поля подстановки идут подряд), то *literal\_text* будет строкой нулевой длины. Если поля подстановки нет, то значения *field\_name*, *format\_spec* и *conversion* будут равны `None`.8485#### `get_field(field_name, args, kwargs)`8687По заданному *field\_name*, возвращённому [`parse()`](https://python-all.ru/3.10/library/string.html#string.Formatter.parse) (см. выше), преобразует его в объект для форматирования. Возвращает кортеж (obj, used\_key). По умолчанию принимает строки вида, определённого в [**PEP 3101**](https://python-all.ru/3.10/library/string.html), например, “0\[name\]” или “label.title”. *args* и *kwargs* передаются так же, как в [`vformat()`](https://python-all.ru/3.10/library/string.html#string.Formatter.vformat). Возвращаемое значение *used\_key* имеет тот же смысл, что параметр *key* у [`get_value()`](https://python-all.ru/3.10/library/string.html#string.Formatter.get_value).8889#### `get_value(key, args, kwargs)`9091Извлекает значение заданного поля. Аргумент *key* может быть целым числом или строкой. Если это целое число, оно представляет индекс позиционного аргумента в *args*; если строка – именованный аргумент в *kwargs*.9293Параметр *args* устанавливается в список позиционных аргументов для [`vformat()`](https://python-all.ru/3.10/library/string.html#string.Formatter.vformat), а параметр *kwargs* – в словарь именованных аргументов.9495Для составных имён полей эти функции вызываются только для первого компонента имени поля; последующие компоненты обрабатываются через обычные операции доступа к атрибутам и индексации.9697Например, выражение поля «0.name» вызовет [`get_value()`](https://python-all.ru/3.10/library/string.html#string.Formatter.get_value) с аргументом *key*, равным 0. Атрибут `name` будет получен после возврата из [`get_value()`](https://python-all.ru/3.10/library/string.html#string.Formatter.get_value) вызовом встроенной функции [`getattr()`](https://python-all.ru/3.10/library/functions.html#getattr).9899Если индекс или ключевое слово ссылаются на несуществующий элемент, должно быть возбуждено исключение [`IndexError`](https://python-all.ru/3.10/library/exceptions.html#IndexError) или [`KeyError`](https://python-all.ru/3.10/library/exceptions.html#KeyError).100101#### `check_unused_args(used_args, args, kwargs)`102103Реализует проверку на неиспользованные аргументы при необходимости. Аргументы этой функции – множество всех ключей аргументов, которые фактически были использованы в строке форматирования (целые числа для позиционных аргументов и строки для именованных), а также ссылка на *args* и *kwargs*, переданные в vformat. Множество неиспользованных аргументов можно вычислить по этим параметрам. Предполагается, что [`check_unused_args()`](https://python-all.ru/3.10/library/string.html#string.Formatter.check_unused_args) возбуждает исключение, если проверка не пройдена.104105#### `format_field(value, format_spec)`106107[`format_field()`](https://python-all.ru/3.10/library/string.html#string.Formatter.format_field) просто вызывает глобальную встроенную функцию [`format()`](https://python-all.ru/3.10/library/functions.html#format). Метод предоставлен, чтобы подклассы могли переопределить его.108109#### `convert_field(value, conversion)`110111Преобразует значение (возвращённое [`get_field()`](https://python-all.ru/3.10/library/string.html#string.Formatter.get_field)) с учётом типа преобразования (как в кортеже, возвращаемом методом [`parse()`](https://python-all.ru/3.10/library/string.html#string.Formatter.parse)). Версия по умолчанию понимает типы преобразования 's' (str), 'r' (repr) и 'a' (ascii).112113## Синтаксис строки формата114115Метод [`str.format()`](https://python-all.ru/3.10/library/stdtypes.html#str.format) и класс [`Formatter`](https://python-all.ru/3.10/library/string.html#string.Formatter) используют одинаковый синтаксис строк форматирования (хотя в случае [`Formatter`](https://python-all.ru/3.10/library/string.html#string.Formatter) подклассы могут определять свой собственный синтаксис). Этот синтаксис связан с синтаксисом [f-строк](https://python-all.ru/3.10/reference/lexical_analysis.html#f-strings), но менее сложен и, в частности, не поддерживает произвольные выражения.116117Строки форматирования содержат «поля замены», заключённые в фигурные скобки `{}`. Всё, что не находится в скобках, считается буквальным текстом и копируется в вывод без изменений. Если нужно включить символ скобки в буквальный текст, его можно экранировать удвоением: `{{` и `}}`.118119Грамматика поля замены выглядит следующим образом:120121> ```122>123> replacement_field ::= "{" [field_name] ["!" conversion] [":" format_spec] "}"124> field_name ::= arg_name ("." attribute_name | "[" element_index "]")*125> arg_name ::= [identifier | digit+]126> attribute_name ::= identifier127> element_index ::= digit+ | index_string128> index_string ::= <any source character except "]"> +129> conversion ::= "r" | "s" | "a"130> format_spec ::= <described in the next section>131> ```132133В менее формальных терминах, поле замены может начинаться с *field\_name*, который задаёт объект, чьё значение должно быть отформатировано и вставлено в вывод вместо поля замены. За *field\_name* может опционально следовать поле *conversion*, которому предшествует восклицательный знак `'!'`, и *format\_spec*, которому предшествует двоеточие `':'`. Они задают нестандартный формат для заменяемого значения.134135См. также раздел [Мини-язык спецификации формата](https://python-all.ru/3.10/library/string.html#formatspec).136137Сам *field\_name* начинается с *arg\_name*, который является либо числом, либо ключевым словом. Если это число, оно относится к позиционному аргументу, а если ключевое слово – к именованному аргументу. Если числовые arg\_names в строке форматирования идут по порядку 0, 1, 2, …, их все можно опустить (а не только некоторые), и числа 0, 1, 2, … будут автоматически подставлены в этом порядке. Поскольку *arg\_name* не ограничен кавычками, невозможно указать произвольные ключи словаря (например, строки `'10'` или `':-]'`) внутри строки форматирования. За *arg\_name* может следовать любое количество выражений индекса или атрибута. Выражение вида `'.name'` выбирает именованный атрибут с помощью [`getattr()`](https://python-all.ru/3.10/library/functions.html#getattr), а выражение вида `'[index]'` выполняет поиск по индексу с помощью `__getitem__()`.138139Изменено в версии 3.1: Спецификаторы позиционных аргументов можно опускать для [`str.format()`](https://python-all.ru/3.10/library/stdtypes.html#str.format), поэтому `'{} {}'.format(a, b)` эквивалентно `'{0} {1}'.format(a, b)`.140141Изменено в версии 3.4: Спецификаторы позиционных аргументов можно опускать для [`Formatter`](https://python-all.ru/3.10/library/string.html#string.Formatter).142143Несколько простых примеров строк форматирования:144145```python146"First, thou shalt count to {0}" # Ссылается на первый позиционный аргумент147"Bring me a {}" # Неявно ссылается на первый позиционный аргумент148"From {} to {}" # То же, что "From {0} to {1}"149"My quest is {name}" # Ссылается на именованный аргумент 'name'150"Weight in tons {0.weight}" # Атрибут 'weight' первого позиционного аргумента151"Units destroyed: {players[0]}" # Первый элемент именованного аргумента 'players'.152```153154Поле *conversion* вызывает приведение типа перед форматированием. Обычно задачу форматирования значения выполняет его собственный метод `__format__()`. Однако в некоторых случаях требуется принудительно отформатировать тип как строку, переопределяя его собственное определение форматирования. Преобразовав значение в строку перед вызовом `__format__()`, можно обойти обычную логику форматирования.155156В настоящее время поддерживаются три флага преобразования: `'!s'` вызывает [`str()`](https://python-all.ru/3.10/library/stdtypes.html#str) для значения, `'!r'` вызывает [`repr()`](https://python-all.ru/3.10/library/functions.html#repr), и `'!a'` вызывает [`ascii()`](https://python-all.ru/3.10/library/functions.html#ascii).157158Несколько примеров:159160```python161"Harold's a clever {0!s}" # Сначала вызывает str() для аргумента162"Bring out the holy {name!r}" # Сначала вызывает repr() для аргумента163"More {!a}" # Сначала вызывает ascii() для аргумента164```165166Поле *format\_spec* содержит спецификацию того, как должно быть представлено значение, включая такие детали, как ширина поля, выравнивание, заполнение, десятичная точность и так далее. Каждый тип значения может определять свой собственный «мини-язык форматирования» или интерпретацию *format\_spec*.167168Большинство встроенных типов поддерживают общий мини-язык форматирования, который описан в следующем разделе.169170Поле *format\_spec* также может содержать вложенные поля подстановки. Эти вложенные поля подстановки могут содержать имя поля, флаг преобразования и спецификацию формата, но более глубокая вложенность не допускается. Поля подстановки внутри format\_spec подставляются перед интерпретацией строки *format\_spec*. Это позволяет динамически задавать форматирование значения.171172Смотрите раздел [Примеры форматирования](https://python-all.ru/3.10/library/string.html#formatexamples) для примеров.173174### Мини-язык спецификации формата175176«Спецификации формата» используются в полях замены внутри строки форматирования для определения того, как отдельные значения представляются (см. [Синтаксис строки форматирования](https://python-all.ru/3.10/library/string.html#formatstrings) и [Форматированные строковые литералы](https://python-all.ru/3.10/reference/lexical_analysis.html#f-strings)). Они также могут передаваться напрямую встроенной функции [`format()`](https://python-all.ru/3.10/library/functions.html#format). Каждый форматируемый тип может определять, как следует интерпретировать спецификацию формата.177178Большинство встроенных типов реализуют следующие параметры для спецификаций формата, хотя некоторые параметры форматирования поддерживаются только числовыми типами.179180Пустая спецификация формата даёт тот же результат, что и вызов [`str()`](https://python-all.ru/3.10/library/stdtypes.html#str) для значения. Непустая спецификация формата обычно изменяет результат.181182Общий вид *стандартного спецификатора формата*:183184```185186format_spec ::= [[fill]align][sign][#][0][width][grouping_option][.precision][type]187fill ::= <any character>188align ::= "<" | ">" | "=" | "^"189sign ::= "+" | "-" | " "190width ::= digit+191grouping_option ::= "_" | ","192precision ::= digit+193type ::= "b" | "c" | "d" | "e" | "E" | "f" | "F" | "g" | "G" | "n" | "o" | "s" | "x" | "X" | "%"194```195196Если указано допустимое значение *align*, ему может предшествовать символ *fill*, который может быть любым символом и по умолчанию является пробелом, если не указан. Нельзя использовать фигурную скобку (”`{`” или “`}`”) в качестве символа *fill* в [форматированном строковом литерале](https://python-all.ru/3.10/reference/lexical_analysis.html#f-strings) или при использовании метода [`str.format()`](https://python-all.ru/3.10/library/stdtypes.html#str.format). Однако можно вставить фигурную скобку с помощью вложенного поля подстановки. Это ограничение не влияет на функцию [`format()`](https://python-all.ru/3.10/library/functions.html#format).197198Значение различных параметров выравнивания следующее:199200> | Параметр | Значение |201> | --- | --- |202> | `'<'` | Выравнивает поле по левому краю в пределах доступного пространства (это значение по умолчанию для большинства объектов). |203> | `'>'` | Выравнивает поле по правому краю в пределах доступного пространства (это значение по умолчанию для чисел). |204> | `'='` | Размещает заполнение после знака (если он есть), но до цифр. Используется для печати полей в виде «+000000120». Этот вариант выравнивания применим только для числовых типов. Он становится значением по умолчанию для чисел, когда перед шириной поля стоит «0». |205> | `'^'` | Выравнивает поле по центру в пределах доступного пространства. |206207Обратите внимание, что если не задана минимальная ширина поля, ширина поля всегда будет равна размеру заполняемых данных, поэтому в этом случае параметр выравнивания не имеет смысла.208209Параметр *sign* допустим только для числовых типов и может быть одним из следующих:210211> | Параметр | Значение |212> | --- | --- |213> | `'+'` | указывает, что знак должен выводиться как для положительных, так и для отрицательных чисел. |214> | `'-'` | указывает, что знак должен выводиться только для отрицательных чисел (это поведение по умолчанию). |215> | пробел | указывает, что перед положительными числами должен ставиться пробел, а перед отрицательными – знак минус. |216217Параметр `'#'` заставляет использовать «альтернативную форму» для преобразования. Альтернативная форма определяется по-разному для разных типов. Этот параметр действителен только для целых, вещественных и комплексных типов. Для целых чисел при двоичном, восьмеричном или шестнадцатеричном выводе этот параметр добавляет соответствующий префикс `'0b'`, `'0o'`, `'0x'` или `'0X'` к выходному значению. Для вещественных и комплексных чисел альтернативная форма приводит к тому, что результат преобразования всегда содержит десятичную точку, даже если за ней нет цифр. Обычно десятичная точка появляется в результате этих преобразований только если за ней следует цифра. Кроме того, для преобразований `'g'` и `'G'` конечные нули не удаляются из результата.218219Параметр `','` указывает на использование запятой в качестве разделителя тысяч. Для разделителя, учитывающего локаль, используйте тип представления целых чисел `'n'`.220221Изменено в версии 3.1: Добавлена опция `','` (см. также [**PEP 378**](https://python-all.ru/3.10/library/string.html)).222223Параметр `'_'` указывает на использование символа подчёркивания в качестве разделителя тысяч для типов представления чисел с плавающей запятой и для типа представления целых чисел `'d'`. Для типов представления целых чисел `'b'`, `'o'`, `'x'` и `'X'` символы подчёркивания вставляются через каждые 4 цифры. Для других типов представления указание этого параметра является ошибкой.224225Изменено в версии 3.6: Добавлена опция `'_'` (см. также [**PEP 515**](https://python-all.ru/3.10/library/string.html)).226227*width* – десятичное целое число, определяющее минимальную общую ширину поля, включая любые префиксы, разделители и другие форматирующие символы. Если не указано, ширина поля определяется содержимым.228229Если явное выравнивание не задано, перед полем *width* с символом ноля (`'0'`) включается знако-зависимое заполнение нулями для числовых типов. Это эквивалентно символу *fill* равному `'0'` с типом *alignment* равным `'='`.230231Изменено в версии 3.10: Предшествование полю *width* символа `'0'` больше не влияет на выравнивание по умолчанию для строк.232233*precision* – это десятичное целое число, указывающее, сколько цифр должно отображаться после десятичной точки для типов представления `'f'` и `'F'`, или до и после десятичной точки для типов представления `'g'` или `'G'`. Для строковых типов представления это поле указывает максимальный размер поля – иными словами, сколько символов будет использовано из содержимого поля. *precision* не допускается для целочисленных типов представления.234235Наконец, *тип* определяет, как должны быть представлены данные.236237Доступные типы представления для строк:238239> | Тип | Значение |240> | --- | --- |241> | `'s'` | Формат строки. Это тип по умолчанию для строк и может быть опущен. |242> | None | То же, что и `'s'`. |243244Доступные типы представления для целых чисел:245246> | Тип | Значение |247> | --- | --- |248> | `'b'` | Двоичный формат. Выводит число в системе с основанием 2. |249> | `'c'` | Символ. Преобразует целое число в соответствующий символ Юникода перед выводом. |250> | `'d'` | Десятичное целое. Выводит число в системе с основанием 10. |251> | `'o'` | Восьмеричный формат. Выводит число в системе с основанием 8. |252> | `'x'` | Шестнадцатеричный формат. Выводит число в системе с основанием 16, используя строчные буквы для цифр больше 9. |253> | `'X'` | Шестнадцатеричный формат. Выводит число в системе с основанием 16, используя заглавные буквы для цифр больше 9. Если указан `'#'`, префикс `'0x'` также будет приведён к верхнему регистру `'0X'`. |254> | `'n'` | Число. То же, что и `'d'`, за исключением того, что для вставки соответствующих разделителей групп разрядов используется текущая локаль. |255> | None | То же, что и `'d'`. |256257В дополнение к указанным выше типам представления целые числа можно форматировать с помощью типов представления чисел с плавающей запятой, перечисленных ниже (кроме `'n'` и `None`). В этом случае для преобразования целого числа в число с плавающей запятой перед форматированием используется [`float()`](https://python-all.ru/3.10/library/functions.html#float).258259Доступные типы представления для значений [`float`](https://python-all.ru/3.10/library/functions.html#float) и [`Decimal`](https://python-all.ru/3.10/library/decimal.html#decimal.Decimal):260261> | Тип | Значение |262> | --- | --- |263> | `'e'` | Научная нотация. Для заданной точности `p`, форматирует число в научной нотации с буквой «e», разделяющей мантиссу и показатель степени. Мантисса содержит одну цифру до и `p` цифр после десятичной точки, всего `p + 1` значащих цифр. Если точность не указана, используется точность `6` цифр после десятичной точки для [`float`](https://python-all.ru/3.10/library/functions.html#float), и показываются все цифры мантиссы для [`Decimal`](https://python-all.ru/3.10/library/decimal.html#decimal.Decimal). Если после десятичной точки нет цифр, десятичная точка также удаляется, если не используется параметр `#`. |264> | `'E'` | Экспоненциальная запись. То же, что и `'e'`, за исключением использования заглавной буквы 'E' в качестве разделителя. |265> | `'f'` | Нотация с фиксированной точкой. Для заданной точности `p`, форматирует число как десятичное число с ровно `p` цифрами после десятичной точки. Если точность не указана, используется точность `6` цифр после десятичной точки для [`float`](https://python-all.ru/3.10/library/functions.html#float), и используется точность, достаточная для отображения всех цифр мантиссы для [`Decimal`](https://python-all.ru/3.10/library/decimal.html#decimal.Decimal). Если после десятичной точки нет цифр, десятичная точка также удаляется, если не используется параметр `#`. |266> | `'F'` | Фиксированная запись. То же, что и `'f'`, но преобразует `nan` в `NAN`, а `inf` в `INF`. |267> | `'g'` | Общий формат. Для заданной точности `p >= 1` округляет число до `p` значащих цифр, а затем форматирует результат в фиксированном формате или в экспоненциальной записи в зависимости от его величины. Точность `0` считается эквивалентной точности `1`. Точные правила следующие: предположим, что результат, отформатированный с типом представления `'e'` и точностью `p-1`, имеет порядок `exp`. Тогда, если `m <= exp < p`, где `m` равно -4 для чисел с плавающей запятой и -6 для [`Decimals`](https://python-all.ru/3.10/library/decimal.html#decimal.Decimal), число форматируется с типом представления `'f'` и точностью `p-1-exp`. В противном случае число форматируется с типом представления `'e'` и точностью `p-1`. В обоих случаях незначащие конечные нули удаляются из мантиссы, а десятичная точка также удаляется, если после неё не осталось цифр, если только не используется опция `'#'`. Если точность не задана, используется точность `6` значащих цифр для [`float`](https://python-all.ru/3.10/library/functions.html#float). Для [`Decimal`](https://python-all.ru/3.10/library/decimal.html#decimal.Decimal) мантисса результата формируется из цифр мантиссы значения; экспоненциальная запись используется для значений, меньших `1e-6` по абсолютной величине, и значений, где разряд наименьшей значащей цифры больше 1, в противном случае используется фиксированная запись. Положительная и отрицательная бесконечность, положительный и отрицательный ноль, а также nan форматируются как `inf`, `-inf`, `0`, `-0` и `nan` соответственно, независимо от точности. |268> | `'G'` | Общий формат. То же, что и `'g'`, за исключением того, что переключается на `'E'`, если число становится слишком большим. Представления бесконечности и NaN также переводятся в верхний регистр. |269> | `'n'` | Число. То же, что и `'g'`, за исключением того, что для вставки соответствующих разделителей групп разрядов используется текущая локаль. |270> | `'%'` | Проценты. Умножает число на 100 и выводит в фиксированном формате (`'f'`) с последующим знаком процента. |271> | None | Для [`float`](https://python-all.ru/3.10/library/functions.html#float) это то же самое, что и `'g'`, за исключением того, что при использовании нотации с фиксированной точкой для форматирования результата, он всегда содержит по крайней мере одну цифру после десятичной точки. Используемая точность настолько велика, насколько необходимо для точного представления заданного значения. Для [`Decimal`](https://python-all.ru/3.10/library/decimal.html#decimal.Decimal) это то же самое, что `'g'` или `'G'`, в зависимости от значения `context.capitals` для текущего десятичного контекста. Общий эффект заключается в соответствии выходным данным [`str()`](https://python-all.ru/3.10/library/stdtypes.html#str), изменённым другими модификаторами форматирования. |272273### Примеры форматирования274275Этот раздел содержит примеры синтаксиса [`str.format()`](https://python-all.ru/3.10/library/stdtypes.html#str.format) и сравнение со старым форматированием `%`.276277В большинстве случаев синтаксис похож на старое форматирование `%`, с добавлением `{}` и использованием `:` вместо `%`. Например, `'%03.2f'` можно преобразовать в `'{:03.2f}'`.278279Новый синтаксис форматирования также поддерживает новые и другие параметры, показанные в следующих примерах.280281Доступ к аргументам по позиции:282283```python284>>> '{0}, {1}, {2}'.format('a', 'b', 'c')285'a, b, c'286>>> '{}, {}, {}'.format('a', 'b', 'c') # Только для версии 3.1+287'a, b, c'288>>> '{2}, {1}, {0}'.format('a', 'b', 'c')289'c, b, a'290>>> '{2}, {1}, {0}'.format(*'abc') # Распаковка последовательности аргументов291'c, b, a'292>>> '{0}{1}{0}'.format('abra', 'cad') # индексы аргументов могут повторяться293'abracadabra'294```295296Доступ к аргументам по имени:297298```python299>>> 'Coordinates: {latitude}, {longitude}'.format(latitude='37.24N', longitude='-115.81W')300'Coordinates: 37.24N, -115.81W'301>>> coord = {'latitude': '37.24N', 'longitude': '-115.81W'}302>>> 'Coordinates: {latitude}, {longitude}'.format(**coord)303'Coordinates: 37.24N, -115.81W'304```305306Доступ к атрибутам аргументов:307308```python309>>> c = 3-5j310>>> ('The complex number {0} is formed from the real part {0.real} '311... 'and the imaginary part {0.imag}.').format(c)312'The complex number (3-5j) is formed from the real part 3.0 and the imaginary part -5.0.'313>>> class Point:314... def __init__(self, x, y):315... self.x, self.y = x, y316... def __str__(self):317... return 'Point({self.x}, {self.y})'.format(self=self)318...319>>> str(Point(4, 2))320'Point(4, 2)'321```322323Доступ к элементам аргументов:324325```python326>>> coord = (3, 5)327>>> 'X: {0[0]}; Y: {0[1]}'.format(coord)328'X: 3; Y: 5'329```330331Замена `%s` и `%r`:332333```python334>>> "repr() shows quotes: {!r}; str() doesn't: {!s}".format('test1', 'test2')335"repr() shows quotes: 'test1'; str() doesn't: test2"336```337338Выравнивание текста и указание ширины:339340```python341>>> '{:<30}'.format('left aligned')342'left aligned '343>>> '{:>30}'.format('right aligned')344' right aligned'345>>> '{:^30}'.format('centered')346' centered '347>>> '{:*^30}'.format('centered') # использовать '*' в качестве символа заполнения348'***********centered***********'349```350351Замена `%+f`, `%-f` и `% f` и указание знака:352353```python354>>> '{:+f}; {:+f}'.format(3.14, -3.14) # отображать всегда355'+3.140000; -3.140000'356>>> '{: f}; {: f}'.format(3.14, -3.14) # для положительных чисел отображать пробел357' 3.140000; -3.140000'358>>> '{:-f}; {:-f}'.format(3.14, -3.14) # отображать только минус – то же, что и '{:f}; {:f}'359'3.140000; -3.140000'360```361362Замена `%x` и `%o` и преобразование значения в разные системы счисления:363364```python365>>> # format также поддерживает двоичные числа366>>> "int: {0:d}; hex: {0:x}; oct: {0:o}; bin: {0:b}".format(42)367'int: 42; hex: 2a; oct: 52; bin: 101010'368>>> # с префиксом 0x, 0o или 0b:369>>> "int: {0:d}; hex: {0:#x}; oct: {0:#o}; bin: {0:#b}".format(42)370'int: 42; hex: 0x2a; oct: 0o52; bin: 0b101010'371```372373Использование запятой в качестве разделителя тысяч:374375```python376>>> '{:,}'.format(1234567890)377'1,234,567,890'378```379380Выражение процентов:381382```python383>>> points = 19384>>> total = 22385>>> 'Correct answers: {:.2%}'.format(points/total)386'Correct answers: 86.36%'387```388389Использование форматирования с учётом типа:390391```python392>>> import datetime393>>> d = datetime.datetime(2010, 7, 4, 12, 15, 58)394>>> '{:%Y-%m-%d %H:%M:%S}'.format(d)395'2010-07-04 12:15:58'396```397398Вложенные аргументы и более сложные примеры:399400```python401>>> for align, text in zip('<^>', ['left', 'center', 'right']):402... '{0:{fill}{align}16}'.format(text, fill=align, align=align)403...404'left<<<<<<<<<<<<'405'^^^^^center^^^^^'406'>>>>>>>>>>>right'407>>>408>>> octets = [192, 168, 0, 1]409>>> '{:02X}{:02X}{:02X}{:02X}'.format(*octets)410'C0A80001'411>>> int(_, 16)4123232235521413>>>414>>> width = 5415>>> for num in range(5,12): 416... for base in 'dXob':417... print('{0:{width}{base}}'.format(num, base=base, width=width), end=' ')418... print()419...420 5 5 5 101421 6 6 6 110422 7 7 7 111423 8 8 10 1000424 9 9 11 1001425 10 A 12 1010426 11 B 13 1011427```428429## Шаблонные строки430431Шаблонные строки предоставляют более простые подстановки строк, как описано в [**PEP 292**](https://python-all.ru/3.10/library/string.html). Основной вариант использования шаблонных строк – интернационализация (i18n), поскольку в этом контексте более простой синтаксис и функциональность упрощают перевод по сравнению с другими встроенными средствами форматирования строк в Python. В качестве примера библиотеки, построенной на шаблонных строках для i18n, см. пакет [flufl.i18n](https://python-all.ru/3.10/library/string.html).432433Шаблонные строки поддерживают подстановки на основе `$`, используя следующие правила:434435- `$$` – это escape-последовательность; она заменяется на один символ `$`.436- `$identifier` обозначает заполнитель подстановки, соответствующий ключу отображения `"identifier"`. По умолчанию `"identifier"` ограничивается любой алфавитно-цифровой строкой ASCII без учёта регистра (включая подчёркивания), которая начинается с подчёркивания или буквы ASCII. Первый символ, не являющийся идентификатором, после символа `$` завершает спецификацию этого заполнителя.437- `${identifier}` эквивалентно `$identifier`. Это необходимо, когда после заполнителя следуют допустимые символы идентификатора, не являющиеся частью заполнителя, например `"${noun}ification"`.438439Любое другое появление `$` в строке приведёт к вызову исключения [`ValueError`](https://python-all.ru/3.10/library/exceptions.html#ValueError).440441Модуль [`string`](https://python-all.ru/3.10/library/string.html#module-string) предоставляет класс [`Template`](https://python-all.ru/3.10/library/string.html#string.Template), реализующий эти правила. Методы [`Template`](https://python-all.ru/3.10/library/string.html#string.Template):442443#### `class string.Template(template)`444445Конструктор принимает единственный аргумент – строку шаблона.446447#### `substitute(mapping={}, /, **kwds)`448449Выполняет подстановку в шаблон, возвращая новую строку. *mapping* – это любой объект, подобный словарю, ключи которого соответствуют плейсхолдерам в шаблоне. В качестве альтернативы можно указать именованные аргументы, где имена аргументов являются плейсхолдерами. Если указаны и *mapping*, и *kwds*, и есть дубликаты, то плейсхолдеры из *kwds* имеют приоритет.450451#### `safe_substitute(mapping={}, /, **kwds)`452453Как и [`substitute()`](https://python-all.ru/3.10/library/string.html#string.Template.substitute), за исключением того, что если плейсхолдеры отсутствуют в *mapping* и *kwds*, то вместо возбуждения исключения [`KeyError`](https://python-all.ru/3.10/library/exceptions.html#KeyError) исходный плейсхолдер остаётся в результирующей строке без изменений. Кроме того, в отличие от [`substitute()`](https://python-all.ru/3.10/library/string.html#string.Template.substitute), любые другие появления `$` просто возвращают `$`, а не возбуждают [`ValueError`](https://python-all.ru/3.10/library/exceptions.html#ValueError).454455Хотя другие исключения всё ещё могут возникать, этот метод называется «безопасным», потому что он всегда старается вернуть пригодную строку вместо возбуждения исключения. В другом смысле [`safe_substitute()`](https://python-all.ru/3.10/library/string.html#string.Template.safe_substitute) может быть чем угодно, кроме безопасного, поскольку он молча игнорирует некорректные шаблоны, содержащие висячие разделители, непарные скобки или плейсхолдеры, не являющиеся допустимыми идентификаторами Python.456457Экземпляры [`Template`](https://python-all.ru/3.10/library/string.html#string.Template) также предоставляют один открытый атрибут данных:458459#### `template`460461Это объект, переданный в аргумент *template* конструктора. В общем случае его не следует изменять, но доступ только для чтения не гарантируется.462463Вот пример использования Template:464465```python466>>> from string import Template467>>> s = Template('$who likes $what')468>>> s.substitute(who='tim', what='kung pao')469'tim likes kung pao'470>>> d = dict(who='tim')471>>> Template('Give $who $100').substitute(d)472Traceback (most recent call last):473...474ValueError: Invalid placeholder in string: line 1, col 11475>>> Template('$who likes $what').substitute(d)476Traceback (most recent call last):477...478KeyError: 'what'479>>> Template('$who likes $what').safe_substitute(d)480'tim likes $what'481```482483Расширенное использование: можно создать подклассы [`Template`](https://python-all.ru/3.10/library/string.html#string.Template), чтобы настроить синтаксис плейсхолдеров, символ разделителя или всё регулярное выражение, используемое для разбора шаблонных строк. Для этого можно переопределить следующие атрибуты класса:484485- *delimiter* – это буквальная строка, описывающая разделитель, вводящий плейсхолдер. Значение по умолчанию – `$`. Обратите внимание, что это *не* должно быть регулярным выражением, так как реализация будет вызывать [`re.escape()`](https://python-all.ru/3.10/library/re.html#re.escape) для этой строки по мере необходимости. Кроме того, нельзя изменить разделитель после создания класса (т.е. другой разделитель должен быть задан в пространстве имён подкласса).486- *idpattern* – это регулярное выражение, описывающее шаблон для плейсхолдеров без скобок. Значение по умолчанию – регулярное выражение `(?a:[_a-z][_a-z0-9]*)`. Если оно задано, а *braceidpattern* равно `None`, то этот шаблон будет также применяться к плейсхолдерам в скобках.487488 > **Примечание**489 >490 > Поскольку значение по умолчанию *flags* равно `re.IGNORECASE`, шаблон `[a-z]` может совпадать с некоторыми не ASCII-символами. Вот почему здесь используется локальный флаг `a`.491492 Изменено в версии 3.7: *braceidpattern* можно использовать для определения отдельных шаблонов, используемых внутри и снаружи скобок.493- *braceidpattern* – похож на *idpattern*, но описывает шаблон для плейсхолдеров в скобках. По умолчанию `None`, что означает возврат к *idpattern* (т.е. один и тот же шаблон используется как внутри, так и вне скобок). Если задан, это позволяет определить разные шаблоны для плейсхолдеров в скобках и без скобок.494495 Добавлено в версии 3.7.496- *flags* – флаги регулярного выражения, которые будут применяться при компиляции регулярного выражения, используемого для распознавания подстановок. Значение по умолчанию – `re.IGNORECASE`. Обратите внимание, что `re.VERBOSE` всегда будет добавляться к флагам, поэтому пользовательские *idpattern* должны соответствовать соглашениям для многострочных регулярных выражений.497498 Новое в версии 3.2.499500В качестве альтернативы можно указать всё регулярное выражение, переопределив атрибут класса *pattern*. Если это сделать, значение должно быть объектом регулярного выражения с четырьмя именованными захватывающими группами. Эти группы соответствуют правилам, приведённым выше, а также правилу недопустимых плейсхолдеров:501502- *escaped* – эта группа соответствует управляющей последовательности, например `$$`, в шаблоне по умолчанию.503- *named* – эта группа соответствует имени плейсхолдера без скобок; она не должна включать разделитель в захватывающую группу.504- *braced* – эта группа соответствует имени плейсхолдера, заключённого в скобки; она не должна включать ни разделитель, ни скобки в захватывающую группу.505- *invalid* – эта группа соответствует любому другому шаблону разделителя (обычно одиночному разделителю), и она должна появляться последней в регулярном выражении.506507## Вспомогательные функции508509#### `string.capwords(s, sep=None)`510511Разбивает аргумент на слова, используя [`str.split()`](https://python-all.ru/3.10/library/stdtypes.html#str.split), делает заглавной первую букву каждого слова с помощью [`str.capitalize()`](https://python-all.ru/3.10/library/stdtypes.html#str.capitalize) и объединяет слова, начинающиеся с заглавной буквы, используя [`str.join()`](https://python-all.ru/3.10/library/stdtypes.html#str.join). Если необязательный второй аргумент *sep* отсутствует или равен `None`, последовательности пробельных символов заменяются одним пробелом, а начальные и конечные пробелы удаляются; в противном случае *sep* используется для разбиения и объединения слов.512