Python format что это

Форматирование строки методом format() в Python

Внимание! Ссылка для тех, кто ищет встроенную функцию форматирования переменных format() .

Параметры:

• *args — позиционные аргументы
• **kwargs — ключевые аргументы

Возвращаемое значение:

• str , копия форматированной строки

Описание:

Метод str.format() выполняет операцию форматирования строки str . Возвращает копию строки, в которой каждое замещающее поле заменяется строковым значением соответствующего аргумента.

Строки str метода str.format() содержат «замещающие поля», заключенные в фигурные скобки <> . Все, что не содержится в фигурных скобках, считается буквальным текстом, который копируется без изменений в выходные данные.

Если необходимо включить в текст дополнительные символы скобок, то это можно сделать путем их удвоения, например > .

Каждое замещающее поле <> содержит либо числовой индекс позиционного аргумента, либо имя ключевого аргумента.

Грамматика поля замены выглядит следующим образом:

"" # где: # - field_name - это *args и(или) **kwargs # - conversion - это 'r' или 's' или 'a' # - format_spec - это Спецификация формата Mini-Language

Поле замены <. >может начинаться с field_name , указывающего объект, значение которого должно быть отформатировано и вставлено в выходные данные. За полем field_name , необязательно должны следовать поля: conversion , которому предшествует восклицательный знак ‘!’ , и format_spec , которому предшествует двоеточие ‘:’ . Они задают формат замены, отличный от формата по умолчанию.

Поле field_name
Поле является либо числом, либо ключевым словом. Если это число, то оно ссылается на позиционный аргумент, а если ключевое слово, то на именованный аргумент ключевого слова.

Если в строке формата ‘. . . ‘.format(a, b, c) числа являются номерами позиционных аргументов, они все могут быть опущены, а индексы позиционных аргументов 0, 1, 2, . будут автоматически вставлены.

# ПОЗИЦИОННЫЕ АРГУМЕНТЫ 'текст  текст  текст'.format(a, b) # числа позиционных аргументов можно не # указывать, если они следуют подряд 'текст <> текст <> текст'.format(a, b) # числа позиционных аргументов следует указывать, # если в форматируемой строке они следуют не по порядку 'текст  текст  текст '.format(a, b) # КЛЮЧЕВЫЕ АРГУМЕНТЫ # имена ключевых аргументов указываются всегда 'текст  текст  текст '.format(one=a, two=b) 

Поле conversion
Поле преобразования conversion вызывает приведение типа перед форматированием. Обычно задание форматирования значения выполняется методом __format__() самого значения. Однако в некоторых случаях желательно принудительно форматировать тип в виде строки, переопределяя его собственное определение форматирования. При преобразовании значения в строку перед вызовом __format__() обычная логика форматирования игнорируется.

В настоящее время поддерживаются три флага преобразования:

• ‘!s ‘ — вызывает str() по значению,
• ‘!r’ — вызывает repr() ,
• ‘!a’ — вызывает ascii() .

Поле format_spec
Cодержит спецификацию формата «Mini-Language». Эта спецификация определяет, как должно быть представлено значение, включая такие детали, как ширина поля, выравнивание, заполнение, десятичная точность и так далее. Большинство встроенных типов поддерживают спецификацию формата «Mini-Language», который описан во встроенной функции format() .

Примеры форматирования методом строки str.format() .

Вывод значений, заданных позиционными аргументами:

>>> ' , , '.format('a', 'b', 'c') # 'a, b, c' >>> '<>, <>, <>'.format('a', 'b', 'c') # 3.1+ only # 'a, b, c' >>> ' , , '.format('a', 'b', 'c') # 'c, b, a' # распаковка позиционных аргументов >>> ' , , '.format(*'abc') # 'c, b, a' # индексы аргументов могут повторятся >>> ' '.format('abra', 'cad') # 'abracadabra' # использование строки, как шаблона >>> tpl = ' ' >>> tpl.format('abra', 'cad') # 'abracadabra' 

Вывод значений, заданных ключевыми аргументами:

>>> 'Coordinates: , '.format(latitude='37.24N', longitude='-115.81W') # 'Coordinates: 37.24N, -115.81W' >>> coord = 'latitude': '37.24N', 'longitude': '-115.81W'> # распаковка ключевых аргументов >>> 'Coordinates: , '.format(**coord) # 'Coordinates: 37.24N, -115.81W' 

