string.md
1> **Источник:** https://python-all.ru/3.3/library/string.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 6.1. [`string`](https://python-all.ru/3.3/library/string.html#module-string) – Типовые операции со строками89**Исходный код:** [Lib/string.py](https://python-all.ru/src/3.3/Lib/string.py)1011---1213> **См. также**14>15> [*Тип текстовой последовательности – str*](https://python-all.ru/3.3/library/stdtypes.html#textseq)16>17> [*Методы строк*](https://python-all.ru/3.3/library/stdtypes.html#string-methods)1819## 6.1.1. Строковые константы2021Константы, определённые в этом модуле:2223#### `string.ascii_letters`2425Конкатенация констант [`ascii_lowercase`](https://python-all.ru/3.3/library/string.html#string.ascii_lowercase) и [`ascii_uppercase`](https://python-all.ru/3.3/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.3/library/string.html#string.digits), [`ascii_letters`](https://python-all.ru/3.3/library/string.html#string.ascii_letters), [`punctuation`](https://python-all.ru/3.3/library/string.html#string.punctuation) и [`whitespace`](https://python-all.ru/3.3/library/string.html#string.whitespace).5455#### `string.whitespace`5657Строка, содержащая все ASCII-символы, которые считаются пробельными. Включает символы: пробел, табуляция, перевод строки, возврат каретки, прогон страницы и вертикальная табуляция.5859## 6.1.2. Форматирование строк6061Встроенный строковый класс предоставляет возможность выполнения сложных подстановок переменных и форматирования значений с помощью метода [`format()`](https://python-all.ru/3.3/library/functions.html#format), описанного в [**PEP 3101**](https://python-all.ru/3.3/library/string.html). Класс [`Formatter`](https://python-all.ru/3.3/library/string.html#string.Formatter) в модуле [`string`](https://python-all.ru/3.3/library/string.html#module-string) позволяет создавать и настраивать собственное поведение форматирования строк, используя ту же реализацию, что и встроенный метод [`format()`](https://python-all.ru/3.3/library/functions.html#format).6263#### `class string.Formatter`6465Класс [`Formatter`](https://python-all.ru/3.3/library/string.html#string.Formatter) имеет следующие открытые методы:6667#### `format(format_string, *args, **kwargs)`6869[`format()`](https://python-all.ru/3.3/library/functions.html#format) – основной метод API. Он принимает строку формата и произвольный набор позиционных и именованных аргументов. [`format()`](https://python-all.ru/3.3/library/functions.html#format) – это просто обёртка, вызывающая [`vformat()`](https://python-all.ru/3.3/library/string.html#string.Formatter.vformat).7071#### `vformat(format_string, args, kwargs)`7273Эта функция выполняет фактическую работу по форматированию. Она вынесена в отдельную функцию для случаев, когда требуется передать предопределённый словарь аргументов, вместо распаковки и повторной упаковки словаря как отдельных аргументов с помощью синтаксиса `*args` и `**kwargs`. [`vformat()`](https://python-all.ru/3.3/library/string.html#string.Formatter.vformat) выполняет разбиение строки формата на символьные данные и поля подстановки. Она вызывает различные методы, описанные ниже.7475Кроме того, класс [`Formatter`](https://python-all.ru/3.3/library/string.html#string.Formatter) определяет ряд методов, предназначенных для замены в подклассах:7677#### `parse(format_string)`7879Перебирает format\_string и возвращает итератор кортежей (*literal\_text*, *field\_name*, *format\_spec*, *conversion*). Это используется [`vformat()`](https://python-all.ru/3.3/library/string.html#string.Formatter.vformat) для разбиения строки либо на литеральный текст, либо на поля подстановки.8081Значения кортежа концептуально представляют собой отрезок литерального текста, после которого следует одно поле подстановки. Если литерального текста нет (это может произойти, если два поля подстановки следуют подряд), то *literal\_text* будет строкой нулевой длины. Если поле подстановки отсутствует, то значения *field\_name*, *format\_spec* и *conversion* будут равны `None`.8283#### `get_field(field_name, args, kwargs)`8485При заданном *field\_name*, возвращаемом [`parse()`](https://python-all.ru/3.3/library/string.html#string.Formatter.parse) (см. выше), преобразует его в объект для форматирования. Возвращает кортеж (obj, used\_key). Версия по умолчанию принимает строки формы, определённой в [**PEP 3101**](https://python-all.ru/3.3/library/string.html), например "0\[name\]" или "label.title". *args* и *kwargs* передаются в [`vformat()`](https://python-all.ru/3.3/library/string.html#string.Formatter.vformat). Возвращаемое значение *used\_key* имеет тот же смысл, что и параметр *key* для [`get_value()`](https://python-all.ru/3.3/library/string.html#string.Formatter.get_value).8687#### `get_value(key, args, kwargs)`8889Извлекает значение заданного поля. Аргумент *key* может быть целым числом или строкой. Если это целое число, оно представляет индекс позиционного аргумента в *args*; если строка – именованный аргумент в *kwargs*.9091Параметр *args* содержит список позиционных аргументов для [`vformat()`](https://python-all.ru/3.3/library/string.html#string.Formatter.vformat), а параметр *kwargs* – словарь именованных аргументов.9293Для составных имён полей эти функции вызываются только для первого компонента имени поля; последующие компоненты обрабатываются через обычные операции с атрибутами и индексацией.9495Так, например, для поля с выражением ‘0.name’ будет вызвана [`get_value()`](https://python-all.ru/3.3/library/string.html#string.Formatter.get_value) с аргументом *key*, равным 0. Затем атрибут `name` будет получен после возврата [`get_value()`](https://python-all.ru/3.3/library/string.html#string.Formatter.get_value) вызовом встроенной функции [`getattr()`](https://python-all.ru/3.3/library/functions.html#getattr).9697Если индекс или ключевое слово ссылаются на несуществующий элемент, то должно быть возбуждено исключение [`IndexError`](https://python-all.ru/3.3/library/exceptions.html#IndexError) или [`KeyError`](https://python-all.ru/3.3/library/exceptions.html#KeyError).9899#### `check_unused_args(used_args, args, kwargs)`100101Реализует проверку неиспользуемых аргументов (при необходимости). Аргументами этой функции являются множество всех ключей аргументов, которые фактически использовались в строке формата (целые числа для позиционных аргументов и строки для именованных), а также ссылка на *args* и *kwargs*, которые были переданы в vformat. Множество неиспользуемых аргументов можно вычислить из этих параметров. Предполагается, что [`check_unused_args()`](https://python-all.ru/3.3/library/string.html#string.Formatter.check_unused_args) возбуждает исключение, если проверка не проходит.102103#### `format_field(value, format_spec)`104105[`format_field()`](https://python-all.ru/3.3/library/string.html#string.Formatter.format_field) просто вызывает встроенную функцию [`format()`](https://python-all.ru/3.3/library/functions.html#format). Этот метод предусмотрен, чтобы подклассы могли его переопределить.106107#### `convert_field(value, conversion)`108109Преобразует значение (возвращённое [`get_field()`](https://python-all.ru/3.3/library/string.html#string.Formatter.get_field)) по заданному типу преобразования (как в кортеже, возвращённом методом [`parse()`](https://python-all.ru/3.3/library/string.html#string.Formatter.parse)). Стандартная версия понимает типы преобразования 's' (str), 'r' (repr) и 'a' (ascii).110111## 6.1.3. Синтаксис строк форматирования112113Метод [`str.format()`](https://python-all.ru/3.3/library/stdtypes.html#str.format) и класс [`Formatter`](https://python-all.ru/3.3/library/string.html#string.Formatter) используют одинаковый синтаксис строк формата (хотя в случае [`Formatter`](https://python-all.ru/3.3/library/string.html#string.Formatter) подклассы могут определять собственный синтаксис строк формата).114115Строки форматирования содержат «поля замены», заключённые в фигурные скобки `{}`. Всё, что не находится в скобках, считается буквальным текстом и копируется в вывод без изменений. Если нужно включить символ скобки в буквальный текст, его можно экранировать удвоением: `{{` и `}}`.116117Грамматика поля замены выглядит следующим образом:118119> ```120>121> replacement_field ::= "{" [field_name] ["!" conversion] [":" format_spec] "}"122> field_name ::= arg_name ("." attribute_name | "[" element_index "]")*123> arg_name ::= [identifier | integer]124> attribute_name ::= identifier125> element_index ::= integer | index_string126> index_string ::= <any source character except "]"> +127> conversion ::= "r" | "s" | "a"128> format_spec ::= <described in the next section>129> ```130131В менее формальных терминах, поле замены может начинаться с *field\_name*, который задаёт объект, чьё значение должно быть отформатировано и вставлено в вывод вместо поля замены. За *field\_name* может опционально следовать поле *conversion*, которому предшествует восклицательный знак `'!'`, и *format\_spec*, которому предшествует двоеточие `':'`. Они задают нестандартный формат для заменяемого значения.132133См. также раздел [*Мини-язык спецификации формата*](https://python-all.ru/3.3/library/string.html#formatspec).134135Сам *field\_name* начинается с *arg\_name*, который может быть числом или ключевым словом. Если это число, оно ссылается на позиционный аргумент; если это ключевое слово – на именованный. Если числовые имена аргументов в строке формата идут подряд 0, 1, 2, ..., их все можно опустить (а не только некоторые), и числа 0, 1, 2, ... будут автоматически подставлены в этом порядке. Поскольку *arg\_name* не заключается в кавычки, в строке формата нельзя указать произвольные ключи словаря (например, строки `'10'` или `':-]'`). За *arg\_name* может следовать любое количество выражений индексации или атрибутов. Выражение вида `'.name'` выбирает именованный атрибут с помощью [`getattr()`](https://python-all.ru/3.3/library/functions.html#getattr), а выражение вида `'[index]'` выполняет поиск по индексу с помощью [`__getitem__()`](https://python-all.ru/3.3/reference/datamodel.html#object.__getitem__).136137Изменено в версии 3.1: Указатели позиционных аргументов можно опускать, поэтому `'{} {}'` эквивалентно `'{0} {1}'`.138139Несколько простых примеров строк форматирования:140141```python142"First, thou shalt count to {0}" # Ссылается на первый позиционный аргумент143"Bring me a {}" # Неявно ссылается на первый позиционный аргумент144"From {} to {}" # То же, что "From {0} to {1}"145"My quest is {name}" # Ссылается на именованный аргумент 'name'146"Weight in tons {0.weight}" # Атрибут 'weight' первого позиционного аргумента147"Units destroyed: {players[0]}" # Первый элемент именованного аргумента 'players'.148```149150Поле *conversion* вызывает приведение типа перед форматированием. Обычно задачу форматирования значения выполняет метод [`__format__()`](https://python-all.ru/3.3/reference/datamodel.html#object.__format__) самого этого значения. Однако в некоторых случаях желательно принудительно отформатировать тип как строку, переопределив его собственное определение форматирования. Преобразовав значение в строку перед вызовом [`__format__()`](https://python-all.ru/3.3/reference/datamodel.html#object.__format__), можно обойти обычную логику форматирования.151152В настоящее время поддерживаются три флага преобразования: `'!s'`, который вызывает [`str()`](https://python-all.ru/3.3/library/stdtypes.html#str) для значения; `'!r'`, вызывающий [`repr()`](https://python-all.ru/3.3/library/functions.html#repr); и `'!a'`, вызывающий [`ascii()`](https://python-all.ru/3.3/library/functions.html#ascii).153154Несколько примеров:155156```python157"Harold's a clever {0!s}" # Сначала вызывает str() для аргумента158"Bring out the holy {name!r}" # Сначала вызывает repr() для аргумента159"More {!a}" # Сначала вызывает ascii() для аргумента160```161162Поле *format\_spec* содержит спецификацию того, как должно быть представлено значение, включая такие детали, как ширина поля, выравнивание, заполнение, десятичная точность и так далее. Каждый тип значения может определять свой собственный «мини-язык форматирования» или интерпретацию *format\_spec*.163164Большинство встроенных типов поддерживают общий мини-язык форматирования, который описан в следующем разделе.165166Поле *format\_spec* может также содержать вложенные поля замены. Эти вложенные поля замены могут содержать только имя поля; флаги преобразования и спецификации формата не допускаются. Поля замены внутри format\_spec подставляются до того, как строка *format\_spec* будет интерпретирована. Это позволяет динамически задавать форматирование значения.167168Смотрите раздел [*Примеры форматирования*](https://python-all.ru/3.3/library/string.html#formatexamples) для примеров.169170### 6.1.3.1. Мини-язык спецификаций формата171172«Спецификации формата» используются внутри полей замены, содержащихся в строке формата, чтобы определить, как отдельные значения представляются (см. [*Синтаксис строк формата*](https://python-all.ru/3.3/library/string.html#formatstrings)). Их также можно передавать напрямую встроенной функции [`format()`](https://python-all.ru/3.3/library/functions.html#format). Каждый форматируемый тип может определять, как следует интерпретировать спецификацию формата.173174Большинство встроенных типов реализуют следующие параметры для спецификаций формата, хотя некоторые параметры форматирования поддерживаются только числовыми типами.175176Общее соглашение: пустая строка формата (`""`) даёт тот же результат, как если бы была вызвана [`str()`](https://python-all.ru/3.3/library/stdtypes.html#str) для этого значения. Непустая строка формата обычно изменяет результат.177178Общий вид *стандартного спецификатора формата*:179180```181182format_spec ::= [[fill]align][sign][#][0][width][,][.precision][type]183fill ::= <any character>184align ::= "<" | ">" | "=" | "^"185sign ::= "+" | "-" | " "186width ::= integer187precision ::= integer188type ::= "b" | "c" | "d" | "e" | "E" | "f" | "F" | "g" | "G" | "n" | "o" | "s" | "x" | "X" | "%"189```190191Если задано допустимое значение *align*, перед ним может стоять символ *fill*, которым может быть любой символ; если он опущен, по умолчанию используется пробел. Обратите внимание, что невозможно использовать `{` и `}` в качестве символа *fill* при использовании метода [`str.format()`](https://python-all.ru/3.3/library/stdtypes.html#str.format); однако это ограничение не действует для функции [`format()`](https://python-all.ru/3.3/library/functions.html#format).192193Значение различных параметров выравнивания следующее:194195> | Параметр | Значение |196> | --- | --- |197> | `'<'` | Выравнивает поле по левому краю в пределах доступного пространства (это значение по умолчанию для большинства объектов). |198> | `'>'` | Выравнивает поле по правому краю в пределах доступного пространства (это значение по умолчанию для чисел). |199> | `'='` | Заставляет заполнение располагаться после знака (если он есть), но перед цифрами. Используется для печати полей в формате «+000000120». Этот вариант выравнивания применим только к числовым типам. |200> | `'^'` | Выравнивает поле по центру в пределах доступного пространства. |201202Обратите внимание, что если не задана минимальная ширина поля, ширина поля всегда будет равна размеру заполняемых данных, поэтому в этом случае параметр выравнивания не имеет смысла.203204Параметр *sign* допустим только для числовых типов и может быть одним из следующих:205206> | Параметр | Значение |207> | --- | --- |208> | `'+'` | указывает, что знак должен выводиться как для положительных, так и для отрицательных чисел. |209> | `'-'` | указывает, что знак должен выводиться только для отрицательных чисел (это поведение по умолчанию). |210> | пробел | указывает, что перед положительными числами должен ставиться пробел, а перед отрицательными – знак минус. |211212Опция `'#'` включает «альтернативную форму» для преобразования. Альтернативная форма определяется по-разному для разных типов. Эта опция применима только к целым числам, числам с плавающей запятой, комплексным числам и Decimal. Для целых чисел, при выводе в двоичной, восьмеричной или шестнадцатеричной системе, эта опция добавляет к выходному значению соответствующий префикс `'0b'`, `'0o'` или `'0x'`. Для чисел с плавающей запятой, комплексных чисел и Decimal альтернативная форма приводит к тому, что результат преобразования всегда содержит десятичную точку, даже если за ней не следует ни одной цифры. Обычно десятичная точка появляется в результате этих преобразований только в том случае, если за ней следует цифра. Кроме того, для преобразований `'g'` и `'G'` конечные нули не удаляются из результата.213214Опция `','` указывает на использование запятой в качестве разделителя групп разрядов. Для разделителя, учитывающего локаль, используйте вместо этого тип представления целых чисел `'n'`.215216Изменено в версии 3.1: Добавлена опция `','` (см. также [**PEP 378**](https://python-all.ru/3.3/library/string.html)).217218*ширина* – целое десятичное число, задающее минимальную ширину поля. Если не указано, ширина поля определяется содержимым.219220Предварение поля *width* символом нуля (`'0'`) включает знако-зависимое дополнение нулями для числовых типов. Это эквивалентно символу *fill* равному `'0'` с типом *alignment* `'='`.221222Параметр *precision* – это десятичное число, указывающее, сколько цифр должно отображаться после десятичной точки для значения с плавающей запятой, отформатированного с помощью `'f'` и `'F'`, или до и после десятичной точки для значения с плавающей запятой, отформатированного с помощью `'g'` или `'G'`. Для нечисловых типов это поле указывает максимальный размер поля – иными словами, сколько символов будет взято из содержимого поля. Параметр *precision* не допускается для целых чисел.223224Наконец, *тип* определяет, как должны быть представлены данные.225226Доступные типы представления для строк:227228> | Тип | Значение |229> | --- | --- |230> | `'s'` | Формат строки. Это тип по умолчанию для строк и может быть опущен. |231> | None | То же, что и `'s'`. |232233Доступные типы представления для целых чисел:234235> | Тип | Значение |236> | --- | --- |237> | `'b'` | Двоичный формат. Выводит число в системе с основанием 2. |238> | `'c'` | Символ. Преобразует целое число в соответствующий символ Юникода перед выводом. |239> | `'d'` | Десятичное целое. Выводит число в системе с основанием 10. |240> | `'o'` | Восьмеричный формат. Выводит число в системе с основанием 8. |241> | `'x'` | Шестнадцатеричный формат. Выводит число по основанию 16, используя строчные буквы для цифр больше 9. |242> | `'X'` | Шестнадцатеричный формат. Выводит число по основанию 16, используя заглавные буквы для цифр больше 9. |243> | `'n'` | Число. То же, что и `'d'`, но с использованием текущей локали для вставки соответствующих разделителей групп разрядов. |244> | None | То же, что и `'d'`. |245246В дополнение к перечисленным выше типам форматирования, целые числа можно форматировать с помощью типов для чисел с плавающей запятой, перечисленных ниже (кроме `'n'` и None). В этом случае перед форматированием для преобразования целого числа в число с плавающей запятой используется [`float()`](https://python-all.ru/3.3/library/functions.html#float).247248Доступные типы представления для чисел с плавающей запятой и десятичных чисел:249250> | Тип | Значение |251> | --- | --- |252> | `'e'` | Экспоненциальная запись. Выводит число в научной нотации, используя букву 'e' для обозначения показателя степени. Точность по умолчанию – `6`. |253> | `'E'` | Экспоненциальная запись. То же, что и `'e'`, но с использованием заглавной буквы «E» в качестве разделителя. |254> | `'f'` | Фиксированная точка. Отображает число в формате с фиксированной точкой. Точность по умолчанию: `6`. |255> | `'F'` | Фиксированная запись. То же, что и `'f'`, но преобразует `nan` в `NAN`, а `inf` в `INF`. |256> | `'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`. |257> | `'G'` | Общий формат. То же, что и `'g'`, но переключается на `'E'`, если число становится слишком большим. Представления бесконечности и NaN также выводятся заглавными буквами. |258> | `'n'` | Число. То же, что и `'g'`, но с использованием текущей локали для вставки соответствующих разделителей групп разрядов. |259> | `'%'` | Процент. Умножает число на 100 и выводит в фиксированном формате (`'f'`) с последующим знаком процента. |260> | None | Аналогично `'g'`, но с как минимум одной цифрой после десятичной точки и точностью по умолчанию 12. Этот формат предназначен для соответствия [`str()`](https://python-all.ru/3.3/library/stdtypes.html#str), за исключением того, что можно добавлять другие модификаторы форматирования. |261262### 6.1.3.2. Примеры форматирования263264В этом разделе приведены примеры нового синтаксиса форматирования и сравнение со старым форматированием `%`.265266В большинстве случаев синтаксис похож на старое форматирование `%`, с добавлением `{}` и использованием `:` вместо `%`. Например, `'%03.2f'` можно перевести как `'{:03.2f}'`.267268Новый синтаксис форматирования также поддерживает новые и другие параметры, показанные в следующих примерах.269270Доступ к аргументам по позиции:271272```python273>>> '{0}, {1}, {2}'.format('a', 'b', 'c')274'a, b, c'275>>> '{}, {}, {}'.format('a', 'b', 'c') # Только для версии 3.1+276'a, b, c'277>>> '{2}, {1}, {0}'.format('a', 'b', 'c')278'c, b, a'279>>> '{2}, {1}, {0}'.format(*'abc') # Распаковка последовательности аргументов280'c, b, a'281>>> '{0}{1}{0}'.format('abra', 'cad') # индексы аргументов могут повторяться282'abracadabra'283```284285Доступ к аргументам по имени:286287```python288>>> 'Coordinates: {latitude}, {longitude}'.format(latitude='37.24N', longitude='-115.81W')289'Coordinates: 37.24N, -115.81W'290>>> coord = {'latitude': '37.24N', 'longitude': '-115.81W'}291>>> 'Coordinates: {latitude}, {longitude}'.format(**coord)292'Coordinates: 37.24N, -115.81W'293```294295Доступ к атрибутам аргументов:296297```python298>>> c = 3-5j299>>> ('The complex number {0} is formed from the real part {0.real} '300... 'and the imaginary part {0.imag}.').format(c)301'The complex number (3-5j) is formed from the real part 3.0 and the imaginary part -5.0.'302>>> class Point:303... def __init__(self, x, y):304... self.x, self.y = x, y305... def __str__(self):306... return 'Point({self.x}, {self.y})'.format(self=self)307...308>>> str(Point(4, 2))309'Point(4, 2)'310```311312Доступ к элементам аргументов:313314```python315>>> coord = (3, 5)316>>> 'X: {0[0]}; Y: {0[1]}'.format(coord)317'X: 3; Y: 5'318```319320Замена `%s` и `%r`:321322```python323>>> "repr() shows quotes: {!r}; str() doesn't: {!s}".format('test1', 'test2')324"repr() shows quotes: 'test1'; str() doesn't: test2"325```326327Выравнивание текста и указание ширины:328329```python330>>> '{:<30}'.format('left aligned')331'left aligned '332>>> '{:>30}'.format('right aligned')333' right aligned'334>>> '{:^30}'.format('centered')335' centered '336>>> '{:*^30}'.format('centered') # использовать '*' в качестве символа заполнения337'***********centered***********'338```339340Замена `%+f`, `%-f`, и `% f` с указанием знака:341342```python343>>> '{:+f}; {:+f}'.format(3.14, -3.14) # отображать всегда344'+3.140000; -3.140000'345>>> '{: f}; {: f}'.format(3.14, -3.14) # для положительных чисел отображать пробел346' 3.140000; -3.140000'347>>> '{:-f}; {:-f}'.format(3.14, -3.14) # отображать только минус – то же, что и '{:f}; {:f}'348'3.140000; -3.140000'349```350351Замена `%x` и `%o` и преобразование значения в разные системы счисления:352353```python354>>> # format также поддерживает двоичные числа355>>> "int: {0:d}; hex: {0:x}; oct: {0:o}; bin: {0:b}".format(42)356'int: 42; hex: 2a; oct: 52; bin: 101010'357>>> # с префиксом 0x, 0o или 0b:358>>> "int: {0:d}; hex: {0:#x}; oct: {0:#o}; bin: {0:#b}".format(42)359'int: 42; hex: 0x2a; oct: 0o52; bin: 0b101010'360```361362Использование запятой в качестве разделителя тысяч:363364```python365>>> '{:,}'.format(1234567890)366'1,234,567,890'367```368369Выражение процентов:370371```python372>>> points = 19373>>> total = 22374>>> 'Correct answers: {:.2%}'.format(points/total)375'Correct answers: 86.36%'376```377378Использование форматирования с учётом типа:379380```python381>>> import datetime382>>> d = datetime.datetime(2010, 7, 4, 12, 15, 58)383>>> '{:%Y-%m-%d %H:%M:%S}'.format(d)384'2010-07-04 12:15:58'385```386387Вложенные аргументы и более сложные примеры:388389```python390>>> for align, text in zip('<^>', ['left', 'center', 'right']):391... '{0:{fill}{align}16}'.format(text, fill=align, align=align)392...393'left<<<<<<<<<<<<'394'^^^^^center^^^^^'395'>>>>>>>>>>>right'396>>>397>>> octets = [192, 168, 0, 1]398>>> '{:02X}{:02X}{:02X}{:02X}'.format(*octets)399'C0A80001'400>>> int(_, 16)4013232235521402>>>403>>> width = 5404>>> for num in range(5,12): 405... for base in 'dXob':406... print('{0:{width}{base}}'.format(num, base=base, width=width), end=' ')407... print()408...409 5 5 5 101410 6 6 6 110411 7 7 7 111412 8 8 10 1000413 9 9 11 1001414 10 A 12 1010415 11 B 13 1011416```417418## 6.1.4. Шаблонные строки419420Шаблоны предоставляют более простые подстановки строк, как описано в [**PEP 292**](https://python-all.ru/3.3/library/string.html). Вместо обычных подстановок на основе `%`, шаблоны поддерживают подстановки на основе `$`, используя следующие правила:421422- `$$` – это escape-последовательность; она заменяется на один символ `$`.423- `$identifier` обозначает заполнитель подстановки, соответствующий ключу отображения `"identifier"`. По умолчанию, `"identifier"` должно быть корректным идентификатором Python. Первый символ, не являющийся идентификатором, после символа `$` завершает этот спецификатор заполнителя.424- `${identifier}` эквивалентно `$identifier`. Такая форма требуется, когда за заполнителем следуют символы, являющиеся корректными идентификаторами, но не входящие в состав заполнителя, как в `"${noun}ification"`.425426Любое другое появление `$` в строке приведёт к возбуждению исключения [`ValueError`](https://python-all.ru/3.3/library/exceptions.html#ValueError).427428The [`string`](https://python-all.ru/3.3/library/string.html#module-string) module provides a [`Template`](https://python-all.ru/3.3/library/string.html#string.Template) class that implements these rules. The methods of [`Template`](https://python-all.ru/3.3/library/string.html#string.Template) are:429430#### `class string.Template(template)`431432Конструктор принимает единственный аргумент – строку шаблона.433434#### `substitute(mapping, **kwds)`435436Выполняет подстановку в шаблон, возвращая новую строку. *mapping* – это любой объект, подобный словарю, ключи которого соответствуют плейсхолдерам в шаблоне. В качестве альтернативы можно указать именованные аргументы, где имена аргументов являются плейсхолдерами. Если указаны и *mapping*, и *kwds*, и есть дубликаты, то плейсхолдеры из *kwds* имеют приоритет.437438#### `safe_substitute(mapping, **kwds)`439440Подобно [`substitute()`](https://python-all.ru/3.3/library/string.html#string.Template.substitute), но если плейсхолдеры отсутствуют в *mapping* и *kwds*, то вместо возбуждения исключения [`KeyError`](https://python-all.ru/3.3/library/exceptions.html#KeyError) исходный плейсхолдер останется в результирующей строке нетронутым. Также, в отличие от [`substitute()`](https://python-all.ru/3.3/library/string.html#string.Template.substitute), любые другие вхождения `$` просто вернут `$` вместо возбуждения [`ValueError`](https://python-all.ru/3.3/library/exceptions.html#ValueError).441442Хотя другие исключения всё ещё могут возникать, этот метод называется «безопасным» (safe), потому что подстановки всегда стараются вернуть рабочую строку вместо возбуждения исключения. В другом смысле, [`safe_substitute()`](https://python-all.ru/3.3/library/string.html#string.Template.safe_substitute) может быть чем угодно, но не безопасным, поскольку он молча игнорирует некорректные шаблоны, содержащие висячие разделители, несогласованные скобки или плейсхолдеры, не являющиеся валидными идентификаторами Python.443444Экземпляры [`Template`](https://python-all.ru/3.3/library/string.html#string.Template) также предоставляют один открытый атрибут данных:445446#### `template`447448Это объект, переданный в аргумент *template* конструктора. В общем случае его не следует изменять, но доступ только для чтения не гарантируется.449450Вот пример использования Template:451452```python453>>> from string import Template454>>> s = Template('$who likes $what')455>>> s.substitute(who='tim', what='kung pao')456'tim likes kung pao'457>>> d = dict(who='tim')458>>> Template('Give $who $100').substitute(d)459Traceback (most recent call last):460...461ValueError: Invalid placeholder in string: line 1, col 11462>>> Template('$who likes $what').substitute(d)463Traceback (most recent call last):464...465KeyError: 'what'466>>> Template('$who likes $what').safe_substitute(d)467'tim likes $what'468```469470Расширенное использование: можно создавать подклассы [`Template`](https://python-all.ru/3.3/library/string.html#string.Template), чтобы настроить синтаксис плейсхолдера, символ-разделитель или всё регулярное выражение, используемое для разбора строк шаблона. Для этого можно переопределить следующие атрибуты класса:471472- *delimiter* – Это литеральная строка, описывающая разделитель, вводящий плейсхолдер. Значение по умолчанию – `$`. Обратите внимание, что это *не* должно быть регулярным выражением, так как реализация вызовет [`re.escape()`](https://python-all.ru/3.3/library/re.html#re.escape) для этой строки при необходимости.473- *idpattern* – Это регулярное выражение, описывающее шаблон для плейсхолдеров без фигурных скобок (скобки будут добавлены автоматически по мере необходимости). Значение по умолчанию – регулярное выражение `[_a-z][_a-z0-9]*`.474- *flags* – Флаги регулярного выражения, которые будут применены при компиляции регулярного выражения, используемого для распознавания подстановок. Значение по умолчанию – `re.IGNORECASE`. Обратите внимание, что `re.VERBOSE` будет всегда добавляться к флагам, поэтому пользовательские *idpattern* должны следовать соглашениям для подробных (verbose) регулярных выражений.475476 Новое в версии 3.2.477478В качестве альтернативы можно указать всё регулярное выражение, переопределив атрибут класса *pattern*. Если это сделать, значение должно быть объектом регулярного выражения с четырьмя именованными захватывающими группами. Эти группы соответствуют правилам, приведённым выше, а также правилу недопустимых плейсхолдеров:479480- *escaped* – эта группа соответствует управляющей последовательности, например `$$`, в шаблоне по умолчанию.481- *named* – эта группа соответствует имени плейсхолдера без скобок; она не должна включать разделитель в захватывающую группу.482- *braced* – эта группа соответствует имени плейсхолдера, заключённого в скобки; она не должна включать ни разделитель, ни скобки в захватывающую группу.483- *invalid* – эта группа соответствует любому другому шаблону разделителя (обычно одиночному разделителю), и она должна появляться последней в регулярном выражении.484485## 6.1.5. Вспомогательные функции486487#### `string.capwords(s, sep=None)`488489Разделяет аргумент на слова с помощью [`str.split()`](https://python-all.ru/3.3/library/stdtypes.html#str.split), преобразует каждое слово в заглавные буквы с помощью [`str.capitalize()`](https://python-all.ru/3.3/library/stdtypes.html#str.capitalize) и соединяет преобразованные слова с помощью [`str.join()`](https://python-all.ru/3.3/library/stdtypes.html#str.join). Если необязательный второй аргумент *sep* отсутствует или равен `None`, последовательности пробельных символов заменяются одним пробелом, а начальные и конечные пробелы удаляются; в противном случае *sep* используется для разделения и соединения слов.490