string.md
1> **Источник:** https://python-all.ru/3.7/library/string.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# [`string`](https://python-all.ru/3.7/library/string.html#module-string) – Общие операции со строками89**Исходный код:** [Lib/string.py](https://python-all.ru/src/3.7/Lib/string.py)1011---1213> **См. также**14>15> [Тип текстовой последовательности – str](https://python-all.ru/3.7/library/stdtypes.html#textseq)16>17> [Методы строк](https://python-all.ru/3.7/library/stdtypes.html#string-methods)1819## Константы строк2021Константы, определённые в этом модуле:2223#### `string.ascii_letters`2425Конкатенация констант [`ascii_lowercase`](https://python-all.ru/3.7/library/string.html#string.ascii_lowercase) и [`ascii_uppercase`](https://python-all.ru/3.7/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.7/library/string.html#string.digits), [`ascii_letters`](https://python-all.ru/3.7/library/string.html#string.ascii_letters), [`punctuation`](https://python-all.ru/3.7/library/string.html#string.punctuation), и [`whitespace`](https://python-all.ru/3.7/library/string.html#string.whitespace).5455#### `string.whitespace`5657Строка, содержащая все ASCII-символы, которые считаются пробельными. Включает символы: пробел, табуляция, перевод строки, возврат каретки, прогон страницы и вертикальная табуляция.5859## Пользовательское форматирование строк6061Встроенный класс строк предоставляет возможность выполнять сложные замены переменных и форматирование значений с помощью метода [`format()`](https://python-all.ru/3.7/library/stdtypes.html#str.format), описанного в [**PEP 3101**](https://python-all.ru/3.7/library/string.html). Класс [`Formatter`](https://python-all.ru/3.7/library/string.html#string.Formatter) из модуля [`string`](https://python-all.ru/3.7/library/string.html#module-string) позволяет создавать и настраивать собственное поведение форматирования строк, используя ту же реализацию, что и встроенный метод [`format()`](https://python-all.ru/3.7/library/stdtypes.html#str.format).6263#### `class string.Formatter`6465Класс [`Formatter`](https://python-all.ru/3.7/library/string.html#string.Formatter) имеет следующие открытые методы:6667#### `format(format_string, *args, **kwargs)`6869Основной метод API. Принимает строку форматирования и произвольный набор позиционных и именованных аргументов. Это просто обёртка, вызывающая [`vformat()`](https://python-all.ru/3.7/library/string.html#string.Formatter.vformat).7071Изменено в версии 3.7: Аргумент строки форматирования теперь является [только позиционным](https://python-all.ru/3.7/glossary.html#positional-only-parameter).7273#### `vformat(format_string, args, kwargs)`7475Эта функция выполняет фактическую работу по форматированию. Она представлена как отдельная функция на случай, если нужно передать предопределённый словарь аргументов, вместо распаковки и повторной упаковки словаря в отдельные аргументы с помощью синтаксиса `*args` и `**kwargs`. [`vformat()`](https://python-all.ru/3.7/library/string.html#string.Formatter.vformat) выполняет разбивку строки форматирования на символьные данные и поля замены. Затем вызываются различные методы, описанные ниже.7677Кроме того, [`Formatter`](https://python-all.ru/3.7/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.7/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.7/library/string.html#string.Formatter.parse) (см. выше), преобразует его в объект для форматирования. Возвращает кортеж (obj, used\_key). По умолчанию принимает строки вида, определённого в [**PEP 3101**](https://python-all.ru/3.7/library/string.html), например, “0\[name\]” или “label.title”. *args* и *kwargs* передаются так же, как в [`vformat()`](https://python-all.ru/3.7/library/string.html#string.Formatter.vformat). Возвращаемое значение *used\_key* имеет тот же смысл, что параметр *key* у [`get_value()`](https://python-all.ru/3.7/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.7/library/string.html#string.Formatter.vformat), а параметр *kwargs* – в словарь именованных аргументов.9495Для составных имён полей эти функции вызываются только для первого компонента имени поля; последующие компоненты обрабатываются через обычные операции с атрибутами и индексацией.9697Например, выражение поля «0.name» вызовет [`get_value()`](https://python-all.ru/3.7/library/string.html#string.Formatter.get_value) с аргументом *key*, равным 0. Атрибут `name` будет получен после возврата из [`get_value()`](https://python-all.ru/3.7/library/string.html#string.Formatter.get_value) вызовом встроенной функции [`getattr()`](https://python-all.ru/3.7/library/functions.html#getattr).9899Если индекс или ключевое слово ссылаются на несуществующий элемент, должно быть возбуждено исключение [`IndexError`](https://python-all.ru/3.7/library/exceptions.html#IndexError) или [`KeyError`](https://python-all.ru/3.7/library/exceptions.html#KeyError).100101#### `check_unused_args(used_args, args, kwargs)`102103Реализует проверку на неиспользованные аргументы при необходимости. Аргументы этой функции – множество всех ключей аргументов, которые фактически были использованы в строке форматирования (целые числа для позиционных аргументов и строки для именованных), а также ссылка на *args* и *kwargs*, переданные в vformat. Множество неиспользованных аргументов можно вычислить по этим параметрам. Предполагается, что [`check_unused_args()`](https://python-all.ru/3.7/library/string.html#string.Formatter.check_unused_args) возбуждает исключение, если проверка не пройдена.104105#### `format_field(value, format_spec)`106107[`format_field()`](https://python-all.ru/3.7/library/string.html#string.Formatter.format_field) просто вызывает глобальную встроенную функцию [`format()`](https://python-all.ru/3.7/library/functions.html#format). Метод предоставлен, чтобы подклассы могли переопределить его.108109#### `convert_field(value, conversion)`110111Преобразует значение (возвращённое [`get_field()`](https://python-all.ru/3.7/library/string.html#string.Formatter.get_field)) с учётом типа преобразования (как в кортеже, возвращаемом методом [`parse()`](https://python-all.ru/3.7/library/string.html#string.Formatter.parse)). Версия по умолчанию понимает типы преобразования 's' (str), 'r' (repr) и 'a' (ascii).112113## Синтаксис строки формата114115Метод [`str.format()`](https://python-all.ru/3.7/library/stdtypes.html#str.format) и класс [`Formatter`](https://python-all.ru/3.7/library/string.html#string.Formatter) используют одинаковый синтаксис для строк форматирования (хотя в случае [`Formatter`](https://python-all.ru/3.7/library/string.html#string.Formatter) подклассы могут определять свой собственный синтаксис строк форматирования). Этот синтаксис родственен синтаксису [форматированных строковых литералов](https://python-all.ru/3.7/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.7/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.7/library/functions.html#getattr), а выражение вида `'[index]'` выполняет поиск по индексу с помощью [`__getitem__()`](https://python-all.ru/3.7/reference/datamodel.html#object.__getitem__).138139Изменено в версии 3.1: Спецификаторы позиционных аргументов можно опускать для [`str.format()`](https://python-all.ru/3.7/library/stdtypes.html#str.format), поэтому `'{} {}'.format(a, b)` эквивалентно `'{0} {1}'.format(a, b)`.140141Изменено в версии 3.4: Спецификаторы позиционных аргументов можно опускать для [`Formatter`](https://python-all.ru/3.7/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__()`](https://python-all.ru/3.7/reference/datamodel.html#object.__format__). Однако в некоторых случаях требуется принудительно отформатировать тип как строку, переопределяя его собственное определение форматирования. Преобразовав значение в строку перед вызовом [`__format__()`](https://python-all.ru/3.7/reference/datamodel.html#object.__format__), можно обойти обычную логику форматирования.155156В настоящее время поддерживаются три флага преобразования: `'!s'` вызывает [`str()`](https://python-all.ru/3.7/library/stdtypes.html#str) для значения, `'!r'` вызывает [`repr()`](https://python-all.ru/3.7/library/functions.html#repr), и `'!a'` вызывает [`ascii()`](https://python-all.ru/3.7/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.7/library/string.html#formatexamples) для примеров.173174### Мини-язык спецификации формата175176«Спецификации формата» используются в полях замены внутри строки форматирования для определения того, как отдельные значения представляются (см. [Синтаксис строки форматирования](https://python-all.ru/3.7/library/string.html#formatstrings) и [Форматированные строковые литералы](https://python-all.ru/3.7/reference/lexical_analysis.html#f-strings)). Они также могут передаваться напрямую встроенной функции [`format()`](https://python-all.ru/3.7/library/functions.html#format). Каждый форматируемый тип может определять, как следует интерпретировать спецификацию формата.177178Большинство встроенных типов реализуют следующие параметры для спецификаций формата, хотя некоторые параметры форматирования поддерживаются только числовыми типами.179180Пустая спецификация формата даёт тот же результат, что и вызов [`str()`](https://python-all.ru/3.7/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.7/reference/lexical_analysis.html#f-strings) или при использовании метода [`str.format()`](https://python-all.ru/3.7/library/stdtypes.html#str.format). Однако можно вставить фигурную скобку с помощью вложенного поля подстановки. Это ограничение не влияет на функцию [`format()`](https://python-all.ru/3.7/library/functions.html#format).197198Значение различных параметров выравнивания следующее:199200> | Параметр | Значение |201> | --- | --- |202> | `'<'` | Выравнивает поле по левому краю в пределах доступного пространства (это значение по умолчанию для большинства объектов). |203> | `'>'` | Выравнивает поле по правому краю в пределах доступного пространства (это значение по умолчанию для чисел). |204> | `'='` | Принудительно размещает отступ после знака (если он есть), но перед цифрами. Используется для вывода полей в формате ‘+000000120’. Эта опция выравнивания действительна только для числовых типов. Она становится значением по умолчанию, когда ‘0’ непосредственно предшествует ширине поля. |205> | `'^'` | Выравнивает поле по центру в пределах доступного пространства. |206207Обратите внимание, что если не задана минимальная ширина поля, ширина поля всегда будет равна размеру заполняемых данных, поэтому в этом случае параметр выравнивания не имеет смысла.208209Параметр *sign* допустим только для числовых типов и может быть одним из следующих:210211> | Параметр | Значение |212> | --- | --- |213> | `'+'` | указывает, что знак должен выводиться как для положительных, так и для отрицательных чисел. |214> | `'-'` | указывает, что знак должен выводиться только для отрицательных чисел (это поведение по умолчанию). |215> | пробел | указывает, что перед положительными числами должен ставиться пробел, а перед отрицательными – знак минус. |216217Опция `'#'` приводит к использованию «альтернативной формы» для преобразования. Альтернативная форма определяется по-разному для разных типов. Эта опция действительна только для целых чисел, чисел с плавающей запятой, комплексных чисел и типа Decimal. Для целых чисел при использовании двоичного, восьмеричного или шестнадцатеричного вывода эта опция добавляет к выходному значению соответствующий префикс `'0b'`, `'0o'` или `'0x'`. Для чисел с плавающей запятой, комплексных чисел и Decimal альтернативная форма приводит к тому, что результат преобразования всегда содержит символ десятичной точки, даже если за ним не следует цифр. Обычно символ десятичной точки появляется в результате этих преобразований только если за ним следует цифра. Кроме того, для преобразований `'g'` и `'G'` хвостовые нули не удаляются из результата.218219Параметр `','` указывает на использование запятой в качестве разделителя тысяч. Для разделителя, учитывающего локаль, используйте тип представления целых чисел `'n'`.220221Изменено в версии 3.1: Добавлена опция `','` (см. также [**PEP 378**](https://python-all.ru/3.7/library/string.html)).222223Параметр `'_'` указывает на использование символа подчёркивания в качестве разделителя тысяч для типов представления чисел с плавающей запятой и для типа представления целых чисел `'d'`. Для типов представления целых чисел `'b'`, `'o'`, `'x'` и `'X'` символы подчёркивания вставляются через каждые 4 цифры. Для других типов представления указание этого параметра является ошибкой.224225Изменено в версии 3.6: Добавлена опция `'_'` (см. также [**PEP 515**](https://python-all.ru/3.7/library/string.html)).226227*width* – десятичное целое число, определяющее минимальную общую ширину поля, включая любые префиксы, разделители и другие форматирующие символы. Если не указано, ширина поля определяется содержимым.228229Если явное выравнивание не задано, перед полем *width* с символом ноля (`'0'`) включается знако-зависимое заполнение нулями для числовых типов. Это эквивалентно символу *fill* равному `'0'` с типом *alignment* равным `'='`.230231Параметр *precision* – десятичное число, указывающее, сколько цифр должно быть отображено после десятичной точки для значения с плавающей запятой, отформатированного с помощью `'f'` и `'F'`, или до и после десятичной точки для значения с плавающей запятой, отформатированного с помощью `'g'` или `'G'`. Для нечисловых типов этот параметр указывает максимальный размер поля – другими словами, сколько символов будет использовано из содержимого поля. Параметр *precision* не допускается для целых чисел.232233Наконец, *тип* определяет, как должны быть представлены данные.234235Доступные типы представления для строк:236237> | Тип | Значение |238> | --- | --- |239> | `'s'` | Формат строки. Это тип по умолчанию для строк и может быть опущен. |240> | None | То же, что и `'s'`. |241242Доступные типы представления для целых чисел:243244> | Тип | Значение |245> | --- | --- |246> | `'b'` | Двоичный формат. Выводит число в системе с основанием 2. |247> | `'c'` | Символ. Преобразует целое число в соответствующий символ Юникода перед выводом. |248> | `'d'` | Десятичное целое. Выводит число в системе с основанием 10. |249> | `'o'` | Восьмеричный формат. Выводит число в системе с основанием 8. |250> | `'x'` | Шестнадцатеричный формат. Выводит число в системе с основанием 16, используя строчные буквы для цифр больше 9. |251> | `'X'` | Шестнадцатеричный формат. Выводит число по основанию 16, используя заглавные буквы для цифр от 10 до 15. |252> | `'n'` | Число. То же, что и `'d'`, за исключением того, что для вставки соответствующих разделителей групп разрядов используется текущая локаль. |253> | None | То же, что и `'d'`. |254255В дополнение к указанным выше типам представления целые числа можно форматировать с помощью типов представления чисел с плавающей запятой, перечисленных ниже (кроме `'n'` и `None`). В этом случае для преобразования целого числа в число с плавающей запятой перед форматированием используется [`float()`](https://python-all.ru/3.7/library/functions.html#float).256257Доступные типы представления для чисел с плавающей запятой и десятичных чисел:258259> | Тип | Значение |260> | --- | --- |261> | `'e'` | Экспоненциальная запись. Выводит число в научной нотации, используя букву 'e' для обозначения показателя степени. Точность по умолчанию – `6`. |262> | `'E'` | Экспоненциальная запись. То же, что и `'e'`, за исключением того, что в качестве разделителя используется прописная буква 'E'. |263> | `'f'` | Запись с фиксированной точкой. Отображает число как число с фиксированной точкой. Точность по умолчанию – `6`. |264> | `'F'` | Фиксированная запись. То же, что и `'f'`, но преобразует `nan` в `NAN`, а `inf` в `INF`. |265> | `'g'` | Общий формат. Для заданной точности `p >= 1` округляет число до `p` значащих цифр, а затем форматирует результат либо в формате с фиксированной точкой, либо в научной нотации, в зависимости от его величины. Точные правила таковы: предположим, что результат, отформатированный с типом представления `'e'` и точностью `p-1`, имеет показатель степени `exp`. Тогда если `-4 <= exp < p`, число форматируется с типом представления `'f'` и точностью `p-1-exp`. В противном случае число форматируется с типом представления `'e'` и точностью `p-1`. В обоих случаях незначащие хвостовые нули удаляются из мантиссы, а десятичная точка также удаляется, если после неё не остаётся цифр, если только не используется опция `'#'`. Положительная и отрицательная бесконечность, положительный и отрицательный ноль, а также nan форматируются как `inf`, `-inf`, `0`, `-0` и `nan` соответственно, независимо от точности. Точность `0` считается эквивалентной точности `1`. Точность по умолчанию – `6`. |266> | `'G'` | Общий формат. То же, что и `'g'`, за исключением того, что переключается на `'E'`, если число становится слишком большим. Представления бесконечности и NaN также переводятся в верхний регистр. |267> | `'n'` | Число. То же, что и `'g'`, за исключением того, что для вставки соответствующих разделителей групп разрядов используется текущая локаль. |268> | `'%'` | Проценты. Умножает число на 100 и выводит в фиксированном формате (`'f'`) с последующим знаком процента. |269> | None | Аналогично `'g'`, за исключением того, что запись с фиксированной точкой, при использовании, содержит хотя бы одну цифру после десятичной точки. Точность по умолчанию настолько высока, насколько необходимо для представления конкретного значения. Общий эффект заключается в том, чтобы соответствовать выводу [`str()`](https://python-all.ru/3.7/library/stdtypes.html#str), изменённому другими модификаторами формата. |270271### Примеры форматирования272273Этот раздел содержит примеры синтаксиса [`str.format()`](https://python-all.ru/3.7/library/stdtypes.html#str.format) и сравнение со старым форматированием `%`.274275В большинстве случаев синтаксис похож на старое форматирование `%`, с добавлением `{}` и использованием `:` вместо `%`. Например, `'%03.2f'` можно преобразовать в `'{:03.2f}'`.276277Новый синтаксис форматирования также поддерживает новые и другие параметры, показанные в следующих примерах.278279Доступ к аргументам по позиции:280281```python282>>> '{0}, {1}, {2}'.format('a', 'b', 'c')283'a, b, c'284>>> '{}, {}, {}'.format('a', 'b', 'c') # Только для версии 3.1+285'a, b, c'286>>> '{2}, {1}, {0}'.format('a', 'b', 'c')287'c, b, a'288>>> '{2}, {1}, {0}'.format(*'abc') # Распаковка последовательности аргументов289'c, b, a'290>>> '{0}{1}{0}'.format('abra', 'cad') # индексы аргументов могут повторяться291'abracadabra'292```293294Доступ к аргументам по имени:295296```python297>>> 'Coordinates: {latitude}, {longitude}'.format(latitude='37.24N', longitude='-115.81W')298'Coordinates: 37.24N, -115.81W'299>>> coord = {'latitude': '37.24N', 'longitude': '-115.81W'}300>>> 'Coordinates: {latitude}, {longitude}'.format(**coord)301'Coordinates: 37.24N, -115.81W'302```303304Доступ к атрибутам аргументов:305306```python307>>> c = 3-5j308>>> ('The complex number {0} is formed from the real part {0.real} '309... 'and the imaginary part {0.imag}.').format(c)310'The complex number (3-5j) is formed from the real part 3.0 and the imaginary part -5.0.'311>>> class Point:312... def __init__(self, x, y):313... self.x, self.y = x, y314... def __str__(self):315... return 'Point({self.x}, {self.y})'.format(self=self)316...317>>> str(Point(4, 2))318'Point(4, 2)'319```320321Доступ к элементам аргументов:322323```python324>>> coord = (3, 5)325>>> 'X: {0[0]}; Y: {0[1]}'.format(coord)326'X: 3; Y: 5'327```328329Замена `%s` и `%r`:330331```python332>>> "repr() shows quotes: {!r}; str() doesn't: {!s}".format('test1', 'test2')333"repr() shows quotes: 'test1'; str() doesn't: test2"334```335336Выравнивание текста и указание ширины:337338```python339>>> '{:<30}'.format('left aligned')340'left aligned '341>>> '{:>30}'.format('right aligned')342' right aligned'343>>> '{:^30}'.format('centered')344' centered '345>>> '{:*^30}'.format('centered') # использовать '*' в качестве символа заполнения346'***********centered***********'347```348349Замена `%+f`, `%-f` и `% f` и указание знака:350351```python352>>> '{:+f}; {:+f}'.format(3.14, -3.14) # отображать всегда353'+3.140000; -3.140000'354>>> '{: f}; {: f}'.format(3.14, -3.14) # для положительных чисел отображать пробел355' 3.140000; -3.140000'356>>> '{:-f}; {:-f}'.format(3.14, -3.14) # отображать только минус – то же, что и '{:f}; {:f}'357'3.140000; -3.140000'358```359360Замена `%x` и `%o` и преобразование значения в разные системы счисления:361362```python363>>> # format также поддерживает двоичные числа364>>> "int: {0:d}; hex: {0:x}; oct: {0:o}; bin: {0:b}".format(42)365'int: 42; hex: 2a; oct: 52; bin: 101010'366>>> # с префиксом 0x, 0o или 0b:367>>> "int: {0:d}; hex: {0:#x}; oct: {0:#o}; bin: {0:#b}".format(42)368'int: 42; hex: 0x2a; oct: 0o52; bin: 0b101010'369```370371Использование запятой в качестве разделителя тысяч:372373```python374>>> '{:,}'.format(1234567890)375'1,234,567,890'376```377378Выражение процентов:379380```python381>>> points = 19382>>> total = 22383>>> 'Correct answers: {:.2%}'.format(points/total)384'Correct answers: 86.36%'385```386387Использование форматирования с учётом типа:388389```python390>>> import datetime391>>> d = datetime.datetime(2010, 7, 4, 12, 15, 58)392>>> '{:%Y-%m-%d %H:%M:%S}'.format(d)393'2010-07-04 12:15:58'394```395396Вложенные аргументы и более сложные примеры:397398```python399>>> for align, text in zip('<^>', ['left', 'center', 'right']):400... '{0:{fill}{align}16}'.format(text, fill=align, align=align)401...402'left<<<<<<<<<<<<'403'^^^^^center^^^^^'404'>>>>>>>>>>>right'405>>>406>>> octets = [192, 168, 0, 1]407>>> '{:02X}{:02X}{:02X}{:02X}'.format(*octets)408'C0A80001'409>>> int(_, 16)4103232235521411>>>412>>> width = 5413>>> for num in range(5,12): 414... for base in 'dXob':415... print('{0:{width}{base}}'.format(num, base=base, width=width), end=' ')416... print()417...418 5 5 5 101419 6 6 6 110420 7 7 7 111421 8 8 10 1000422 9 9 11 1001423 10 A 12 1010424 11 B 13 1011425```426427## Шаблонные строки428429Шаблонные строки предоставляют более простые подстановки строк, как описано в [**PEP 292**](https://python-all.ru/3.7/library/string.html). Основной вариант использования шаблонных строк – интернационализация (i18n), поскольку в этом контексте более простой синтаксис и функциональность упрощают перевод по сравнению с другими встроенными средствами форматирования строк в Python. В качестве примера библиотеки, построенной на шаблонных строках для i18n, см. пакет [flufl.i18n](https://python-all.ru/3.7/library/string.html).430431Шаблонные строки поддерживают подстановки на основе `$`, используя следующие правила:432433- `$$` – это escape-последовательность; она заменяется на один символ `$`.434- `$identifier` обозначает заполнитель подстановки, соответствующий ключу отображения `"identifier"`. По умолчанию `"identifier"` ограничивается любой алфавитно-цифровой строкой ASCII без учёта регистра (включая подчёркивания), которая начинается с подчёркивания или буквы ASCII. Первый символ, не являющийся идентификатором, после символа `$` завершает спецификацию этого заполнителя.435- `${identifier}` эквивалентно `$identifier`. Это необходимо, когда после заполнителя следуют допустимые символы идентификатора, не являющиеся частью заполнителя, например `"${noun}ification"`.436437Любое другое появление `$` в строке приведёт к вызову исключения [`ValueError`](https://python-all.ru/3.7/library/exceptions.html#ValueError).438439Модуль [`string`](https://python-all.ru/3.7/library/string.html#module-string) предоставляет класс [`Template`](https://python-all.ru/3.7/library/string.html#string.Template), реализующий эти правила. Методы [`Template`](https://python-all.ru/3.7/library/string.html#string.Template):440441#### `class string.Template(template)`442443Конструктор принимает единственный аргумент – строку шаблона.444445#### `substitute(mapping, **kwds)`446447Выполняет подстановку в шаблон, возвращая новую строку. *mapping* – это любой объект, подобный словарю, ключи которого соответствуют плейсхолдерам в шаблоне. В качестве альтернативы можно указать именованные аргументы, где имена аргументов являются плейсхолдерами. Если указаны и *mapping*, и *kwds*, и есть дубликаты, то плейсхолдеры из *kwds* имеют приоритет.448449#### `safe_substitute(mapping, **kwds)`450451Как и [`substitute()`](https://python-all.ru/3.7/library/string.html#string.Template.substitute), за исключением того, что если плейсхолдеры отсутствуют в *mapping* и *kwds*, то вместо возбуждения исключения [`KeyError`](https://python-all.ru/3.7/library/exceptions.html#KeyError) исходный плейсхолдер остаётся в результирующей строке без изменений. Кроме того, в отличие от [`substitute()`](https://python-all.ru/3.7/library/string.html#string.Template.substitute), любые другие появления `$` просто возвращают `$`, а не возбуждают [`ValueError`](https://python-all.ru/3.7/library/exceptions.html#ValueError).452453Хотя другие исключения всё ещё могут возникать, этот метод называется «безопасным», потому что он всегда старается вернуть пригодную строку вместо возбуждения исключения. В другом смысле [`safe_substitute()`](https://python-all.ru/3.7/library/string.html#string.Template.safe_substitute) может быть чем угодно, кроме безопасного, поскольку он молча игнорирует некорректные шаблоны, содержащие висячие разделители, непарные скобки или плейсхолдеры, не являющиеся допустимыми идентификаторами Python.454455Экземпляры [`Template`](https://python-all.ru/3.7/library/string.html#string.Template) также предоставляют один открытый атрибут данных:456457#### `template`458459Это объект, переданный в аргумент *template* конструктора. В общем случае его не следует изменять, но доступ только для чтения не гарантируется.460461Вот пример использования Template:462463```python464>>> from string import Template465>>> s = Template('$who likes $what')466>>> s.substitute(who='tim', what='kung pao')467'tim likes kung pao'468>>> d = dict(who='tim')469>>> Template('Give $who $100').substitute(d)470Traceback (most recent call last):471...472ValueError: Invalid placeholder in string: line 1, col 11473>>> Template('$who likes $what').substitute(d)474Traceback (most recent call last):475...476KeyError: 'what'477>>> Template('$who likes $what').safe_substitute(d)478'tim likes $what'479```480481Расширенное использование: можно создать подклассы [`Template`](https://python-all.ru/3.7/library/string.html#string.Template), чтобы настроить синтаксис плейсхолдеров, символ разделителя или всё регулярное выражение, используемое для разбора шаблонных строк. Для этого можно переопределить следующие атрибуты класса:482483- *delimiter* – это буквальная строка, описывающая разделитель, вводящий плейсхолдер. Значение по умолчанию – `$`. Обратите внимание, что это *не* должно быть регулярным выражением, так как реализация будет вызывать [`re.escape()`](https://python-all.ru/3.7/library/re.html#re.escape) для этой строки по мере необходимости. Кроме того, нельзя изменить разделитель после создания класса (т.е. другой разделитель должен быть задан в пространстве имён подкласса).484- *idpattern* – это регулярное выражение, описывающее шаблон для плейсхолдеров без скобок. Значение по умолчанию – регулярное выражение `(?a:[_a-z][_a-z0-9]*)`. Если оно задано, а *braceidpattern* равно `None`, то этот шаблон будет также применяться к плейсхолдерам в скобках.485486 > **Примечание**487 >488 > Поскольку значение по умолчанию *flags* равно `re.IGNORECASE`, шаблон `[a-z]` может совпадать с некоторыми не ASCII-символами. Вот почему здесь используется локальный флаг `a`.489490 Изменено в версии 3.7: *braceidpattern* можно использовать для определения отдельных шаблонов, используемых внутри и снаружи скобок.491- *braceidpattern* – похож на *idpattern*, но описывает шаблон для плейсхолдеров в скобках. По умолчанию `None`, что означает возврат к *idpattern* (т.е. один и тот же шаблон используется как внутри, так и вне скобок). Если задан, это позволяет определить разные шаблоны для плейсхолдеров в скобках и без скобок.492493 Добавлено в версии 3.7.494- *flags* – флаги регулярного выражения, которые будут применяться при компиляции регулярного выражения, используемого для распознавания подстановок. Значение по умолчанию – `re.IGNORECASE`. Обратите внимание, что `re.VERBOSE` всегда будет добавляться к флагам, поэтому пользовательские *idpattern* должны соответствовать соглашениям для многострочных регулярных выражений.495496 Новое в версии 3.2.497498В качестве альтернативы можно указать всё регулярное выражение, переопределив атрибут класса *pattern*. Если это сделать, значение должно быть объектом регулярного выражения с четырьмя именованными захватывающими группами. Эти группы соответствуют правилам, приведённым выше, а также правилу недопустимых плейсхолдеров:499500- *escaped* – эта группа соответствует управляющей последовательности, например `$$`, в шаблоне по умолчанию.501- *named* – эта группа соответствует имени плейсхолдера без скобок; она не должна включать разделитель в захватывающую группу.502- *braced* – эта группа соответствует имени плейсхолдера, заключённого в скобки; она не должна включать ни разделитель, ни скобки в захватывающую группу.503- *invalid* – эта группа соответствует любому другому шаблону разделителя (обычно одиночному разделителю), и она должна появляться последней в регулярном выражении.504505## Вспомогательные функции506507#### `string.capwords(s, sep=None)`508509Разбивает аргумент на слова, используя [`str.split()`](https://python-all.ru/3.7/library/stdtypes.html#str.split), делает заглавной первую букву каждого слова с помощью [`str.capitalize()`](https://python-all.ru/3.7/library/stdtypes.html#str.capitalize) и объединяет слова, начинающиеся с заглавной буквы, используя [`str.join()`](https://python-all.ru/3.7/library/stdtypes.html#str.join). Если необязательный второй аргумент *sep* отсутствует или равен `None`, последовательности пробельных символов заменяются одним пробелом, а начальные и конечные пробелы удаляются; в противном случае *sep* используется для разбиения и объединения слов.510