13.3. Запись и чтение дат и времен.

Проблема.

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

Решение.

Используйте тип 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.\n";

 } else {

  cerr << "Unable to read cin!\n";

 }

}

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

#include <iostream>

#include <locale>

#include <string>

Using namespace std;

Int main() {

 cin.imbue(locale("german"));

 const time_get<char>& dateReader =

  use_facet<time_get<char> >(cin.getloc());

 time_base::dateorder d = dateReader.date_order();

 string s;

 switch (d) {

 case time_base::no_order:

  s = "No order";

  break;

 case time_base::dmy:

  s = "day/month/year";

  break;

 case time_base::mdy:

  s = "month/day/year";

  break;

 case time_base::ymd:

  s = "year/month/day";

  break;

 case time_base::ydm:

  s = "year/day/month";

  break;

 }

 cout << "Date order for locale " << cin.getloc().name().

  << " is " << s << endl;

}

Имеется еще одно средство, которое может оказаться полезным при инстанцировании фасетов: has_facet. Шаблон этой функции возвращает значение типа bool, показывающее, определен или нет нужный вам фасет в заданной локализации. Поэтому для надежности используйте has_facet во всех случаях, когда вы инстанцируете фасет. Если она возвращает значение «ложь», вы всегда можете перейти к используемой по умолчанию классической локализации С, поскольку ее наличие гарантировано в реализации, отвечающей требованиям стандарта. has_facet применяется следующим образом.

If (has_facet<time_put<char> >(loc)) {

 const time_put<char>& dateWriter =

  use_facet<time_put<char> >(loc);

Разобравшись однажды в синтаксисе классов time_get и time_put, вы поймете, что использовать их достаточно просто. Как всегда, можно воспользоваться typedef, чтобы свести к минимуму количество неприятных угловых скобок.

Typedef time_put<char> TimePutNarrow;

Typedef time_get<char> TimeGetNarrow;

// ...

Const TimeGetNarrow& dateReader = use_facet<TimeGetNarrow>(loc);

Процедура записи и чтения дат в локализованных форматах немного утомительна, однако, после того как вы один раз разберетесь в требованиях класса локализации locale, вы сможете это делать эффективно и быстро. Глава 5 полностью посвящена датам и временам, поэтому более детальные сведения по форматированию вывода дат и времен вы найдете в рецепте 5.2.

Смотри также.

Глава 5 и рецепт 5.2.