> **Источник:** https://python-all.ru/3.1/library/string.html > > «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor. --- # 7.1. `string` – Основные операции со строками > **См. также** > > [*Типы последовательностей – str, bytes, bytearray, list, tuple, range*](https://python-all.ru/3.1/library/stdtypes.html#typesseq) > > [*Методы строк*](https://python-all.ru/3.1/library/stdtypes.html#string-methods) ## 7.1.1. Строковые константы Константы, определённые в этом модуле: #### `string.ascii_letters` Конкатенация констант [`ascii_lowercase`](https://python-all.ru/3.1/library/string.html#string.ascii_lowercase) и [`ascii_uppercase`](https://python-all.ru/3.1/library/string.html#string.ascii_uppercase) , описанных ниже. Это значение не зависит от локали. #### `string.ascii_lowercase` Строчные буквы `'abcdefghijklmnopqrstuvwxyz'` . Это значение не зависит от локали и не изменится. #### `string.ascii_uppercase` Прописные буквы `'ABCDEFGHIJKLMNOPQRSTUVWXYZ'` . Это значение не зависит от локали и не изменится. #### `string.digits` Строка `'0123456789'` . #### `string.hexdigits` Строка `'0123456789abcdefABCDEF'` . #### `string.octdigits` Строка `'01234567'` . #### `string.punctuation` Строка символов ASCII, которые считаются знаками препинания в локали `C` . #### `string.printable` Строка символов ASCII, которые считаются печатными. Это комбинация [`digits`](https://python-all.ru/3.1/library/string.html#string.digits) , [`ascii_letters`](https://python-all.ru/3.1/library/string.html#string.ascii_letters) , [`punctuation`](https://python-all.ru/3.1/library/string.html#string.punctuation) и [`whitespace`](https://python-all.ru/3.1/library/string.html#string.whitespace) . #### `string.whitespace` Строка, содержащая все ASCII-символы, которые считаются пробельными. Включает символы: пробел, табуляция, перевод строки, возврат каретки, прогон страницы и вертикальная табуляция. ## 7.1.2. Форматирование строк Встроенный строковый класс предоставляет возможность выполнять сложные подстановки переменных и форматирование значений с помощью метода [`format()`](https://python-all.ru/3.1/library/functions.html#format), описанного в [**PEP 3101**](https://python-all.ru/3.1/library/string.html). Класс [`Formatter`](https://python-all.ru/3.1/library/string.html#string.Formatter) в модуле `string` позволяет создавать и настраивать собственное поведение форматирования строк, используя ту же реализацию, что и встроенный метод [`format()`](https://python-all.ru/3.1/library/functions.html#format). #### `class string.Formatter` Класс [`Formatter`](https://python-all.ru/3.1/library/string.html#string.Formatter) имеет следующие открытые методы: #### `format(format_string, *args, **kwargs)` [`format()`](https://python-all.ru/3.1/library/functions.html#format) – это основной метод API. Он принимает шаблон форматирования строку и произвольный набор позиционных и именованных аргументов. [`format()`](https://python-all.ru/3.1/library/functions.html#format) – это обёртка, которая вызывает [`vformat()`](https://python-all.ru/3.1/library/string.html#string.Formatter.vformat) . #### `vformat(format_string, args, kwargs)` Эта функция выполняет фактическую работу по форматированию. Она вынесена как отдельная функция для случаев, когда нужно передать заранее определённый словарь аргументов, а не распаковывать и упаковывать словарь как отдельные аргументы с помощью синтаксиса `*args` и `**kwds` . [`vformat()`](https://python-all.ru/3.1/library/string.html#string.Formatter.vformat) выполняет разбиение шаблонной строки форматирования на символьные данные и поля замены. Она вызывает различные методы, описанные ниже. Кроме того, класс [`Formatter`](https://python-all.ru/3.1/library/string.html#string.Formatter) определяет ряд методов, предназначенных для замены в подклассах: #### `parse(format_string)` Перебирает format\_string и возвращает итератор кортежей (*literal\_text*, *field\_name*, *format\_spec*, *conversion*). Это используется [`vformat()`](https://python-all.ru/3.1/library/string.html#string.Formatter.vformat) для разбиения строки либо на литеральный текст, либо на поля подстановки. Значения кортежа концептуально представляют собой отрезок литерального текста, после которого следует одно поле подстановки. Если литерального текста нет (это может произойти, если два поля подстановки следуют подряд), то *literal\_text* будет строкой нулевой длины. Если поле подстановки отсутствует, то значения *field\_name*, *format\_spec* и *conversion* будут равны `None`. #### `get_field(field_name, args, kwargs)` При заданном *field\_name* , возвращаемом [`parse()`](https://python-all.ru/3.1/library/string.html#string.Formatter.parse) (см. выше), преобразует его в объект для форматирования. Возвращает кортеж (obj, used\_key). Версия по умолчанию принимает строки формы, определённой в [**PEP 3101**](https://python-all.ru/3.1/library/string.html) , например "0\[name\]" или "label.title". *args* и *kwargs* передаются в [`vformat()`](https://python-all.ru/3.1/library/string.html#string.Formatter.vformat) . Возвращаемое значение *used\_key* имеет тот же смысл, что и параметр *key* для [`get_value()`](https://python-all.ru/3.1/library/string.html#string.Formatter.get_value) . #### `get_value(key, args, kwargs)` Извлекает значение заданного поля. Аргумент *key* может быть целым числом или строкой. Если это целое число, оно представляет индекс позиционного аргумента в *args*; если строка – именованный аргумент в *kwargs*. Параметр *args* содержит список позиционных аргументов для [`vformat()`](https://python-all.ru/3.1/library/string.html#string.Formatter.vformat), а параметр *kwargs* – словарь именованных аргументов. Для составных имён полей эти функции вызываются только для первого компонента имени поля; последующие компоненты обрабатываются через обычные операции с атрибутами и индексацией. Так, например, для поля с выражением ‘0.name’ будет вызвана [`get_value()`](https://python-all.ru/3.1/library/string.html#string.Formatter.get_value) с аргументом *key*, равным 0. Затем атрибут `name` будет получен после возврата [`get_value()`](https://python-all.ru/3.1/library/string.html#string.Formatter.get_value) вызовом встроенной функции [`getattr()`](https://python-all.ru/3.1/library/functions.html#getattr). Если индекс или ключевое слово ссылаются на несуществующий элемент, то должно быть возбуждено исключение [`IndexError`](https://python-all.ru/3.1/library/exceptions.html#IndexError) или [`KeyError`](https://python-all.ru/3.1/library/exceptions.html#KeyError). #### `check_unused_args(used_args, args, kwargs)` Реализует проверку неиспользуемых аргументов (при необходимости). Аргументами этой функции являются множество всех ключей аргументов, которые фактически использовались в строке формата (целые числа для позиционных аргументов и строки для именованных), а также ссылка на *args* и *kwargs* , которые были переданы в vformat. Множество неиспользуемых аргументов можно вычислить из этих параметров. Предполагается, что [`check_unused_args()`](https://python-all.ru/3.1/library/string.html#string.Formatter.check_unused_args) возбуждает исключение, если проверка не проходит. #### `format_field(value, format_spec)` [`format_field()`](https://python-all.ru/3.1/library/string.html#string.Formatter.format_field) просто вызывает встроенную функцию [`format()`](https://python-all.ru/3.1/library/functions.html#format) . Этот метод предусмотрен, чтобы подклассы могли его переопределить. #### `convert_field(value, conversion)` Преобразует значение (возвращённое методом [`get_field()`](https://python-all.ru/3.1/library/string.html#string.Formatter.get_field) ) по заданному типу преобразования (как в кортеже, возвращённом методом [`parse()`](https://python-all.ru/3.1/library/string.html#string.Formatter.parse) ). Стандартная версия понимает типы преобразования ‘r’ (repr) и ‘s’ (str). ## 7.1.3. Синтаксис строк форматирования Метод [`str.format()`](https://python-all.ru/3.1/library/stdtypes.html#str.format) и класс [`Formatter`](https://python-all.ru/3.1/library/string.html#string.Formatter) используют одинаковый синтаксис строк формата (хотя в случае [`Formatter`](https://python-all.ru/3.1/library/string.html#string.Formatter) подклассы могут определять собственный синтаксис строк формата). Строки форматирования содержат «поля замены», заключённые в фигурные скобки `{}`. Всё, что не находится в скобках, считается буквальным текстом и копируется в вывод без изменений. Если нужно включить символ скобки в буквальный текст, его можно экранировать удвоением: `{{` и `}}`. Грамматика поля замены выглядит следующим образом: > ``` > > replacement_field ::= "{" [field_name] ["!" conversion] [":" format_spec] "}" > field_name ::= arg_name ("." attribute_name | "[" element_index "]")* > arg_name ::= [identifier | integer] > attribute_name ::= identifier > element_index ::= integer | index_string > index_string ::= + > conversion ::= "r" | "s" | "a" > format_spec ::= > ``` В менее формальных терминах, поле замены может начинаться с *field\_name*, который задаёт объект, чьё значение должно быть отформатировано и вставлено в вывод вместо поля замены. За *field\_name* может опционально следовать поле *conversion*, которому предшествует восклицательный знак `'!'`, и *format\_spec*, которому предшествует двоеточие `':'`. Они задают нестандартный формат для заменяемого значения. См. также раздел [*Мини-язык спецификации формата*](https://python-all.ru/3.1/library/string.html#formatspec). Сам *field\_name* начинается с *arg\_name*, который является либо числом, либо ключевым словом. Если это число, оно ссылается на позиционный аргумент, а если ключевое слово – на именованный аргумент. Если числовые arg\_names в строке форматирования идут по порядку 0, 1, 2, ..., их можно опустить (не только некоторые), и числа 0, 1, 2, ... будут автоматически вставлены в том же порядке. За *arg\_name* может следовать любое количество выражений индекса или атрибута. Выражение вида `'.name'` выбирает именованный атрибут с помощью [`getattr()`](https://python-all.ru/3.1/library/functions.html#getattr), а выражение вида `'[index]'` выполняет поиск по индексу с помощью [`__getitem__()`](https://python-all.ru/3.1/reference/datamodel.html#object.__getitem__). Изменено в версии 3.1: Указатели позиционных аргументов можно опускать, поэтому `'{} {}'` эквивалентно `'{0} {1}'`. Несколько простых примеров строк форматирования: ```python "First, thou shalt count to {0}" # Ссылается на первый позиционный аргумент "Bring me a {}" # Неявно ссылается на первый позиционный аргумент "From {} to {}" # То же, что "From {0} to {1}" "My quest is {name}" # Ссылается на именованный аргумент 'name' "Weight in tons {0.weight}" # Атрибут 'weight' первого позиционного аргумента "Units destroyed: {players[0]}" # Первый элемент именованного аргумента 'players'. ``` Поле *conversion* вызывает приведение типа перед форматированием. Обычно задачу форматирования значения выполняет метод [`__format__()`](https://python-all.ru/3.1/reference/datamodel.html#object.__format__) самого этого значения. Однако в некоторых случаях желательно принудительно отформатировать тип как строку, переопределив его собственное определение форматирования. Преобразовав значение в строку перед вызовом [`__format__()`](https://python-all.ru/3.1/reference/datamodel.html#object.__format__), можно обойти обычную логику форматирования. В настоящее время поддерживаются три флага преобразования: `'!s'`, который вызывает [`str()`](https://python-all.ru/3.1/library/functions.html#str) для значения; `'!r'`, вызывающий [`repr()`](https://python-all.ru/3.1/library/functions.html#repr); и `'!a'`, вызывающий [`ascii()`](https://python-all.ru/3.1/library/functions.html#ascii). Несколько примеров: ```python "Harold's a clever {0!s}" # Сначала вызывает str() для аргумента "Bring out the holy {name!r}" # Сначала вызывает repr() для аргумента "More {!a}" # Сначала вызывает ascii() для аргумента ``` Поле *format\_spec* содержит спецификацию того, как должно быть представлено значение, включая такие детали, как ширина поля, выравнивание, заполнение, десятичная точность и так далее. Каждый тип значения может определять свой собственный «мини-язык форматирования» или интерпретацию *format\_spec*. Большинство встроенных типов поддерживают общий мини-язык форматирования, который описан в следующем разделе. Поле *format\_spec* может также содержать вложенные поля замены. Эти вложенные поля замены могут содержать только имя поля; флаги преобразования и спецификации формата не допускаются. Поля замены внутри format\_spec подставляются до того, как строка *format\_spec* будет интерпретирована. Это позволяет динамически задавать форматирование значения. Смотрите раздел [*Примеры форматирования*](https://python-all.ru/3.1/library/string.html#formatexamples) для примеров. ### 7.1.3.1. Мини-язык спецификации формата «Спецификации формата» используются внутри полей замены, содержащихся в строке формата, чтобы определить, как отдельные значения представляются (см. [*Синтаксис строк формата*](https://python-all.ru/3.1/library/string.html#formatstrings)). Их также можно передавать напрямую встроенной функции [`format()`](https://python-all.ru/3.1/library/functions.html#format). Каждый форматируемый тип может определять, как следует интерпретировать спецификацию формата. Большинство встроенных типов реализуют следующие параметры для спецификаций формата, хотя некоторые параметры форматирования поддерживаются только числовыми типами. Общее соглашение: пустая строка формата (`""`) даёт тот же результат, как если бы была вызвана [`str()`](https://python-all.ru/3.1/library/functions.html#str) для этого значения. Непустая строка формата обычно изменяет результат. Общий вид *стандартного спецификатора формата*: ``` format_spec ::= [[fill]align][sign][#][0][width][,][.precision][type] fill ::= align ::= "<" | ">" | "=" | "^" sign ::= "+" | "-" | " " width ::= integer precision ::= integer type ::= "b" | "c" | "d" | "e" | "E" | "f" | "F" | "g" | "G" | "n" | "o" | "s" | "x" | "X" | "%" ``` Символом *заполнения* может быть любой символ, кроме '{' или '}'. Наличие символа заполнения обозначается следующим за ним символом, который должен быть одним из вариантов выравнивания. Если второй символ *format\_spec* не является допустимым вариантом выравнивания, то считается, что отсутствуют как символ заполнения, так и вариант выравнивания. Значение различных параметров выравнивания следующее: > | Параметр | Значение | > | --- | --- | > | `'<'` | Выравнивает поле по левому краю в пределах доступного пространства (это значение по умолчанию для большинства объектов). | > | `'>'` | Выравнивает поле по правому краю в пределах доступного пространства (это значение по умолчанию для чисел). | > | `'='` | Заставляет заполнение располагаться после знака (если он есть), но перед цифрами. Используется для печати полей в формате «+000000120». Этот вариант выравнивания применим только к числовым типам. | > | `'^'` | Выравнивает поле по центру в пределах доступного пространства. | Обратите внимание, что если не задана минимальная ширина поля, ширина поля всегда будет равна размеру заполняемых данных, поэтому в этом случае параметр выравнивания не имеет смысла. Параметр *sign* допустим только для числовых типов и может быть одним из следующих: > | Параметр | Значение | > | --- | --- | > | `'+'` | указывает, что знак должен выводиться как для положительных, так и для отрицательных чисел. | > | `'-'` | указывает, что знак должен выводиться только для отрицательных чисел (это поведение по умолчанию). | > | пробел | указывает, что перед положительными числами должен ставиться пробел, а перед отрицательными – знак минус. | Параметр `'#'` допустим только для целых чисел и только для двоичного, восьмеричного или шестнадцатеричного вывода. Если он указан, это означает, что вывод будет предваряться соответственно `'0b'`, `'0o'` или `'0x'`. Опция `','` указывает на использование запятой в качестве разделителя групп разрядов. Для разделителя, учитывающего локаль, используйте вместо этого тип представления целых чисел `'n'`. Изменено в версии 3.1: Добавлена опция `','` (см. также [**PEP 378**](https://python-all.ru/3.1/library/string.html)). *ширина* – целое десятичное число, задающее минимальную ширину поля. Если не указано, ширина поля определяется содержимым. Если полю *width* предшествует символ нуля (`'0'`), это включает заполнение нулями. Это эквивалентно типу выравнивания *alignment* `'='` и символу заполнения *fill* `'0'`. Параметр *precision* – это десятичное число, указывающее, сколько цифр должно отображаться после десятичной точки для значения с плавающей запятой, отформатированного с помощью `'f'` и `'F'`, или до и после десятичной точки для значения с плавающей запятой, отформатированного с помощью `'g'` или `'G'`. Для нечисловых типов это поле указывает максимальный размер поля – иными словами, сколько символов будет взято из содержимого поля. Параметр *precision* не допускается для целых чисел. Наконец, *тип* определяет, как должны быть представлены данные. Доступные типы представления для строк: > | Тип | Значение | > | --- | --- | > | `'s'` | Формат строки. Это тип по умолчанию для строк и может быть опущен. | > | None | То же, что и `'s'`. | Доступные типы представления для целых чисел: > | Тип | Значение | > | --- | --- | > | `'b'` | Двоичный формат. Выводит число в системе с основанием 2. | > | `'c'` | Символ. Преобразует целое число в соответствующий символ Юникода перед выводом. | > | `'d'` | Десятичное целое. Выводит число в системе с основанием 10. | > | `'o'` | Восьмеричный формат. Выводит число в системе с основанием 8. | > | `'x'` | Шестнадцатеричный формат. Выводит число по основанию 16, используя строчные буквы для цифр больше 9. | > | `'X'` | Шестнадцатеричный формат. Выводит число по основанию 16, используя заглавные буквы для цифр больше 9. | > | `'n'` | Число. То же, что и `'d'`, но с использованием текущей локали для вставки соответствующих разделителей групп разрядов. | > | None | То же, что и `'d'`. | В дополнение к перечисленным выше типам форматирования, целые числа можно форматировать с помощью типов для чисел с плавающей запятой, перечисленных ниже (кроме `'n'` и None). В этом случае перед форматированием для преобразования целого числа в число с плавающей запятой используется [`float()`](https://python-all.ru/3.1/library/functions.html#float). Доступные типы представления для чисел с плавающей запятой и десятичных чисел: > | Тип | Значение | > | --- | --- | > | `'e'` | Экспоненциальная запись. Выводит число в экспоненциальной записи, используя букву 'e' для обозначения порядка. | > | `'E'` | Экспоненциальная запись. То же, что и `'e'`, но с использованием заглавной буквы «E» в качестве разделителя. | > | `'f'` | Фиксированная точка. Отображает число как число с фиксированной точкой. | > | `'F'` | Фиксированная запись. То же, что и `'f'`, но преобразует `nan` в `NAN`, а `inf` в `INF`. | > | `'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`. | > | `'G'` | Общий формат. То же, что и `'g'`, но переключается на `'E'`, если число становится слишком большим. Представления бесконечности и NaN также выводятся заглавными буквами. | > | `'n'` | Число. То же, что и `'g'`, но с использованием текущей локали для вставки соответствующих разделителей групп разрядов. | > | `'%'` | Процент. Умножает число на 100 и выводит в фиксированном формате (`'f'`) с последующим знаком процента. | > | None | Аналогично `'g'`, но с как минимум одной цифрой после десятичной точки и точностью по умолчанию 12. Этот формат предназначен для соответствия [`str()`](https://python-all.ru/3.1/library/functions.html#str), за исключением того, что можно добавлять другие модификаторы форматирования. | ### 7.1.3.2. Примеры форматирования В этом разделе приведены примеры нового синтаксиса форматирования и сравнение со старым форматированием `%`. В большинстве случаев синтаксис похож на старое форматирование `%`, с добавлением `{}` и использованием `:` вместо `%`. Например, `'%03.2f'` можно перевести как `'{:03.2f}'`. Новый синтаксис форматирования также поддерживает новые и другие параметры, показанные в следующих примерах. Доступ к аргументам по позиции: ```python >>> '{0}, {1}, {2}'.format('a', 'b', 'c') 'a, b, c' >>> '{}, {}, {}'.format('a', 'b', 'c') # Только для версии 3.1+ 'a, b, c' >>> '{2}, {1}, {0}'.format('a', 'b', 'c') 'c, b, a' >>> '{2}, {1}, {0}'.format(*'abc') # Распаковка последовательности аргументов 'c, b, a' >>> '{0}{1}{0}'.format('abra', 'cad') # индексы аргументов могут повторяться 'abracadabra' ``` Доступ к аргументам по имени: ```python >>> 'Coordinates: {latitude}, {longitude}'.format(latitude='37.24N', longitude='-115.81W') 'Coordinates: 37.24N, -115.81W' >>> coord = {'latitude': '37.24N', 'longitude': '-115.81W'} >>> 'Coordinates: {latitude}, {longitude}'.format(**coord) 'Coordinates: 37.24N, -115.81W' ``` Доступ к атрибутам аргументов: ```python >>> c = 3-5j >>> ('The complex number {0} is formed from the real part {0.real} ' ... 'and the imaginary part {0.imag}.').format(c) 'The complex number (3-5j) is formed from the real part 3.0 and the imaginary part -5.0.' >>> class Point: ... def __init__(self, x, y): ... self.x, self.y = x, y ... def __str__(self): ... return 'Point({self.x}, {self.y})'.format(self=self) ... >>> str(Point(4, 2)) 'Point(4, 2)' ``` Доступ к элементам аргументов: ```python >>> coord = (3, 5) >>> 'X: {0[0]}; Y: {0[1]}'.format(coord) 'X: 3; Y: 5' ``` Замена `%s` и `%r`: ```python >>> "repr() shows quotes: {!r}; str() doesn't: {!s}".format('test1', 'test2') "repr() shows quotes: 'test1'; str() doesn't: test2" ``` Выравнивание текста и указание ширины: ```python >>> '{:<30}'.format('left aligned') 'left aligned ' >>> '{:>30}'.format('right aligned') ' right aligned' >>> '{:^30}'.format('centered') ' centered ' >>> '{:*^30}'.format('centered') # использовать '*' в качестве символа заполнения '***********centered***********' ``` Замена `%+f`, `%-f`, и `% f` с указанием знака: ```python >>> '{:+f}; {:+f}'.format(3.14, -3.14) # отображать всегда '+3.140000; -3.140000' >>> '{: f}; {: f}'.format(3.14, -3.14) # для положительных чисел отображать пробел ' 3.140000; -3.140000' >>> '{:-f}; {:-f}'.format(3.14, -3.14) # отображать только минус – то же, что и '{:f}; {:f}' '3.140000; -3.140000' ``` Замена `%x` и `%o` и преобразование значения в разные системы счисления: ```python >>> # format также поддерживает двоичные числа >>> "int: {0:d}; hex: {0:x}; oct: {0:o}; bin: {0:b}".format(42) 'int: 42; hex: 2a; oct: 52; bin: 101010' >>> # с префиксом 0x, 0o или 0b: >>> "int: {0:d}; hex: {0:#x}; oct: {0:#o}; bin: {0:#b}".format(42) 'int: 42; hex: 0x2a; oct: 0o52; bin: 0b101010' ``` Использование запятой в качестве разделителя тысяч: ```python >>> '{:,}'.format(1234567890) '1,234,567,890' ``` Выражение процентов: ```python >>> points = 19 >>> total = 22 >>> 'Correct answers: {:.2%}.'.format(points/total) 'Correct answers: 86.36%' ``` Использование форматирования с учётом типа: ```python >>> import datetime >>> d = datetime.datetime(2010, 7, 4, 12, 15, 58) >>> '{:%Y-%m-%d %H:%M:%S}'.format(d) '2010-07-04 12:15:58' ``` Вложенные аргументы и более сложные примеры: ```python >>> for align, text in zip('<^>', ['left', 'center', 'right']): ... '{0:{fill}{align}16}'.format(text, fill=align, align=align) ... 'left<<<<<<<<<<<<' '^^^^^center^^^^^' '>>>>>>>>>>>right' >>> >>> octets = [192, 168, 0, 1] >>> '{:02X}{:02X}{:02X}{:02X}'.format(*octets) 'C0A80001' >>> int(_, 16) 3232235521 >>> >>> width = 5 >>> for num in range(5,12): ... for base in 'dXob': ... print('{0:{width}{base}}'.format(num, base=base, width=width), end=' ') ... print() ... 5 5 5 101 6 6 6 110 7 7 7 111 8 8 10 1000 9 9 11 1001 10 A 12 1010 11 B 13 1011 ``` ## 7.1.4. Шаблонные строки Шаблоны предоставляют более простые подстановки строк, как описано в [**PEP 292**](https://python-all.ru/3.1/library/string.html). Вместо обычных подстановок на основе `%`, шаблоны поддерживают подстановки на основе `$`, используя следующие правила: - `$$` – это escape-последовательность; она заменяется на один символ `$`. - `$identifier` обозначает заполнитель подстановки, соответствующий ключу отображения `"identifier"`. По умолчанию, `"identifier"` должно быть корректным идентификатором Python. Первый символ, не являющийся идентификатором, после символа `$` завершает этот спецификатор заполнителя. - `${identifier}` эквивалентно `$identifier`. Такая форма требуется, когда за заполнителем следуют символы, являющиеся корректными идентификаторами, но не входящие в состав заполнителя, как в `"${noun}ification"`. Любое другое появление `$` в строке приведёт к возбуждению исключения [`ValueError`](https://python-all.ru/3.1/library/exceptions.html#ValueError). Модуль `string` предоставляет класс [`Template`](https://python-all.ru/3.1/library/string.html#string.Template), который реализует эти правила. Методы класса [`Template`](https://python-all.ru/3.1/library/string.html#string.Template): #### `class string.Template(template)` Конструктор принимает единственный аргумент – строку шаблона. #### `substitute(mapping, **kwds)` Выполняет подстановку в шаблон, возвращая новую строку. *mapping* – это любой объект, подобный словарю, ключи которого соответствуют плейсхолдерам в шаблоне. В качестве альтернативы можно указать именованные аргументы, где имена аргументов являются плейсхолдерами. Если указаны и *mapping* , и *kwds* , и есть дубликаты, то плейсхолдеры из *kwds* имеют приоритет. #### `safe_substitute(mapping, **kwds)` Подобно [`substitute()`](https://python-all.ru/3.1/library/string.html#string.Template.substitute), но если плейсхолдеры отсутствуют в *mapping* и *kwds*, то вместо возбуждения исключения [`KeyError`](https://python-all.ru/3.1/library/exceptions.html#KeyError) исходный плейсхолдер останется в результирующей строке нетронутым. Также, в отличие от [`substitute()`](https://python-all.ru/3.1/library/string.html#string.Template.substitute), любые другие вхождения `$` просто вернут `$` вместо возбуждения [`ValueError`](https://python-all.ru/3.1/library/exceptions.html#ValueError). Хотя другие исключения всё ещё могут возникать, этот метод называется «безопасным» (safe), потому что подстановки всегда стараются вернуть рабочую строку вместо возбуждения исключения. В другом смысле, [`safe_substitute()`](https://python-all.ru/3.1/library/string.html#string.Template.safe_substitute) может быть чем угодно, но не безопасным, поскольку он молча игнорирует некорректные шаблоны, содержащие висячие разделители, несогласованные скобки или плейсхолдеры, не являющиеся валидными идентификаторами Python. Экземпляры [`Template`](https://python-all.ru/3.1/library/string.html#string.Template) также предоставляют один открытый атрибут данных: #### `template` Это объект, переданный в аргумент *template* конструктора. В общем случае его не следует изменять, но доступ только для чтения не гарантируется. Вот пример использования Template: ```python >>> from string import Template >>> s = Template('$who likes $what') >>> s.substitute(who='tim', what='kung pao') 'tim likes kung pao' >>> d = dict(who='tim') >>> Template('Give $who $100').substitute(d) Traceback (most recent call last): [...] ValueError: Invalid placeholder in string: line 1, col 10 >>> Template('$who likes $what').substitute(d) Traceback (most recent call last): [...] KeyError: 'what' >>> Template('$who likes $what').safe_substitute(d) 'tim likes $what' ``` Расширенное использование: можно создавать подклассы [`Template`](https://python-all.ru/3.1/library/string.html#string.Template), чтобы настроить синтаксис плейсхолдера, символ-разделитель или всё регулярное выражение, используемое для разбора строк шаблона. Для этого можно переопределить следующие атрибуты класса: - *delimiter* – это литерал строки, описывающий разделитель, который вводит заполнитель. Значение по умолчанию `$`. Обратите внимание: это *не* должно быть регулярным выражением, так как реализация при необходимости вызовет [`re.escape()`](https://python-all.ru/3.1/library/re.html#re.escape) для этой строки. - *idpattern* – Это регулярное выражение, описывающее шаблон для плейсхолдеров без фигурных скобок (скобки будут добавлены автоматически по мере необходимости). Значение по умолчанию – регулярное выражение `[_a-z][_a-z0-9]*`. В качестве альтернативы можно указать всё регулярное выражение, переопределив атрибут класса *pattern*. Если это сделать, значение должно быть объектом регулярного выражения с четырьмя именованными захватывающими группами. Эти группы соответствуют правилам, приведённым выше, а также правилу недопустимых плейсхолдеров: - *escaped* – эта группа соответствует управляющей последовательности, например `$$`, в шаблоне по умолчанию. - *named* – эта группа соответствует имени плейсхолдера без скобок; она не должна включать разделитель в захватывающую группу. - *braced* – эта группа соответствует имени плейсхолдера, заключённого в скобки; она не должна включать ни разделитель, ни скобки в захватывающую группу. - *invalid* – эта группа соответствует любому другому шаблону разделителя (обычно одиночному разделителю), и она должна появляться последней в регулярном выражении. ## 7.1.5. Вспомогательные функции #### `string.capwords(s[, sep])` Разделяет аргумент на слова с помощью [`str.split()`](https://python-all.ru/3.1/library/stdtypes.html#str.split) , преобразует каждое слово в заглавные буквы с помощью [`str.capitalize()`](https://python-all.ru/3.1/library/stdtypes.html#str.capitalize) и соединяет преобразованные слова с помощью [`str.join()`](https://python-all.ru/3.1/library/stdtypes.html#str.join) . Если необязательный второй аргумент *sep* отсутствует или равен `None` , последовательности пробельных символов заменяются одним пробелом, а начальные и конечные пробелы удаляются; в противном случае *sep* используется для разделения и соединения слов. #### `string.maketrans(frm, to)` Возвращает таблицу перевода, подходящую для передачи в [`bytes.translate()`](https://python-all.ru/3.1/library/stdtypes.html#bytes.translate), которая будет сопоставлять каждый символ из *from* с символом на той же позиции в *to*; *from* и *to* должны иметь одинаковую длину. Устарело с версии 3.1: Используйте вместо этого статический метод [`bytes.maketrans()`](https://python-all.ru/3.1/library/stdtypes.html#bytes.maketrans).