Форматирование. 
Программирование. 
Базовый курс с#

Под форматированием понимают преобразование значения конкретного типа в соответствующее ему строковое представление.

При выводе, например, с помощью Console. Write () значений базовых типов (например, int или double) они автоматически преобразуются в символьные строки. Если программиста не устраивает автоматически выбранный формат их внешнего представления, он может его изменить. Для этого можно воспользоваться статическим методом Format класса string или использовать так называемую строку форматирования в качестве первого параметра методов, поддерживающих форматирование, например, Console. Write () и Console. WriteLine (). В обоих случаях правила подготовки исходных данных для получения желаемого результата (новой строки) одинаковы. Рассмотрим эти правила применительно к методу Format класса string:

public static string Format (string form, params object[ ] ar).

Так как синтаксис заголовков методов (функций) мы формально еще не рассматривали, поясним элементы приведенного заголовка.

public — модификатор доступа. Указывает что метод открытый, т. е. доступен вне класса string.

static — модификатор, относящий метод к классу в целом, а не к его объектам.

string — тип возвращаемого методом значения.

Format — имя метода.

form — произвольно выбранное имя параметра (типа string), представляющего строку форматирования.

params — модификатор, указывающий, что следующий за ним массив-параметр аг может быть заменен при обращении к методу любым количеством аргументов (включая нуль, т. е. аргументы могут отсутствовать).

object — тип элементов массива-параметра аг. Так как object — это базовый класс для всех типов языка С#, то аргументы, соответствующие элементам массива object[ ] аг, могут иметь любой тип.

Итак, метод string.FormatO возвращает строку, построенную на основе строки форматирования и значений аргументов, следующих за этой строкой в обращении к методу FormatO.

Строка форматирования включает неизменяемые символы и конструкции, называемые полями подстановок. Структура поля подстановки:

{N[, W][:S[R]]},.

где N — номер аргумента; W — ширина поля; S — спецификатор формата; R — спецификатор точности.

Квадратные скобки в поля подстановки не входят и обозначают необязательность ограниченного ими фрагмента (элемента) поля. В поле подстановки разрешено опускать все элементы кроме фигурных скобок и номера аргумента. Именно поэтому все остальные элементы поля подстановки мы ограничили квадратными скобками. Воспользуемся этим правилом, чтобы привести такой пример.

int num = 23, den = 6;

string result, // ссылка на строку, с результатом form = «Числитель: {0}, знаменатель: {1}» .

+ «, дробь: {0}/{1}=={2}» ;

result = string. Format (form, num, den, num/den);

Console.WriteLine (result);

В коде определены две ссылки result и form на объекты типа string. Значение строки, связанной со ссылкой form, определено инициализирующим выражением в виде конкатенации двух строковых литералов. В них пять полей подстановок. Номера в полях указывают, символьные представления значений каких аргументов (по счету, начиная с 0) будут подставлены вместо соответствующих полей. В обращении к методу Format () первый аргумент — строка form, затем num — аргумент, с номером 0, den — аргумент, которому соответствует номер 1, num/den — выражение, значение которого воспринимается как аргумент с номером 2. В результате выполнения подстановок метод Format () возвращает строку, ссылка на которую присвоена переменной result. Выводя эту строку на консоль, получим:

Числитель: 23, знаменатель: б, дробь: 23/6==3.

Обратите внимание на округление результата целочисленного деления.

В приведенном примере поля подстановок содержали только номера аргументов. Разберем назначение других элементов, которые в поле подстановки необязательны. Запятая и следующее за ним число (обозначенное в структуре поля подстановки как W) в поле подстановки определяет количество позиций, выделяемых для изображения подставляемого значения. Если эти элементы (запятая и число) опущены, то число позиций определяется изображением выводимого значения, т. е. ширина поля выбирается минимально достаточной для изображения значения. Если ширина поля W указана, и она превышает длину помещаемого в поле значения, то при положительной длине поля W изображаемое значение выравнивается по правой границе. Если перед шириной поля W стоит минус, то выравнивание выполняется по левой границе поля.

Спецификатор формата S задает вид изображаемого значения. Для разных типов данных этот спецификатор выбирается по-разному. Следующая за ним необязательная цифра — спецификатор точности R — влияет на формируемое значение, и это влияние зависит от спецификатора формата.

Спецификаторы формата S и точности R.

Пример:

double dou = 1234.567;

string form = «Спецификация E4: {0:E4}» +.

", спецификация F4: {0:F4}" ;

string result = string. Format (form, dou);

Console.WriteLine (result);

В обоих полях подстановки строки форматирования опущена ширина поля, и предполагается дважды использовать только один аргумент (с номером 0).

Выводимая на консоль строка:

Спецификация Е4: 1,2346Е+003, спецификация F4: 1234,5670.

Обратите внимание на округление при выводе по формату Е4 и на дополнительный нуль в изображении числа с фиксированной точкой при выводе по формату F4. Это определяется спецификатором точности, равным 4.

Пример с целочисленным значением, выводимым с разными основаниями в поля из четырех позиций. Обратите внимание, что ширина первого поля отрицательна:

int num = 23;

string form = «Основание 10: {0, -4:D} основание 16: {0,4:X}» ;

Console.WriteLine (form, num);

Результат в консольном окне:

Основание 10: 23.

основание 16: 17.

В этом примере форматирование выполняется непосредственно при обращении к методу WriteLineQ. Первый аргумент выступает в роли форматной строки, а вызов метода string.Format () осуществляется неявно.

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

int num = 23;

string form = «Основание 10: {0, -4:D3} основание 16: {0,4:ХЗ}» ;

Console.WriteLine (form, num);

Результат:

Основание 10: 023.

основание 16: 017.

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