cppdraft_translate/cppdraft/locale/cons.md

[locale.cons]

# 28 Text processing library [[text]](./#text)

## 28.3 Localization library [[localization]](localization#locale.cons)

### 28.3.3 Locales [[locales]](locales#locale.cons)

#### 28.3.3.1 Class locale [[locale]](locale#cons)

#### 28.3.3.1.3 Constructors and destructor [locale.cons]

[🔗](#lib:locale,constructor)

`locale() noexcept;
`

[1](#1)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L865)

*Effects*: Constructs a copy of the argument last passed tolocale​::​global(locale&),
if it has been called;
else, the resulting facets have virtual function semantics identical to
those of locale​::​classic()[.](#1.sentence-1)

[*Note [1](#note-1)*:

This constructor yields a copy of the current global locale[.](#1.sentence-2)

It is commonly used as a default argument for
function parameters of type const locale&[.](#1.sentence-3)

— *end note*]

[🔗](#lib:locale,constructor_)

`explicit locale(const char* std_name);
`

[2](#2)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L885)

*Effects*: Constructs a locale using standard C locale names, e.g., "POSIX"[.](#2.sentence-1)

The resulting locale implements semantics defined to be associated
with that name[.](#2.sentence-2)

[3](#3)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L891)

*Throws*: runtime_error if the argument is not valid, or is null[.](#3.sentence-1)

[4](#4)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L895)

*Remarks*: The set of valid string argument values is"C", "", and any implementation-defined values[.](#4.sentence-1)

[🔗](#lib:locale,constructor__)

`explicit locale(const string& std_name);
`

[5](#5)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L907)

*Effects*: Equivalent to locale(std_name.c_str())[.](#5.sentence-1)

[🔗](#lib:locale,constructor___)

`locale(const locale& other, const char* std_name, category cats);
`

[6](#6)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L918)

*Preconditions*: cats is a valid category value ([[locale.category]](locale.category "28.3.3.1.2.1 Type locale​::​category"))[.](#6.sentence-1)

[7](#7)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L922)

*Effects*: Constructs a locale as a copy of other except for the facets identified by the category argument,
which instead implement the same semantics as locale(std_name)[.](#7.sentence-1)

[8](#8)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L928)

*Throws*: runtime_error if the second argument is not valid, or is null[.](#8.sentence-1)

[9](#9)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L932)

*Remarks*: The locale has a name if and only if other has a name[.](#9.sentence-1)

[🔗](#lib:locale,constructor____)

`locale(const locale& other, const string& std_name, category cats);
`

[10](#10)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L943)

*Effects*: Equivalent to locale(other, std_name.c_str(), cats)[.](#10.sentence-1)

[🔗](#lib:locale,constructor_____)

`template<class Facet> locale(const locale& other, Facet* f);
`

[11](#11)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L954)

*Effects*: Constructs a locale incorporating all facets from the first argument
except that of type Facet,
and installs the second argument as the remaining facet[.](#11.sentence-1)

If f is null, the resulting object is a copy of other[.](#11.sentence-2)

[12](#12)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L961)

*Remarks*: If f is null,
the resulting locale has the same name as other[.](#12.sentence-1)

Otherwise, the resulting locale has no name[.](#12.sentence-2)

[🔗](#lib:locale,constructor______)

`locale(const locale& other, const locale& one, category cats);
`

[13](#13)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L974)

*Preconditions*: cats is a valid category value[.](#13.sentence-1)

[14](#14)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L978)

*Effects*: Constructs a locale incorporating all facets from the first argument
except those that implement cats,
which are instead incorporated from the second argument[.](#14.sentence-1)

[15](#15)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L984)

*Remarks*: If cats is equal to locale​::​none,
the resulting locale has a name if and only if the first argument has a name[.](#15.sentence-1)

Otherwise, the resulting locale has a name if and only if
the first two arguments both have names[.](#15.sentence-2)

[🔗](#lib:operator=,locale)

`const locale& operator=(const locale& other) noexcept;
`

[16](#16)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L998)

*Effects*: Creates a copy of other, replacing the current value[.](#16.sentence-1)

[17](#17)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L1002)

*Returns*: *this[.](#17.sentence-1)