Что такое string format java
В предыдущих уроках для вывода информации на консоль мы использовали методы print() и println(), которые выводили строки или числа без какого-либо форматирования. Элементарное форматирование мы могли реализовать при помощи добавления к строкам дополнительных пробелов или других символов. В этом уроке мы познакомимся с методами, которые откроют нам новые возможности для форматирования строк в Java.
Краткое содержание урока:
Для начала немного мотивации. Рассмотрим пример, в котором рассчитывается и выводится на консоль таблица умножения:
В данном случае для разделения чисел мы использовали знак табуляции, это дало следующий результат:
Таблица выглядит ровно, но она слишком широкая. Для того, чтобы сделать таблицу более компактной, будем использовать метод printf(). Заменим в предыдущем коде строку
Получим следующий результат:
Как мы видим, таблица стала компактнее. Более того, теперь мы можем уменьшать или увеличивать промежутки между числами по нашему желанию. Для этого нужно лишь заменить число 4 в выражении «%4d».
Далее рассмотрим метод printf() и его возможности подробнее.
Использование printf для форматирования в Java
Метод printf() принадлежит классу PrintStream, который отвечает за вывод информации. Уже знакомые нам методы print() и println() также являются методами класса PrintStream.
Метод printf определен следующим образом:
Первый аргумент format это строка, определяющая шаблон, согласно которому будет происходить форматирование. Для ее записи существуют определенные правила.
В предыдущем примере формат был «%4d», где d означает вывод десятичного целого числа, а 4 — означает то, что если количество знаков в числе меньше, чем 4, то оно будет спереди дополнено пробелами на недостающее (до 4-х) количество знаков (тем самым подвинуто вправо).
Для наглядности приведем еще один пример, который выводит столбиком несколько чисел.
На консоль будет выведено:
Здесь в строке форматирования мы использовали несколько раз %6d%n, где каждое %6d задает формат для одного из чисел, указанных далее в качестве аргументов. Первое %6d форматирует число 666666, второе %6d форматирует 55555 и т.д. %n означает перевод строки. Поскольку ко всем числам было применено форматирование %6d, то числа, которые содержат менее 6 знаков подвинуты вправо на недостающее количество знаков и тем самым красиво выровнены.
Данный пример иллюстрирует также то, что метод printf может содержать несколько аргументов после строки с форматом. На что указывает Object… args в сигнатуре метода. Эти аргументы должны соответствовать ссылкам на них в строке формата. Например, если в строке формата стоит символ d, отвечающий за вывод целого десятичного числа, а далее в аргументе вы укажете строку, при компиляции произойдет ошибка преобразования формата java.util.IllegalFormatConversionException. Если аргументов больше, чем определено в формате, то лишние аргументы будут игнорироваться.
Общий вид инструкции форматирования следующий:
Все возможные флаги и преобразования (conversion) указаны в официальной документации. Здесь мы не ставим цель изучить их все, наша цель — научиться применять форматирование. Поэтому рассмотрим несколько примеров.
Пример 1. Наглядный пример инструкции форматирования в ее полном виде приведен на следующей картинке:
Если мы применим формат с картинки к числу Pi
Получим следующий результат на консоли:
Разберем данную инструкцию с конца:
Пример 2. Рассмотрим пример демонстрирующий вывод на консоль до знакомства с форматированием и после.
Без форматирования
На консоль будет выведено:
В этом случае преобразование кода в строку автоматически генерируется компилятором Java. Этот способ плох тем, что при большом количестве переменных и текста для вывода, легко потерять контроль над результатами.
С форматированием
Где %d отвечает за вывод значения переменной i, а %f за вывод значения переменной root. При этом мы уже не используем конкатенацию.
На консоль будет выведено:
Как мы видим, формат автоматически округляет число до 6 знаков после запятой. Однако, при форматировании мы можем устанавливать такое количество знаков после запятой, которое нам нужно, например:
Выведет число с двумя знаками после запятой.
Далее на примерах рассмотрим наиболее популярные правила форматирования.
Форматирование целых чисел
Вывод целого числа
Вывод целого числа с разделением тысяч
Число менее 7 знаков будет «подвинуто» вправо на недостающее количество знаков.
Число менее 7 знаков будет дополнено нулями слева на недостающее количество знаков.
Число будет дополнено знаком + и, если оно менее 7 знаков, то будет дополнено нулями на недостающее количество знаков.
Число будет выровнено по левому краю и, если оно менее 7 знаков, то будет дополнено пробелами справа на недостающее количество знаков.
Разумеется вместо 7 можно использовать любое другое положительное целое число.
Форматирование чисел с плавающей точкой
Вывод числа e. Автоматическое округление до 6 знаков после запятой.
Число менее 10 знаков будет «подвинуто» вправо на недостающее количество знаков.
Число менее 10 знаков будет дополнено нулями слева на недостающее количество знаков.
Число будет дополнено знаком + и, если оно менее 10 знаков, то будет дополнено нулями на недостающее количество знаков.
Число будет выведено с 15 знаками после запятой.
Число будет выведено с 3-мя знаками после запятой и, если оно менее 8 символов, то будет «подвинуто» вправо на недостающее количество знаков.
Число будет выровнено по левому краю, выведено с 3-мя знаками после запятой и, если оно менее 8 знаков, то будет дополнено пробелами справа на недостающее количество знаков.
Форматирование строк
Если строка содержит менее 10 символов, то «подвинуть » ее вправо на недостающее количество символов.
Строка будет выровнена по левому краю и, если она менее 10 символов, то будет дополнена справа пробелами на недостающее количество символов.
Выведет первые 3 символа строки.
Выведет первые 3 символа строки и подвинет их вправо на недостающее до 8 количество символов.
Локализация
В разных странах некоторые записи принято производить по-разному. Например, в одних странах дробное число принято писать с точкой «3.68», а в других с запятой «3,68». Java нам позволяет соблюдать эти традиции. Метод printf имеет еще одну сигнатуру:
printf(Locale l, String format, Object… args)
Первым аргументом стоит Locale l, который и определяет локализацию. Для того, чтобы использовать локализацию необходимо вначале файла с вашим кодом импортировать библиотеку java.util.Locale.
Рассмотрим несколько примеров применения:
В зависимости от указанной страны используются разные разделители для тысяч.
В зависимости от указанной страны используются разные разделители у дробных чисел.
Использование String.format
В случае, если нет необходимости выводить отформатированную строку, а нужно просто ее сохранить для дальнейшего использования (например, для записи в лог или базу данных) следует использовать метод format из класса String. Принципы форматирования в этом случае абсолютно такие же, как у описанного выше printf, но этот метод вместо вывода строки сохраняет ее как отформатированную строку.
Это далеко не все возможности форматирования в Java. Существуют несколько классов, предназначенных для более сложного форматирования, но их оставим для дальнейших уроков.
Закончить урок хочется примером, в котором используются форматирование всех изученных в этом уроке типов данных: целых чисел, чисел с плавающей точкой и строк.
Пример: Таблица курсов валют
Результат вывода на консоль:
Полезные ссылки из официальной документации:
String.format
— Я еще хотела тебе рассказать о методе String.format.
Это статический метод класса String, но очень полезный. Но начну издалека.
Когда тебе нужно вывести в одной строке текст, содержащий значения нескольких переменных, как ты будешь это делать?
— Не очень читаемо – не так ли?
— А по-моему – нормально.
— Но вот если имена переменных у тебя будут длинные или нужно будет вызывать методы для получения данных, будет уже не очень читаемо:
— Ну, если так, то да – не очень читаемо.
— Дело в том, что в реальных программах такое встречается очень часто, поэтому я хочу показать тебе, как можно упростить себе жизнь с помощью метода String.format.
— Да говори же скорее, что это за волшебный метод такой?
— Вот как можно записать приведенный выше код:
В метод String.format первым параметром передается строка-шаблон, в которой, на местах, в которые мы хотим подставить значения, стоят специальные символы: %s, %d.
После строки-шаблона передаются параметры, значения которых и будут подставлены на место символов %s, %d.
Если нужно подставить строку мы пишем %s, если число — %d.
Вот тебе пример попроще:
— Да, это очень удобно.
— А ведь еще можно делать и так:
— Гм. Действительно полезный метод, спасибо, Элли.
— Если ты хочешь использовать в методе format другие типы данных, то вот тебе таблица:
| Обозначение | Тип |
|---|---|
| %s | String |
| %d | целое число: int, long, … |
| %f | вещественное число: float, double |
| %b | boolean |
| %c | char |
| %t | Date |
| %% | Символ % |
На самом деле у этих параметров еще есть свои настройки, а у них свои.
Но для начала тебе этого хватит. Если же нет – вот тебе ссылка на официальную документацию:
Форматирование строк
1. Класс Formatter
Рассмотрим использование класса Formatter :
где %s называется спецификатором формата.
Следующий пример использует класс Formatter для отображения дробного числа:
2. Метод format() классов PrintStream, PrintWriter и String
С помощью метода String. format() тоже возможно форматирование:
3. Спецификаторы формата
%a Шестнадцатеричное значение с плавающей точкой
%b Логическое (булево) значение аргумента
%c Символьное представление аргумента
%d Десятичное целое значение аргумента
%h Хэш-код аргумента
%e Экспоненциальное представление аргумента
%f Десятичное значение с плавающей точкой
%g Выбирает более короткое представление из двух: %е или %f
%o Восьмеричное целое значение аргумента
%n Вставка символа новой строки
%s Строковое представление аргумента
%x Шестнадцатеричное целое значение аргумента
4. Флаги формата
| — | Выравнивание влево |
| # | Изменяет формат преобразования |
| 0 | Выводит значение, дополненное нулями вместо пробелов. Применим только к числам. |
| Пробел | Положительные числа предваряются пробелом |
| + | Положительные числа предваряются знаком +. Применим только к числам. |
| , | Числовые значения включают разделители групп. Применим только к числам. |
| ( | Отрицательные числовые значения заключаются в скобки. Применим только к числам. |
Рассмотрим пример использования флагов:
Как отформатировать строку в Java с примерами
В этом уроке мы будем форматировать строки на Java с помощью printf (), System.format (), String.format(), классов форматирования и форматирования сообщений.
Вступление
В этой статье мы рассмотрим несколько из этих подходов. Мы покажем некоторые особенности того, как можно использовать каждую из техник и в каких обстоятельствах. Используя эти знания, вы будете знать, как подходить к форматированию строк и какие методы использовать.
System.out.printf()
Например, вы можете напечатать десятичное число с точностью до семи знаков после запятой или число в шестнадцатеричном представлении. Или у вас может быть предопределенное сообщение для приветствия пользователей, но вы хотели бы отформатировать его, чтобы включить имя пользователя.
аргументы vararg удобно ожидает аргументы (т. Е. Значения) для строки шаблона. Например, если шаблон содержит заполнители для двух чисел, метод printf() также будет ожидать два числа в качестве аргументов :
Выполнение этого кода приведет к:
Спецификаторы Формата
В случае выполнения этот код выведет Привет, читатель на консоль. Символ %s представляет спецификатор формата для строк, аналогично тому, как %d представляет спецификатор формата для десятичных чисел.
Существует множество спецификаторов формата, которые мы можем использовать. Вот некоторые из наиболее распространенных:
Если мы хотим напечатать, например, символ и восьмеричное число, мы будем использовать %c и %o спецификаторы соответственно. Вы можете заметить что-то необычное: спецификатор новой строки. Если вы не привыкли к поведению printf () из C, может показаться немного странным указывать такие вещи.
Ну, printf() по умолчанию не пишет новую строку. На самом деле, по умолчанию он почти ничего не делает. В принципе, если вы хотите, чтобы что-то произошло, вы должны сделать это сами.
То есть – если у нас есть несколько операторов printf() без спецификатора новой строки:
Результатом было бы:
Хотя, если мы включим символ новой строки:
Тогда результат был бы:
Escape-символы
В дополнение к описанным выше спецификаторам формата существует еще один тип символов форматирования: Escape-символы.
Если вы попытаетесь запустить это, ваш компилятор наверняка выдаст исключение. Если вы посмотрите внимательно, даже код, который выделяет код на этой странице, выделит ); как строку, а не закрытую скобку метода.
Произошло то, что мы попытались напечатать символ, который имеет особое, скрытое значение. Кавычки используются для обозначения начала и конца строки.
Комбинация \ и » конкретно указывает компилятору, что мы хотели бы вставить символ » в это место и что он должен рассматривать » как конкретное значение, а не зарезервированный символ.
Применение escape-символа \ может вызвать различные эффекты, основанные на последующем. Передача обычного символа (не зарезервированного) ничего не даст, и \ будет рассматриваться как значение.
Хотя некоторые комбинации (также называемые командами) имеют другое значение для компилятора:
Возможно, вы заметили %% в качестве последней комбинации.
Почему это так? Почему \% просто не используется?
Однако символ \ предназначен для компилятора. Он указывает, куда и что вставлять. Команда \% просто не определена, и мы используем % escape – символ, чтобы избежать эффекта последующего % символа-если это имеет смысл.
Основное Использование
Давайте отформатируем строку с несколькими аргументами разных типов:
Поплавок и двойная точность
С помощью printf () мы можем определить пользовательскую точность для чисел с плавающей запятой:
Выполнение этого кода дает:
Заполнение Формата
Мы также можем добавить заполнение, включая переданную строку:
Git Essentials
Ознакомьтесь с этим практическим руководством по изучению Git, содержащим лучшие практики и принятые в отрасли стандарты. Прекратите гуглить команды Git и на самом деле изучите это!
Здесь после символа % мы передали число и спецификатор формата. В частности, нам нужна строка с 10 символы, за которыми следует новая строка. Поскольку stack содержит только 5 символов, еще 5 добавляются в качестве дополнения, чтобы “заполнить” строку целевым символом:
Вместо этого вы также можете добавить отступ справа:
Место действия
Мы также можем передать Locale в качестве первого аргумента, отформатировав строку в соответствии с ним:
Это приведет к получению двух целых чисел разного формата:
Индекс Аргументов
Если индекс аргумента не указан, аргументы будут просто следовать порядку присутствия в вызове метода:
Выполнение этого кода приводит к:
Вы можете указать обоим спецификаторам на один и тот же аргумент. В нашем случае это означало бы, что мы используем только один аргумент, указанный в списке. Это совершенно нормально, хотя нам все равно придется указать все аргументы, присутствующие в строке шаблона:
System.out.формат()
Строка.формат()
Тем не менее, String.format() более универсален, поскольку вы действительно можете использовать результат более чем одним способом.
Класс форматирования
Использование Форматирования очень похоже на другие методы, показанные ранее. Самая большая разница заключается в том, что для его использования необходимо создать экземпляр Форматера объекта:
В связи с этим возникает вопрос:
Почему бы мне не всегда просто использовать предыдущие методы, поскольку они более лаконичны?
Есть еще одно важное различие, которое делает класс Форматер довольно гибким:
Формат сообщения
Наконец, давайте покажем один последний метод форматирования, который не использует Форматер под капотом.
Кодовый кредит: Документы Oracle
На выходе получается:
Вывод
В этой статье мы рассмотрели довольно много способов форматирования строк в ядре Java.
Каждая техника имеет конкретные варианты использования, поэтому, надеюсь, вы сможете знать, когда использовать каждую из них в будущем.
Форматирование строк Java
Для создания форматированного текстового вывода предназначен класс java.util.Formatter. Этот класс обеспечивает преобразование формата, позволяющее выводить числа, строки, время и даты в любом необходимом разработчику виде.
В классе Formatter объявлен метод format(), который преобразует переданные в него параметры в строку заданного формата и сохраняет в объекте типа Formatter. Аналогичный метод объявлен у классов PrintStream и PrintWriter. Кроме того, у этих классов объявлен метод printf() с параметрами идентичными параметрам метода format(), который осуществляет форматированный вывод в поток, тогда как метод format() сохраняет изменения в объекте типа Formatter. Таким образом, метод printf()автоматически использует возможности класса Fomatter и подобен функции printf()языка С.
Класс Formatter преобразует двоичную форму представления данных
в форматированный текст. Он сохраняет форматированный текст в буфере, содержимое которого можно получить в любой момент. Можно предоставить классу Formatterавтоматическую поддержку этого буфера либо задать его явно при создании объекта. Существует возможность сохранения буфера класса Formatter в файле.
Для создания объекта класса существует более десяти конструкторов. Ниже показаны наиболее используемые на моей практике:
Formatter(Appendable buf, Locale loc)
Formatter(String filename) throws FileNotFoundException
Formatter(String filename, String charset)
throws FileNotFoundException, UnsupportedEncodingException
Formatter(File outF) throws FileNotFoundException
В приведенных образцах buf задает буфер для форматированного вывода. Если параметр buf равен null, класс Formatter автоматически размещает объект типа StringBuilder для хранения форматированного вывода. Параметр loc определяет региональные и языковые настройки. Если никаких настроек не задано, используются настройки по умолчанию. Параметр filename задает имя файла, который получит форматированный вывод. Параметр charset определяет кодировку. Если она не задана, используется кодировка, установленная по умолчанию. Параметр outF передает ссылку на открытый файл, в котором будет храниться форматированный вывод. В параметре outStrm передается ссылка на поток вывода, который будет получать отформатированные данные. Если используется файл, выходные данные записываются в файл.
В классе объявлены следующие методы:
Formatter format(String fmtString, Object…args) – форматирует аргументы, переданные в аргументе переменной длины args (количество аргументов в списке вывода не фиксировано), в соответствии со спецификаторами формата, содержащимися в fmtString. Возвращает вызывающий объект;
Formatter format(Locale loc, String fmtString,
Object…args) – форматирует аргументы, переданные в аргументе переменной длины args, в соответствии со спецификаторами формата, содержащимися
в fmtString. При форматировании используются региональные установки, заданные в lос. Возвращает вызывающий объект;
IOException ioException() – если объект, приемник отформатированного вывода, генерирует исключение типа IOException, возвращает это исключение. В противном случае возвращает null;
Locale locale() – возвращает региональные установки вызывающего объекта;
Appendable out() – возвращает ссылку на базовый объект-приемник для выходных данных;
void flush() – переносит информацию из буфера форматирования и производит запись в указанное место выходных данных, находящихся в буфере. Метод чаще всего используется объектом класса Formatter, связанным с файлом;
void close() – закрывает вызывающий объект класса Formatter, что приводит к освобождению ресурсов, используемых объектом. После закрытия объекта типа Formatter он не может использоваться повторно. Попытка использовать закрытый объект приводит к генерации исключения типа
FormatterClosedEception;
String toString() – возвращает объект типа String, содержащий отформатированный вывод.
При форматировании используются спецификаторы формата:
| Спецификатор формата | Выполняемое форматирование |
| %a | Шестнадцатеричное значение с плавающей точкой |
| %b | Логическое (булево) значение аргумента |
| %c | Символьное представление аргумента |
| %d | Десятичное целое значение аргумента |
| %h | Хэш-код аргумента |
| %e | Экспоненциальное представление аргумента |
| %f | Десятичное значение с плавающей точкой |
| %g | Выбирает более короткое представление из двух: %е или %f |
| %o | Восьмеричное целое значение аргумента |
| %n | Вставка символа новой строки |
| %s | Строковое представление аргумента |
| %t | Время и дата |
| %x | Шестнадцатеричное целое значение аргумента |
| %% | Вставка знака % |
Так же возможны спецификаторы с заглавными буквами: %A (эквивалентно %a). Форматирование с их помощью обеспечивает перевод символов в верхний регистр.