Доступ к атрибутам аргументов:

>>> c = (3-5j) >>> ('The complex number  is formed from the real part  ' . 'and the imaginary part .').format(c) # 'The complex number (3-5j) is formed from the real part 3.0 and the imaginary part -5.0.' 

Доступ к элементам аргументов:

>>> coord = (3, 5) >>> 'X: ; Y: '.format(coord) # 'X: 3; Y: 5' 

Использование фигурных скобок в строке/шаблоне.

Что если в строке должны использоваться дополнительные фигурные скобки? Например:

# строка - шаблон >>> tpl = "Строка №  с -мя фигурными скобками>" # форматируем строку-шаблон >>> prn = tpl.format(1, 2) # Traceback (most recent call last): # File "", line 1, in # ValueError: Single '>' encountered in format string 

Чтобы форматировать строку с дополнительными фигурными скобками, необходимо эти дополнительные скобки удвоить.

# в строке - шаблоне удвоим фигурные скобки, # которые не отвечают за перенос значений переменных >>> tpl = "Строка №  с  -мя фигурными скобками>>" # форматируем строку-шаблон >>> tpl.format(1, 2) # 'Строка №1 с ' 

Используем приведение типа перед форматированием на примере !r и !s :

>>> "repr() shows quotes: ; str() doesn't: ".format('test1', 'test2') # "repr() shows quotes: 'test1'; str() doesn't: test2" 

Выравнивание текста и указание ширины при помощи разметки:

>>> ' '.format('left aligned') # 'left aligned ' >>> '30>'.format('right aligned') # ' right aligned' >>> ' '.format('centered') # ' centered ' # используем '*' как символ-заполнитель >>> ' '.format('centered') # use '*' as a fill char # '***********centered***********' 

Форматируем число со знаком:

>>> ' ; '.format(3.14, -3.14) # '+3.140000; -3.140000' # покажем пробел для положительных чисел >>> ' ; '.format(3.14, -3.14) # ' 3.140000; -3.140000' # покажем только минус - то же, что и '; ' >>> ' ; '.format(3.14, -3.14) # '3.140000; -3.140000' 

Замена %x и %o и преобразование значения в разные счисления:

# Метод str.format() поддерживает двоичные числа >>> "int: ; hex: ; oct: ; bin: ".format(42) # 'int: 42; hex: 2a; oct: 52; bin: 101010' # теперь с префиксами 0x, 0o или 0b: >>> "int: ; hex: ; oct: ; bin: ".format(42) # 'int: 42; hex: 0x2a; oct: 0o52; bin: 0b101010' 

Использование запятой в качестве разделителя тысяч:

>>> ' '.format(1234567890) # '1,234,567,890' 

Выводим процент:

>>> points = 19 >>> total = 22 >>> 'Правильные ответы: '.format(points/total) # 'Правильные ответы: 86.36%' 

Использование форматирования, зависящего от типа передаваемых данных:

>>> import datetime >>> d = datetime.datetime(2021, 7, 3, 11, 13, 13) >>> '%d %H:%M:%S>'.format(d) # '2021-07-03 11:13:13' 

