Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/locale/locale/combine"

From cppreference.com
< cpp‎ | locale‎ | locale
m (Wording fix.)
(- {{dcl header|locale}})
 
Line 2: Line 2:
 
{{cpp/locale/locale/navbar}}
 
{{cpp/locale/locale/navbar}}
  
{{ddcl|header=locale|
+
{{ddcl|
 
template< class Facet >
 
template< class Facet >
 
locale combine( const locale& other ) const;
 
locale combine( const locale& other ) const;

Latest revision as of 22:54, 18 October 2024

 
 
 
 
template< class Facet >
locale combine( const locale& other ) const;

Constructs a locale object which is a copy of *this except for the facet of type Facet, which is copied from other.

The program is ill-formed if Facet is not a facet or it is a volatile-qualified facet.

Contents

[edit] Return value

The new, nameless, locale.

[edit] Exceptions

std::runtime_error if other does not implement Facet.

[edit] Example

#include <iostream>
#include <locale>
 
int main()
{
    const double number = 1000.25;
    std::cout << "\"C\" locale: " << number << '\n';
    std::locale loc = std::locale()
        .combine<std::numpunct<char>>(std::locale("en_US.UTF8"));
    std::cout.imbue(loc);
    std::cout << "\"C\" locale with en_US numpunct: " << number << '\n';
}

Output:

"C" locale: 1000.25
"C" locale with en_US numpunct: 1,000.25

[edit] Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

DR Applied to Behavior as published Correct behavior
LWG 14 C++98 locale::combine was non-const made const
LWG 436 C++98 it was unclear whether Facet can be cv-qualified it can be const-qualified, but not volatile-qualified

[edit] See also

constructs a new locale
(public member function) [edit]