C++. Сборник рецептов - Д. Стефенс

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), чтобы можно было обнаружить ошибку.