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