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.
13.4. Запись и чтение денежных значений
Проблема
Требуется записать в поток или прочитать из него денежное значение.
Решение
Используйте фасеты money_put и money_get для записи или чтения денежных значений, как показано в примере 13.6.
Пример 13.6. Запись и чтение денежных значений
#include <iostream>
#include <locale>
#include <string>
#include <sstream>
using namespace std;
long double readMoney(istream& in, bool intl = false) {
long double val;
// Создать фасет для чтения
const money_get<char>& moneyReader =
use_facet<money_get<char> >(in.getloc());
// Маркер конца
istreambuf iterator<char> end;
// Переменная состояния для обнаружения ошибок
ios_base::iostate state = 0;
moneyReader.get(in, end, intl, in, state, val);
// если что-то не получилось, будет установлен бит неудачного завершения
if (state != 0 && !(state & ios_base::eofbit))
throw "Couldn't read money!n";
return(val);
}
void writeMoney(ostream& out, long double val, bool intl = false) {
// Создать фасет для записи
const money_put<char>& moneyWriter =
use_facet<money_put<char> >(out.getloc());
// Записать данные в поток. Вызвать failed() (возвращает итератор
// ostreambuf_iterator), чтобы можно было обнаружить ошибку.
