Книга: C# 4.0: полное руководство

Форматирование

Форматирование

Когда данные встроенных в C# типов, например int или double, требуется отобразить в удобочитаемой форме, приходится формировать их строковое представление. Несмотря на то что в C# для такого представления данных автоматически предоставляется формат, используемый по умолчанию, имеется также возможность указать выбранный формат вручную. Так, в части I этой книги было показано, что числовые данные можно выводить в формате выбранной денежной единицы. Для форматирования данных числовых типов в C# предусмотрен целый ряд методов, включая методы Console.WriteLine(), String.Format() и ToString(). Во всех этих методах применяется один и тот же подход к форматированию. Поэтому освоив один из них, вы сможете без особого труда применять и другие.

Форматирование осуществляется с помощью двух компонентов: спецификаторов формата и поставщиков формата. Конкретная форма строкового представления отдельного значения зависит от спецификатора формата. Следовательно, спецификатор формата определяет, в какой именно удобочитаемой форме будут представлены данные. Например, для вывода числового значения в экспоненциальном представлении (т.е. в виде мантиссы и порядка числа) используется спецификатор формата Е.

Как правило, конкретный формат значения зависит от культурных и языковых особенностей локализации программного обеспечения. Например, в Соединенных Штатах Америки денежные суммы указываются в долларах, а в странах ЕС — в евро. Для учета культурных и языковых отличий в C# предусмотрены поставщики формата. В частности, поставщик формата определяет порядок интерпретации спецификатора формата. Поставщик формата создается путем реализации интерфейса IFormatProvider, в котором определяется метод GetFormat(). Для всех встроенных числовых типов и многих других типов данных в среде .NET Framework предопределены соответствующие поставщики формата. Вообще говоря, данные можно отформатировать, не указывая конкретный поставщик формата, поэтому поставщики формата не рассматриваются далее в этой книге.

Для того чтобы отформатировать данные, достаточно включить спецификатор формата в метод, поддерживающий форматирование. О применении спецификаторов формата речь уже шла в главе 3, тем не менее к этому вопросу стоит вернуться вновь. Применение спецификаторов формата рассматривается далее на примере метода Console.WriteLine(), хотя аналогичный подход применим и к другим методам, поддерживающим форматирование.

Для форматирования выводимых данных служит следующая форма метода WriteLine().

WriteLine("форматирующая строка", arg0, arg1, ... , argN) ;

В этой форме аргументы метода WriteLine() разделяются запятой, а не знаком +. А форматирующая строка состоит из двух следующих элементов: обычных печатаемых символов, отображаемых в исходном виде, а также команд форматирования.

Ниже приведена общая форма команд форматирования:

{argnum, width: fmt}

где argnum — это номер отображаемого аргумента, начиная с нуля; width — минимальная ширина поля, a fmt — спецификатор формата. Параметры width и fmt не являются обязательными. Поэтому в своей простейшей форме команда форматирования просто указывает конкретные аргументы для отображения. Например, команда { 0 } указывает аргумент агд0, команда {1} — аргумент arg1 и т.д.

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

Если в команде форматирования указывается параметр fmt, то данные отображаются в указываемом формате. В противном случае используется формат, выбираемый по умолчанию. Если же в команде форматирования указывается параметр width, то выводимые данные дополняются пробелами для достижения минимально необходимой ширины поля. При положительном значении параметра width выводимые данные выравниваются по правому краю, а при отрицательном значении — по левому краю.

Оставшаяся часть данной главы посвящена вопросам форматирования и отдельным спецификаторам формата.

Для числовых данных определено несколько спецификаторов формата, сведенных в табл. 22.4. Каждый спецификатор формата может включать в себя дополнительный, но необязательный спецификатор точности. Так, если числовое значение требуется указать в формате с фиксированной точкой и двумя десятичными разрядами в дробной части, то для этой цели служит спецификатор F2.

Таблица 22.4. Спецификатооы формата числовых данных

Спецификатор

Формат - Назначение спецификатора точности

C

Денежная единица

Задает количество десятичных разрядов

с

То же, что и С

D

Целочисленный (используется только с

целыми числами)

