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

 if (moneyWriter.put(out, intl, out, out.fill(), val).failed()).

  throw "Couldn't write money!\n";

}

Int main() {

 long double val = 0;

 float exchangeRate = 0.775434f; // Курс доллара по отношению к евро.

 locale locEn("english");

 locale locFr("french");

 cout << "Dollars: ";

 cin.imbue(locEn);

 val = readMoney(cin, false);

 cout.imbue(locFr);

 // Установить флаг showbase, чтобы выводить символ валюты.

 cout.setf(ios_base::showbase);

 cout << "Euros: ";

 writeMoney(cout, val = exchangeRate, true);

}

Если выполнить программу примера 13.6, можно получить следующий результат.

Dollars: $100.

Euros: EUR77,54.

Обсуждение.

Фасеты money_put и money_get записывают форматированные денежные значения в поток и считывают их из потока. Они работают почти так же, как фасеты даты/времени и числовые фасеты, описанные в предыдущих рецептах. Стандарт требует, чтобы были их реализации для стандартных символов и расширенного набора символов, например money_put<char> и money_put<wchar_t>. Как и для других фасетов, функции записи и чтения многословны, но, применив их несколько раз, легко запоминаешь параметры. money_get и money_put используют класс moneypunct, содержащий информацию о форматировании.

Сначала рассмотрим запись денежных значений в поток. Отображение денежной суммы состоит из нескольких частей: знака валюты, знака плюс или минус, разделителя тысяч и десятичной точки. Все они, кроме десятичной точки, могут отсутствовать.

Вы создаете объект money_put с типом символа и локализацией следующим образом.

Const money_put<char>& moneyWriter =

 use_facet<money_put<char> >(out.getloc());

Стандарт требует наличия версий как для char, так и для wchar_t. Разумно использовать локализацию потока, в который осуществляется запись, чтобы избежать несогласованности, возникающей при попытке синхронизации потока и объекта money_put. На следующем шаге вызовите метод put для записи денежного значения в поток вывода.

If (moneyWriter.put(out, // Итератор вывода.

 intl,                   // bool: использовать формат intl?

 out,                    // ostream&

 out.fill(),             // использовать символ заполнителя.

 val)                    // денежное значение, тип long double.

.failed()) throw "Couldn't write money!\n";

Функция money_put::put записывает денежное значение в переданный ей поток вывода, используя локализацию, с которой был создан объект money_put. money_put::put возвращает итератор ostreambuf_iterator, который ссылается на позицию за последним выведенным символом; этот итератор имеет функцию-член failed, позволяющую зафиксировать ситуацию, когда итератор оказывается испорченным.

Все параметры money_put::put не требуют дополнительных пояснений, кроме, возможно, второго (аргумент intl в примере). Он имеет тип bool и показывает, будет использоваться символ валюты (например, $, €) или трехбуквенное международное обозначение валюты (например, USD, EUR). Для использования символа валюты установите его в значение false, а для использования международного обозначения валюты — в значение true.

При записи денежных значений в поток вывода можно задавать некоторые параметры потока, которые управляют форматированием. Ниже описывается каждый параметр и объясняется его воздействие на вывод денежного значения.

Ios_base::internal.

Если при форматировании денежного значения задается пробел или пустое значение, будет использован символ заполнителя (а не пробел). Ниже при обсуждении moneypunct приводятся дополнительные сведения по шаблонам форматирования.

Ios_base::left и ios_base::right.

Выравнивает денежное значение влево или вправо; при этом остальные позиции в пределах заданной ширины заполняются символом заполнителя (см. описание следующего параметра, width). Это удобно, потому что облегчает табуляцию денежного значения.

Ios_base::width.

Значения, выдаваемые функцией money_put, подчиняются стандартным правилам управления шириной поля потока. По умолчанию эти значения выравниваются влево. Если поле больше, чем размер значения, используется символ заполнителя, указанный при вызове функции money_put.

Ios_base::showbase.

Если этот флаг имеет значение «истина», символ валюты выводится, в противном случае он не выводится.