• ОБЗОРНАЯ СТРАНИЦА РАЗДЕЛА
• Метод str.capitalize(), первая буква в строке заглавная
• Метод str.casefold(), сворачивает регистр строки
• Метод str.center(), выравнивает строку по центру
• Метод str.count(), считает совпадения в строке
• Метод str.encode(), преобразует строку в байты
• Метод str.endswith(), совпадение с концом строки
• Метод str.expandtabs(), меняет табуляцию на пробел
• Метод str.find(), индекс первого совпадения в строке
• Метод str.format(), форматирует строку
• Метод str.format_map()
• Метод str.index(), индекс первого совпадения подстроки
• Метод str.isalnum(), строка состоит из цифр и букв
• Метод str.isalpha(), строка состоит только из букв
• Метод str.isascii(), все символы в строке являются ASCII
• Метод str.isdecimal(), проверяет строку на десятичное число
• Метод str.isdigit(), строка состоит только из цифр
• Метод str.isidentifier() проверяет строку на идентификатор Python
• Метод str.islower( ), проверяет строку на нижний регистр
• Метод str.isnumeric(), проверяет строку на числовые символы
• Метод str.isprintable(), проверяет на доступность для печати
• Метод str.isspace(), является ли строка пробелом
• Метод str.istitle(), проверяет наличие заглавных букв в словах
• Метод str.isupper(), проверяет строку на верхний регистр
• Метод str.join(), объединяет список строк
• Метод str.ljust(), ровняет строку по левому краю
• Метод str.lower(), строку в нижний регистр
• Метод str.lstrip(), обрезает символы в начале строки
• Метод str.maketrans(), таблица символов для str.translate()
• Метод str.partition(), делит строку по первому совпадению
• Метод str.removeprefix(), удаляет префикс строки
• Метод str.removesuffix(), удаляет суффикс строки
• Метод str.replace(), меняет подстроку/символ в строке
• Метод str.rfind(), индекс последнего совпадения подстроки
• Метод str.rindex(), индекс последнего совпадения в строке
• Метод str.rjust(), ровняет строку по правому краю
• Метод str.rpartition(), делит строку по последнему совпадению
• Метод str.rsplit(), делит строку справа
• Метод str.rstrip(), обрезает символы на конце строки
• Метод str.split(), делит строку по подстроке
• Метод str.splitlines(), делит текст по символу ‘\n’
• Метод str.startswith(), совпадение с началом строки
• Метод str.strip(), обрежет строку с обоих концов
• Метод str.swapcase(), сменит регистр символов в строке
• Метод str.title(), каждое слово с заглавной буквы
• Метод str.translate(), транслирование строки
• Метод str.upper(), переведет строку в верхний регистр
• Метод str.zfill(), дополнит строку нулями
• Форматирование строк в стиле printf
• F-string. Форматированные строки

Python format что это

В прошлых темах было рассмотрено, как можно вставлять в строку некоторые значения, предваряя строку символом f :

first_name="Tom" text = f"Hello, ." print(text) # Hello, Tom. name="Bob" age=23 info = f"Name: \t Age: " print(info) # Name: Bob Age: 23

Но также в Python есть альтернативный способ, который предоставляет метод format() . Этот метод позволяет форматировать строку, вставляя в нее на место плейсхолдеров определенные значения.

Для вставки в строку используются специальные параметры, которые обрамляются фигурными скобками (<>).

Именованные параметры

В форматируемой строке мы можем определять параметры, в методе format() передавать для этих параметров значения:

text = "Hello, .".format(first_name="Tom") print(text) # Hello, Tom. info = "Name: \t Age: ".format(name="Bob", age=23) print(info) # Name: Bob Age: 23

Причем в метод формат аргументы определяются с тем же именем, что и параметры в строке. Так, если параметр называется first_name , как в первом случае, то аргумент, которому присваивается значение, также называется first_name .

Параметры по позиции

Мы также можем последовательно передавать в метод format набор аргументов, а в самой форматируемой строке вставлять эти аргумента, указывая в фигурных скобках их номер (нумерация начинается с нуля):

info = "Name: \t Age: ".format("Bob", 23) print(info) # Name: Bob Age: 23

При этом аргументы можно вставлять в строку множество раз:

text = "Hello,  .".format("Tom")

Подстановки

Еще один способ передачи форматируемых значений в строку представляет использование подстановок или специальных плейсхолдеров, на место которых вставляются определенные значения. Для форматирования мы можем использовать следующие плейсхолдеры:

• s : для вставки строк
• d : для вставки целых чисел
• f : для вставки дробных чисел. Для этого типа также можно определить через точку количество знаков в дробной части.
• % : умножает значение на 100 и добавляет знак процента
• e : выводит число в экспоненциальной записи

Общий синтаксис плейсхолдера следующий:

В зависимости от плейсхолдера можно добавлять дополнительные параметры. Например, для форматирования чисел float можно использовать следующие параметры

При вызове метода format в него в качестве аргументов передаются значения, которые вставляются на место плейсхолдеров:

welcome = "Hello " name = "Tom" formatted_welcome = welcome.format(name) print(formatted_welcome) # Hello Tom