Задает минимальное количество цифр. При необходимости результат дополняется начальными нулями

d

То же, что и D

Е

Экспоненциальное представление чисел (в обозначении используется прописная буква Е)

Задает количество десятичных разрядов. По умолчанию используется шесть рязрядов

е

Экспоненциальное представление чисел (в обозначении используется строчная буква е)

Задает количество десятичных разрядов. По умолчанию используется шесть рязрядов

F

Представление чисел с фиксированной точкой

Задает количество десятичных разрядов

f

То же, что и F

G

Используется более короткий из двух форматов: Е или F

См. спецификаторы Е и F

g

Используется более короткий из двух форматов: е или f

См. спецификаторы е и f

Представление чисел с фиксированной точкой (и запятой в качестве разделителя групп разрядов)

Задает количество десятичных разрядов

То же, что и N

Проценты

Задает количество десятичных разрядов

р

То же, что и Р

R или г

Числовое значение, которое преобразуется с помощью метода Parse() в эквивалентную внутреннюю форму. (Это так называемый “круговой” формат)

Не используется

X

Шестнадцатеричный (в обозначении используются прописные буквы A-F)

Задает минимальное количество цифр. При необходимости результат дополняется начальными нулями

x

Шестнадцатеричный (в обозначении используются строчные буквы A-F)

Задает минимальное количество цифр. При необходимости результат дополняется начальными нулями

Как пояснялось выше, конкретное действие спецификаторов формата зависит от текущих настроек параметров культурной среды. Например, спецификатор денежной единицы С автоматически отображает числовое значение в формате денежной единицы, выбранном для локализации программного обеспечения в конкретной культурной среде. Для большинства пользователей используемая по умолчанию информация о культурной среде соответствует их региональным стандартам и языковым особенностям. Поэтому один и тот же спецификатор формата может использоваться без учета культурного контекста, в котором выполняется программа.

В приведенной ниже программе демонстрируется применение нескольких спецификаторов формата числовых данных.

// Продемонстрировать применение различных
// спецификаторов формата числовых данных.
using System;
class FormatDemo {
  static void Main() {
    double v = 17688.65849;
    double v2 = 0.15;
    int x = 21;
    Console.WriteLine("{0:F2}", v);
    Console.WriteLine("{0:N5}", v);
    Console.WriteLine ("{0:e}", v);
    Console.WriteLine("{0:r}", v);
    Console.WriteLine("{0:p}", v2);
    Console.WriteLine("{0:X}", x);
    Console.WriteLine("{0:D12}", x);
    Console.WriteLine("{0:C}", 189.99);
  }
}

Эта программа дает следующий результат.

17688.66
17.688.65849
1.768866е+004
17688.65849
15.00 %
15
000000000021
$189.99

Обратите внимание на действие спецификатора точности в нескольких форматах.

Следует иметь в виду, что аргумент, связанный со спецификатором формата, определяется номером аргумента, а не его позицией в списке аргументов. Это означает, что один и тот же аргумент может указываться неоднократно в одном вызове метода WriteLine(). Эта также означает, что аргументы могут отображаться в той последовательности, в какой они указываются в списке аргументов. В качестве примера рассмотрим следующую программу.

using System;
class FormatDemo2 {
  static void Main() {
    // Форматировать один и тот же аргумент тремя разными способами.
    Console.WriteLine("{0:F2} {0:F3} {0:e}", 10.12345);
    // Отобразить аргументы не по порядку.
    Console.WriteLine("{2:d} {0:d} {l:d}", 1, 2, 3) ;
  }
}

Ниже приведен результат выполнения этой программы.

10.12 10.123 1.012345е+001
3 1 2

В первом операторе вызова метода WriteLine() один и тот же аргумент 10.12345 форматируется тремя разными способами. Это вполне допустимо, поскольку каждый спецификатор формата в этом вызове обозначает первый и единственный аргумент. А во втором вызове метода WriteLine() три аргумента отображаются не по порядку. Не следует забывать, что каких-то особых правил, предписывающих обозначать аргументы в спецификаторах формата в определенной последовательности, не существует. Любой спецификатор формата может обозначать какой угодно аргумент.

Оглавление книги