ная библиотека С++ поддерживает все специализации, у которых в первом аргументе шаблона передается тип символа, а во втором - ттт итератора вывода. Как и в случае с num put, стандарт не требует, чтобы эти специализации хранились в каждом локальном контексте.

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

Фацеты time get и time put из категории time предоставляют средства разбора и форматирования времени и даты. Функции, выполняющие эти операции, работают с объектами типа tm, определяемого в заголовочном файле <ctime>. Объекты не передаются напрямую; в аргументах передаются указатели на них.

Оба фацета из категории time в значительной степени зависят от функции strftimeO (также определяемой в заголовочном файле <ctime>). Преобразование объекта tm к текстовому представлению описывается строкой, содержащей спецификаторы формата. Краткая сводка спецификаторов приведена в табл. 14.9. Эти же спецификаторы используются фацетом time put.

Таблица 14.9 (продолжение)

Спецификатор Смысл Пример

%у Год (без указания века) 98

%Y Год (с указанием века) 1998

%Z Часовой пояс MEST

%% Литерал % %

Конечно, точный вид строки, созданной функцией strftimeO, зависит от текущего локального контекста. Примеры в таблице приведены для локального контекста "С".

Лексический разбор

Фацет time get представляет собой шаблон, в аргументах которого передаются тип символов charT и тип итератора ввода Init По умолчанию итератор ввода относится к типу istreambufJterator<charT>. В табл. 14.10 перечислены функции, определенные для фацета time jet Все эти функции, за исключением date order(), обрабатывают строку и сохраняют результаты в объекте tm, на который ссылается аргумент t. Если попытка разбора завершается неудачей, функции либо выставляют признак ошибки (например, модификацией аргумента err), либо сохраняют неопределенное значение. Это означает, что надежная обработка гарантирована для времени, сгенерированного программой, но не для времени, введенного пользователем.

Таблица 14.10. Функции фацета time get Выражение Описание

tg.get time(beg, end, fmt, err, t) Разбирает строку между beg и end как время,

сгенерированное функцией strftime() со спецификатором X

tg.get date(beg, end, fmt, err, t) Разбирает строку между beg и end как время,

сгенерированное функцией strftime() со спецификатором х

tg.get weekday(beg, end, fmt, err, t) Разбирает строку между beg и end как название

дня недели

tg.get monthname(beg, end, fmt, err, t) Разбирает строку между beg и end как название месяца

tg.get year(beg, end, fmt, err, t) Разбирает строку между beg и end как год

tg.date order() Возвращает порядок следования компонентов даты,

исполиуемый фацетом

Все функции возвращают итератор, установленный в позицию за последним прочитанным символом. Разбор прекращается при успешном завершении или в случае ошибки (например, если строка не интерпретируется как дата).

Функция, читающая название дня недели или месяца, читает как сокращенные, так и полные названия. Если за сокращением следует буква, допустимая

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

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

Функция date order() возвращает порядок следования дня, месяца и года в строке даты. Это необходимо для некоторых дат, которые не позволяют определить нужный порядок по текстовому представлению даты. Например, 1 февраля 2003 года может выводиться как в виде 3/2/1, так и в виде 1/2/3. В классе time base, базовом для фацета time get, определен перечисляемый тип dateorder с возможными порядками следования компонентов даты. Значения этого типа перечислены в табл. 14.11.

Таблица 14.11. Значения перечисляемого типа dateorder Значение Описание

no order Определенный порядок отсутствует (например, дата по юлианскому календарю) dmy День, месяц, год

mdy Месяц, день, год

ymd Год, месяц, день

ydm Год, день, месяц

Стандарт требует, чтобы в каждом локальном контексте хранились две специализации time get<char> и tim€ get<wchar t> (в обеих специализациях для второго аргумента используется значение по умолчанию). Кроме того, стандартная библиотека С++ поддерживает все специализации, у которых в первом аргументе шаблона передается тип символа, а во втором - тип итератора ввода. Стандарт не требует, чтобы эти специализации хранились в каждом локальном контексте.

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

Фацет time put используется для форматирования времени и даты. Он представляет собой шаблон, в аргументах которого передаются тип символов charT и тип итератора вывода Outlt. По умолчанию итератор вывода относится к типу ostreambuf Jterator (см. с. 638).

В фацете time put определены две функции put(), которые преобразуют дату, хранящуюся в объекте типа tm, в последовательность символов, записываемую через итератор вывода. Функции фацета time put перечислены в табл. 14.12.

Таблица 14.12. Функции фацета time put Выражение Описание

tp.put(to, fmt, fill, t, cbeg, cend) Преобразует дату в соответствии со строкой [cbeg,cend) tp.put(to, fmt, fill, t, cvt, mod) Преобразует дату с использованием спецификатора cvt