В качестве результата метод format() возвращает новую отформатированную строку.

Форматирование целых чисел:

source = " символов" number = 5 target = source.format(number) print(target) # 5 символов

Если форматируемое число больше 999, то мы можем указать в определении плейсхолдера, что мы хотим использовать запятую в качестве разделителя разрядов:

source = " символов" print(source.format(5000)) # 5,000 символов

Причем плейсхолдеры можно использовать и в f-строках:

n = 5000 source = f" символов" print(source) # 5,000 символов

Для дробных чисел, то есть таких, которые представляют тип float, перед кодом плейсхолдера после точки можно указать, сколько знаков в дробной части мы хотим вывести:

number = 23.8589578 print("".format(number)) # 23.86 print("".format(number)) # 23.859 print("".format(number)) # 23.8590 print("".format(10001.23554)) # 10,001.24

Еще один параметр позволяет установить минимальную ширину форматируемого значения в символах:

print("".format(23.8589578)) # 23.86 print("".format(25)) # 25

Аналогичный пример с f-строками:

n1 = 23.8589578 print(f"") # 23.86 n2 = 25 print(f"") # 25

Для вывода процентов лучше воспользоваться кодом «%»:

number = .12345 print("".format(number)) # 12.345000% print("".format(number)) # 12% print("".format(number)) # 12.3% print(f"") # 12.345000% print(f"") # 12% print(f"") # 12.3%

Для вывода числа в экспоненциальной записи применяется плейсхолдер «e»:

number = 12345.6789 print("".format(number)) # 1.234568e+04 print("".format(number)) # 1e+04 print("".format(number)) # 1.2e+04 print(f"") # 1.234568e+04 print(f"") # 1e+04 print(f"") # 1.2e+04

Форматирование без метода format

Существует также еще один способ форматирования с помощью следующего синтаксиса:

строка%(параметр1, параметр2. параметрN)

То есть в начале идет строка, которая содержит те же плейсхолдеры, которые были рассмотрены выше (за исключением плейсхолдера %), после строки ставится знак процента %, а затем список значений, которые вставляются в строку. Фактически знак процента представляют операцию, в результате которой образуется новая строка:

info = "Имя: %s \t Возраст: %d" % ("Tom", 35) print(info) # Имя: Tom Возраст: 35

Рядом с плейсхолдером указывается знак процента и в отличие от функции format здесь не требуются фигурные скобки.

Причем способы форматирования чисел здесь также применяются:

number = 23.8589578 print("%0.2f - %e" % (number, number)) # 23.86 - 2.385896e+01

Функция format() в Python, форматирует значение переменной

Форматирует значение переменной для вывода на печать

Синтаксис:

format(value, format_spec) 

Параметры:

• value — форматируемое значение,
• format_spec — спецификации формата ‘Mini-Language’.

Возвращаемое значение:

• строка, отформатированная в соответствии с форматом ‘Mini-Language’.

Описание:

Функция format() преобразует переданное значение в отформатированную строку, в соответствии с спецификацией формата Mini-Language , которое задается в необязательном аргументе format_spec .

Интерпретация format_spec будет зависеть от типа значения переданного функции аргумента. По умолчанию format_spec пустая строка, которая обычно дает тот же эффект, что и вызов функции str(value) .

Спецификация формата Mini-Language :

Общая форма спецификатора стандартного формата:

