Для правильной записи и чтения значений даты и времени необходимо знать некоторые детали проекта класса
locale
. Прочтите введение в эту главу, если вы еще не знакомы с концепциями локализаций и фасетов.
В C++ нет стандартного класса для представления даты и времени, а наиболее подходящими для этого типами являются
time_t
и структура
tm
из
<ctime>
. Если требуется записывать и считывать даты с использованием средств стандартной библиотеки, вам придется любое нестандартное представление даты преобразовывать в структуру
tm
. Это имеет смысл, поскольку используемые вами реализации, вероятно, уже имеют встроенную поддержку форматирования дат с учетом местных особенностей.
Ранее я говорил, что фасет определяет некоторый аспект локализации, отражающий ее особенности. Более конкретно, фасет — это константная инстанциация шаблона класса символьного типа, поведение которого зависит от класса локализации, используемого при конструировании. В примере 13.4 я следующим образом создаю экземпляр фасета
time_get
.
const time_get<char*>& dateReader =
use_facet<time_get<char> >(in.getloc);
Шаблон функции
use_facet
находит заданный фасет для заданной локализации. Все стандартные фасеты являются шаблонами классов, которые принимают параметр символьного типа, и, поскольку мною считываются и записываются символы типа
char
, я инстанцирую мой класс
time_get
для
char
. Стандарт требует, чтобы реализация обеспечивала специализацию шаблона для
char
и
wchar_t
, поэтому они гарантированно существуют (хотя не гарантируется поддержка заданной локализации, кроме локализации С). Созданный мною объект
time_get
имеет спецификатор
const
, потому что предусмотренная реализацией функциональность локализации это набор правил форматирования различного вида данных в разных локализациях, и эти правила не могут редактироваться пользователем, поэтому состояние заданного фасета не должно изменяться в программном коде, где он используется.
Локализация, передаваемая мною в функцию
use_facet
, связана с потоком, в который я собираюсь записывать данные. Функция
getloc
объявляется в
ios_base
; она возвращает локализацию, связанную с потоком ввода или вывода. Наилучший подход — применение локализации, уже связанной с потоком, который вы собираетесь использовать для ввода или вывода данных; передача в качестве параметра или каким-либо другим способом имени локализации легко приводит к ошибкам.
После создания объекта, который будет выполнять реальное чтение, мне необходимо обеспечить контроль состояния потока.
ios_base::iostate state = 0;
Сами фасеты не модифицируют состояние потока (например, устанавливая
stream::failbit = 1
); вместо этого они установят соответствующее значение в вашем объекте состояния, показывая, что дату нельзя считывать. Это объясняется тем, что чтение форматированного значения терпит неудачу не обязательно из-за потока; поток ввода символов может быть в полном порядке, однако его чтение с использованием нужного вам формата может оказаться невозможным.
Реальное значение даты хранится в структуре
tm
. Вам требуется только создать локальную переменную типа tm и передать ее адрес фасету
time_get
или
time_put
.
Считав дату, я могу проверить значение переменной, которую я использую для контроля состояния потока. Если это значение равно нулю или
ios_base::eofbit
,
то это говорит о том, что поток находится в нормальном состоянии и что моя дата была считана без проблем. Поскольку в примере 13.4 мне нужно было записать дату в другой поток, пришлось создать объект, используемый именно для этой цели. Я делаю это следующим образом.
const time_put<char>& dateWriter =
use_facet<time_put<char> >(out.getloc);
Это работает так же, как и предыдущая инстанциация класса
time_get
, но в другом направлении. После этого я создал строку форматирования (используя синтаксис, подобный применяемому в функции
printf
), которая будет печатать дату. «
%x
» выводит дату, а «
%X
» выводит время. Однако следует быть осторожным: в этом примере считывается только дата, поэтому члены структуры
tm
, относящиеся ко времени, в этот момент имеют неопределенные значения.
Теперь можно писать данные в поток вывода. Это делается следующим образом.
if (dateWriter.put(out, // Итератор потока вывода
out, // Лоток вывода
out.fill, // Использовать символ заполнителя
&t, // Адрес структуры tm
&fmt[0], // Начало и конец строки форматирования
&fmt[2]
).failed) // iter_type.failed показывает, была или
// нет ошибка при записи
Функция
time_put::put
записывает дату в переданный ей поток вывода, используя локализацию, с которой был создан объект
time_put
.
time_put::put
возвращает итератор
ostreambuf_iterator
, который имеет функцию-член
failed
, позволяющую зафиксировать ситуацию, когда итератор оказывается испорченным.
get_date
не единственная функция-член, которую можно использовать для получения компонент даты из потока. Ниже перечислены некоторые из них.
get_date
Получает дату из потока, используя местные правила форматирования.
get_time
Получает время из потока, используя местные правила форматирования.
get_weekday
Получает название дня недели, например Monday, lundi, понедельник.
get_year
Получает год, используя местные правила форматирования.
Может быть полезной также функция-член
date_order
. Она возвращает перечисление (
time_base::dateorder
из
<locale>
), которое определяет порядок месяца, дня и года в дате. Эта функция может помочь в тех случаях, когда вам приходится анализировать вывод даты, полученной функцией
time_get::put
. Пример 13.5 показывает, как можно проверять порядок элементов, составляющих дату.
Пример 13.5. Определение последовательности элементов в дате