# std::moneypunct<CharT,International>::frac_digits, do_frac_digits

> C++ Atlas: `cppatlas.com/w/cpp/locale/moneypunct/frac_digits` | Source: https://en.cppreference.com/w/cpp/locale/moneypunct/frac_digits | Domain: Localization

The number of digits to be displayed after the decimal point. In common U.S. locales, this is the value 2.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <locale>

public:
int frac_digits() const; // (1)

protected:
virtual int do_frac_digits() const; // (2)
```

1) Public member function, calls the member function `do_frac_digits` of the most derived class.

2) Returns the number of digits to be displayed after the decimal point when printing monetary values.

### Return value

The number of digits to be displayed after the decimal point. In common U.S. locales, this is the value `2`.

### Example

```cpp
#include <iomanip>
#include <iostream>
#include <iterator>
#include <locale>

struct space_out : std::moneypunct<char>
{
    pattern do_pos_format() const { return {value, none, none, none}; }
    int do_frac_digits() const { return 0; }
    char_type do_thousands_sep() const { return ' '; }
    string_type do_grouping() const { return "\002"; }
};

int main()
{
    std::cout.imbue(std::locale("en_US.UTF-8"));
    std::cout << "american locale: " << std::showbase
              << std::put_money(12345678.0) << '\n';

    std::cout.imbue(std::locale(std::cout.getloc(), new space_out));
    std::cout << "locale with modified moneypunct: "
              << std::put_money(12345678.0) << '\n';
}
```

Output:

```text
american locale: $123,456.78
locale with modified moneypunct: 12 34 56 78
```

### See also

- [`do_thousands_sep`](https://en.cppreference.com/w/cpp/locale/moneypunct/thousands_sep) [virtual]: provides the character to use as thousands separator (virtual protected member function)
- [`do_decimal_point`](https://en.cppreference.com/w/cpp/locale/moneypunct/decimal_point) [virtual]: provides the character to use as decimal point (virtual protected member function)

---
Attribution: content from https://en.cppreference.com/w/cpp/locale/moneypunct/frac_digits (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.