format_spec ::= [[fill]align][sign][z][#][0][width][grouping_option][.precision][type] fill ::= align ::= "" | "=" | "^" sign ::= "+" | "-" | " " width ::= digit+ grouping_option ::= "_" | "," precision ::= digit+ type ::= "b" | "c" | "d" | "e" | "E" | "f" | "F" | "g" | "G" | "n" | "o" | "s" | "x" | "X" | "%"

Изменено в Python 3.10: установка ‘0’ перед полем width больше не влияет на выравнивание строк по умолчанию.Изменено в Python 3.11: добавлена ​​опция ‘z’ .

Если указано допустимое значение выравнивания align , то ему может предшествовать символ заполнения fill , который может быть любым символом и по умолчанию равен пробелу, если он опущен. Невозможно использовать литеральную фигурную скобку ( » ) в качестве символа заполнения в форматированном строковом литерале или при использовании метода str.format() . Однако можно вставить фигурную скобку с вложенным замещающим полем. Это ограничение не влияет на функцию format() .

Опция # приводит к использованию «альтернативной формы» для преобразования. Альтернативная форма определяется по-разному для разных типов. Этот параметр действителен только для целых, плавающих и сложных типов. Для целых чисел, когда используется двоичный, восьмеричный или шестнадцатеричный вывод, эта опция добавляет к выходному значению соответствующий префикс ‘0b’ , ‘0o’ , ‘0x’ или ‘0X’ . Для чисел с плавающей запятой и сложных альтернативная форма приводит к тому, что результат преобразования всегда содержит символ десятичной точки, даже если за ним не следуют цифры. Обычно символ десятичной точки появляется в результате этих преобразований только в том случае, если за ним следует цифра. Кроме того, для преобразований ‘g’ и ‘G’ конечные нули не удаляются из результата.

Опция width — десятичное целое число, определяющее минимальную общую ширину поля, включая все префиксы, разделители и другие символы форматирования. Если не указано, то ширина поля будет определяться содержимым.

Если явное выравнивание не задано, то перед полем ширины width ставится нулевой ( ‘0’ ) символ, что позволяет использовать знаковое заполнение нулями для числовых типов. Это эквивалентно символу заполнения fill=’0′ с типом выравнивания align=’=’ .

1. Выравнивание:
   • < - Левое выравнивание результата (в пределах доступного пространства);
   • > — Выравнивает результат по правому краю (в пределах доступного пространства);
   • ^ — Выравнивает результат по центру (в пределах доступного пространства);
   • = — Помещает результат в крайнее левое положение;
2. Знаки, только для чисел:
   • + — знак плюс;
   • — — знак минус только для отрицательных значений;
   • пробел ‘ ‘ — указывает, что перед положительными числами следует использовать начальный пробел, а перед отрицательными — знак минус.

Опция ‘z’ (добавлена в Python 3.11) преобразует отрицательные нулевые значения с плавающей запятой в положительные нули после округления до точности формата. Этот параметр действителен только для типов представления с плавающей запятой.

• , — Использовать запятую в качестве разделителя тысяч;
• _ — Использовать символ подчеркивания в качестве разделителя тысяч;

>>>format(1, 'f') '1.000000' >>>format(10, '.2f') '10.00' >>>format('format', '.2') 'fo' 

• s — строка, можно не указывать, используется по умолчанию;
• b — двоичный формат;
• с — преобразует целое число в символ Unicode;
• d — десятичный формат;
• e — научный формат, со строчной буквой e ;
• E — научный формат, с E верхним регистром;
• f — формат чисел с плавающей запятой;
• F — формат чисел с плавающей запятой, верхний регистр;
• g — общий формат, нижний регистр;
• G — общий формат, верхний регистр;
• o — Восьмеричный формат;
• x — шестнадцатеричный формат, нижний регистр;
• X — шестнадцатеричный формат, верхний регистр;
• n — формат целых чисел;
• % — Процентный формат. Умножает число на 100 и использует f для вывода. В конце ставится % ;

Общий вид инструкции format_spec :
заполнитель|выравнивание|знак|#|размер строки|разделитель десятков|.точность|тип

Пример: format(1000.5368, ‘~>+15,.2f’) , где ‘~>+15,.2f’ — формат Mini-Language .

• ~ — заполнитель
• > — выравнивание
• + — знак
• 15 — размер итоговой строки в символах
• , — разделитель десятков
• .2 — точность, количество выводимых цифр после запятой
• f — тип,

Пример выведет отформатированную строку: ‘~~~~~~+1,000.54’

Примеры форматирования значений переменных.

>>> format(5) '5' >>> format(5, '.1f') '5.0' >>> format(5, '*^10.2f') '***5.00***' >>> format(1000, '10,d') ' 1,000' >>> format('Привет', '>10.3') ' При' >>> format(1000, '#>+10,.2f') ' +1,000.00' >>>format(1000.5368, '~>+15,.2f') '~~~~~~+1,000.54' 

• ОБЗОРНАЯ СТРАНИЦА РАЗДЕЛА
• Функция abs(), абсолютное значение числа
• Функция all(), все элементы True
• Функция any(), хотя бы один элемент True
• Функция ascii(), преобразует строку в ASCII
• Функция bin(), число в двоичную строку
• Класс bool(), логическое значение объекта
• Функция breakpoint(), отладчик кода
• Класс bytearray(), преобразует в массив байтов
• Класс bytes(), преобразует в строку байтов
• Функция callable(), проверяет можно ли вызвать объект
• Функция chr(), число в символ Юникода
• Класс classmethod, делает функцию методом класса
• Функция compile() компилирует блок кода Python
• Класс complex(), преобразует в комплексное число
• Функция delattr(), удаляет атрибут объекта
• Класс dict() создает словарь
• Функция dir(), все атрибуты объекта
• Функция divmod(), делит числа с остатком
• Функция enumerate(), счетчик элементов последовательности
• Функция eval(), выполняет строку-выражение с кодом
• Функция exec(), выполняет блок кода
• Функция filter(), фильтрует список по условию
• Класс float(), преобразует в вещественное число
• Функция format(), форматирует значение переменной
• Класс frozenset(), преобразует в неизменяемое множество
• Функция getattr(), значение атрибута по имени
• Функция globals(), переменные глобальной области
• Функция hasattr(), наличие атрибута объекта
• Функция hash(), хэш-значение объекта
• Функция help(), справка по любому объекту
• Функция hex(), число в шестнадцатеричную строку
• Функция id(), идентификатор объекта
• Функция input(), ввод данных с клавиатуры
• Класс int(), преобразует в тип int
• Функция isinstance(), принадлежность экземпляра к классу
• Функция issubclass(), проверяет наследование класса
• Функция iter(), создает итератор
• Функция len(), количество элементов объекта
• Класс list(), преобразовывает в список
• Функция locals(), переменные локальной области
• Функция map(), обработка последовательности без цикла
• Функция max(), максимальное значение элемента
• Класс memoryview(), ссылка на буфер обмена
• Функция min(), минимальное значение элемента
• Функция next(), следующий элемент итератора
• Класс object(), возвращает безликий объект
• Функция oct(), число в восьмеричную строку
• Функция open(), открывает файл на чтение/запись
• Функция ord(), число символа Unicode
• Функция pow(), возводит число в степень
• Функция print(), печатает объект
• Класс property(), метод класса как свойство
• Класс range(), генерирует арифметические последовательности
• Функция repr(), описание объекта
• Функция reversed(), разворачивает последовательность
• Функция round(), округляет число
• Класс set(), создает или преобразовывает в множество
• Функция setattr(), создает атрибут объекта
• Класс slice(), шаблон среза
• Функция sorted(), выполняет сортировку
• Декоратор staticmethod(), метод класса в статический метод
• Класс str(), преобразует объект в строку
• Функция sum(), сумма последовательности
• Функция super(), доступ к унаследованным методам
• Класс tuple(), создает или преобразует в кортеж
• Класс type(), возвращает тип объекта
• Функция vars(), словарь переменных объекта
• Функция zip(), объединить элементы в список кортежей
• Функция __import__(), находит и импортирует модуль
• Функция aiter(), создает асинхронный итератор
• Функция anext(), следующий элемент асинхронного итератора

Форматирование строк. Метод format

Иногда (а точнее, довольно часто) возникают ситуации, когда нужно сделать строку, подставив в неё некоторые данные, полученные в процессе выполнения программы (пользовательский ввод, данные из файлов и т. д.). Подстановку данных можно сделать с помощью форматирования строк. Форматирование можно сделать с помощью оператора %, либо с помощью метода format.

Форматирование строк с помощью метода format

Если для подстановки требуется только один аргумент, то значение — сам аргумент:

А если несколько, то значениями будут являться все аргументы со строками подстановки (обычных или именованных):

Однако метод format умеет большее. Вот его синтаксис:

Например:

Теперь спецификация формата:

Выравнивание производится при помощи символа-заполнителя. Доступны следующие варианты выравнивания:

Опция «знак» используется только для чисел и может принимать следующие значения:

Поле «тип» может принимать следующие значения:

И напоследок, несколько примеров:

Для вставки кода на Python в комментарий заключайте его в теги