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

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

Фацет num get предназначен для лексического разбора текстовых представлений чисел. По аналогии с num put он оформляется в виде шаблона с двумя аргументами: типом символов charT и типом итератора ввода Init, который по умолчанию равен (streambufJterator<charT>. Фацет поддерживает набор функций get(), различающихся только по типу последнего аргумента. Пример использования фацета numget:

std;:locale loc: Локальный контекст

Init beg =

Init end =

std: ;ios base& fmt =

Начало входной лоследовательности

Конец входной последовательности

Поток, определяющий формат ввода

std::ios base::iostate err: Состояние после вызова

Т value = ...: Значение после успешного вызова

Получение фацета разбора числовых данных для контекста loc const std::num get<charT.lnlt>& ng = std:;use facet<std::nuni get<charT.Inlt> >(loc);

Чтение данных с использованием фацета ng.get(beg. end. fmt. err. value):

В этом фрагменте делается попытка выполнить разбор числового значения, соответствующего типу Т, из последовательности символов между beg и end. Формат предполагаемого числового значения определяется аргументом frnt. Если разбор завершается неудачей, в переменной егг устанавливается флаг ios base::failbit; если все прошло нормально, состояние ios base::goodbit сохраняется в егг, а полученное значение - в value. Переменная value изменяется только в слзае успешного разбора. Если вся последовательность символов была полностью использована, функция get() возвращает второй параметр (end). В противном случае возвращается итератор, указывающий на первый символ, который не был обработан как часть числового значения.

Фацет num get содержит функции чтения для типов bool, long, unsigned short, unsigned int, unsigned long, float, double и long double. Некоторые из этих типов (например, unsigned short) не имеют соответствующих функций в фацете num put. Дело в том, что вывод значения типа unsigned short дает такой же результат, что и вывод значения типа unsigned short, приведенного к типу unsigned long. С другой стороны, чтение значения типа unsigned long с последующим преобразованием к unsigned short может дать результат, отличный от прямого чтения unsigned short.

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

ная библиотека С++ поддерживает все специализации, у которых в первом аргументе шаблона передается тип символа, а во втором - тип итератора вывода. Как и в случае с 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. Если попытка разбора завершается неудачей, функции либо выставляют признак ошибки (например, модификацией аргумента егг), либо сохраняют неопределенное значение. Это означает, что надежная обработка гарантирована для времени, сгенерированного программой, но не для времени, введенного пользователем.

Таблица 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() Возвращает порядок следования компонентов даты,

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

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

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