Как я говорил ранее, функции money_get и money_put используют класс moneypunct, в котором фактически хранится информация о форматировании. Вам не стоит беспокоиться о классе moneypunct, если вы не заняты реализацией стандартной библиотеки, но вы можете использовать его для исследования параметров форматирования, применяемых в конкретной локализации, moneypunct содержит такие сведения, как используемый символ валюты, символ, используемый в качестве десятичной точки, формат положительных и отрицательных значений и т.д. В примере 13.7 представлена короткая программа, печатающая информацию о формате денежных значений, который используется в заданной локализации.

Пример 13.7. Вывод информации о форматировании денежных значений.

#include <iostream>

#include <locale>

#include <string>

Using namespace std;

String printPattern(moneypunct<char>::pattern& pat) {

 string s(pat.field); // pat.field имеет тип char[4].

 string r;

 for (int i = 0; i < 4; ++i) {

  switch (s[i]) {

  case moneypunct<char>::sign:

   r += "sign ";

   break;

  case moneypunct<char>::none:

   r += "none ";

   break;

  case moneypunct<char>::space:

   r += "space ";

   break;

  case moneypunct<char>::value:

   r += "value ";

   break:

  case moneypunct<char>::symbol:

   r += "symbol ";

   break;

  }

 }

 return(r);

}

Int main() {

 locale loc("danish");

 const moneypunct<char>& punct =

  use_facet<moneypunct<char> >(loc),

 cout << "Decimal point: " << punct.decimal_point() << '\n'.

  << "Thousands separator. " << punct.thousands_sep() << '\n'.

  << "Currency symbol: " << punct.curr_symbol() << '\n'.

  << "Positive sign: " << punct.positive_sign() << '\n'.

  << "Negative sign: " << punct.negative_sign() << '\n'.

  << "Fractional digits: " << punct.frac_digits() << '\n'.

  << "Positive format: ".

  << printPattern(punct pos_format()) << '\n'.

  << "Negative format: ".

  << printPattern(punct.neg_format()) << '\n';

 // Группировки описываются символьной строкой, но осмысленными.

 // являются числовые значения символов, а не собственно символы.

 string s = punct.grouping();

 for (string::iterator p = s.begin(); p != s.end(); ++p).

  cout << "Groups of: " << (int)*p << '\n';

}

Назначение большинства этих методов самоочевидно, но некоторые методы требуют дополнительных пояснений. Во-первых, метод grouping возвращает строку символов, которая интерпретируется как строка целочисленных значений. Каждый символ описывает свою группу цифр в числе, начиная с правой стороны числа. И если в какой-то позиции строки нет значения, то используется значение в предыдущей позиции. Другими словами, для стандартного американского формата в позиции 0 этой строки будет значение 3, что означает три цифры для группы с индексом 0. Поскольку других значений нет, все группы с индексом, большим нуля, должны также состоять из трех цифр.

Pos_format и neg_format возвращают объект типа moneypunct<T>::pattern, который имеет член field типа T[4], где T — символьный тип. Каждый элемент поля field содержит один из элементов перечисления moneypunct<T>::part, который имеет пять возможных значений: none, space, symbol, sign и value. Строковое представление денежного значения состоит из четырех частей (т.е. массив с четырьмя элементами) Обычно части денежного значения образуют последовательность symbol space sign value (символ валюты пробел знак значение), что означало бы вывод, например, значения $ -32.00. Часто знак плюс заменяется пустой строкой, поскольку значение без знака обычно рассматривается как положительное значение. Признак отрицательного числа может содержать несколько символов, как, например, « ()», и в этом случае первый символ выдается в части symbol формата отрицательного числа ( neg_format), а другой символ выдается в конце, поэтому отрицательные числа могут иметь, например, такой вид: $(32.00).

Большую часть времени вам не придется беспокоиться по поводу получения информации о форматировании, содержащейся в moneypunct. Однако если вам необходимо выполнить большой объем формирования денежных значений в различных локализациях, то имеет смысл поэкспериментировать и познакомиться с особенностями форматирования в различных локализациях.

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

Рецепты 13.2 и 13.3.