std::numpunct<CharT>::grouping, std::numpunct<CharT>::do_grouping

Определён в заголовочном файле `<locale>`
public: std::string grouping() const;	(1)
protected: virtual std::string do_grouping() const;	(2)

1) Открытая функция-член, вызывающая функцию-член do_grouping наиболее производного класса.

2) Возвращает std::string, в каждом элементе char которого содержится количество цифр в каждой группе числового вывода, форматируемого с помощью num_put::put() (и, следовательно, basic_ostream::operator<<).

Эта функция возвращает строку vec, которая используется как вектор целочисленных значений. (Например, "\003" задаёт группы по 3 цифры, тогда как "3" означает группы по 51 цифре.) Каждый элемент vec[i] задаёт количество цифр в iй группе цифр целой части числа, считая справа налево: vec[0] содержит количество цифр в самой правой группе, vec[1] — во второй группе справа и т. д. Группировка, задаваемая последним символом, vec[vec.size()-1], повторно используется для группировки всех оставшихся цифр в левой части числа. Если vec[i] неположительно или равно CHAR_MAX, размер соответствующей группы цифр не ограничен.

Возвращаемое значение

Объект типа std::string, содержащий группы. Стандартные специализации std::numpunct возвращают пустую строку, обозначающую отсутствие группировки. Типичные схемы группировки (например, локаль en_US) возвращают "\003".

Пример

#include <iostream>
#include <limits>
#include <locale>

struct space_out : std::numpunct<char>
{
    char do_thousands_sep()   const { return ' ';  } // separate with spaces
    std::string do_grouping() const { return "\1"; } // groups of 1 digit
};

struct g123 : std::numpunct<char>
{
    std::string do_grouping() const { return "\1\2\3"; }
};

int main()
{
    std::cout << "Default locale: " << 12345678 << '\n';
    std::cout.imbue(std::locale(std::cout.getloc(), new space_out));
    std::cout << "Locale with modified numpunct: " << 12345678 << '\n';
    std::cout.imbue(std::locale(std::cout.getloc(), new g123));
    std::cout << "Locale with \\1\\2\\3 grouping: "
              << std::numeric_limits<unsigned long long>::max() << '\n'
              << "Same, for a floating-point number: "
              << std::fixed << 123456789.123456789 << '\n';
}

Вывод:

Default locale: 12345678
Locale with modified numpunct: 1 2 3 4 5 6 7 8
Locale with \1\2\3 grouping: 18,446,744,073,709,551,61,5
Same, for a floating-point number: 123,456,78,9.123457

См. также

do_thousands_sep

[виртуальная]

предоставляет символ, используемый в качестве разделителя тысяч
(виртуальная защищённая функция-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/locale/numpunct/grouping