C++. Сборник рецептов

Требуется отобразить или прочитать значения дат и времен, используя местные соглашения по форматированию.

Решение

Используйте тип time_t и tm struct из <ctime>, а также фасеты даты и времени, предусмотренные в <locale>, для записи и чтения дат и времен (фасеты вскоре будут рассмотрены при обсуждении примера). См. пример 13.4.

Пример 13.4. Запись и чтение дат

#include <iostream>
#include <ctime>
#include <locale>
#include <sstream>
#include <iterator>
using namespace std;
void translateDate(istream& in, ostream& out) {
 // Создать считывающий дату объект
 const time get<char>& dateReader =
  use_facet<time_get<char> >(in.getloc());
 // Создать объект состояния который будет использован фасетом для
 // уведомления нас о возникновении проблемы
 ios_base::iostate state = 0;
 // Маркер конца
 istreambuf_iterator<char> end;
 tm t; // Структура для представления времени (из <ctime>)
 // Теперь, когда все подготовлено, считать дату из входного потока
 // и поместить ее в структуру времени.
 dateReader.get_date(in, end, in, state, &t);
 // В данный момент дата находится в структуре tm. Вывести ее в поток,
 // используя соответствующую локализацию. Убедитесь, что выводятся только
 // достоверные данные из t.
 if (state == 0 || state == ios_base::eofbit) { // Чтение выполнено успешно.
  const Time_put<char>& dateWriter =
   use_facet<time_put<char> >(out.getloc());
  char fmt[] = '%x';
  if (dateWriter.put{out, out, out.fill(),
   &t, &fmt[0], &fmt[2]).failed())
   cerr << 'Unable to write to output stream.
';
 } else {
  cerr << 'Unable to read cin!
';
 }
}
int main() {
 cin.imbue(locale('english'));
 cout.imbue(locale('german'));
 translateDate(cin, cout);
}

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

3/28/2005
28.03.2005

Обсуждение

Для правильной записи и чтения значений даты и времени необходимо знать некоторые детали проекта класса 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, то это говорит о том, что поток