cpp/locale/locale/locale

Constructs a new locale object.

@1@ Default constructor. Constructs a copy of the global C++ locale, which is the locale most recently used as the argument to std or a copy of if no call to std has been made.

@2@ Copy constructor. Constructs a copy of.

@3,4@ Constructs a copy of the system locale with specified (such as, or , or , or ), if such locale is supported by the operating system. The locale constructed in this manner has a name.

@4@ Equivalent to.

@5@ Constructs a copy of except for all the facets identified by the  argument, which are copied from the system locale identified by its. The locale constructed in this manner has a name if and only if has a name.

@6@ Equivalent to.

@7@ Constructs a copy of except for the facet of type  (typically deduced from the type of the argument) which is installed from. If is a null pointer, the constructed locale is a full copy of. The program is ill-formed if is not a  or it is a volatile-qualified facet.

@@ If is null, the constructed locale has the same name as. Otherwise, the constructed locale has no name.

@8@ Constructs a copy of except for all the facets identified by the  argument, which are copied from.

@@ If is equal to, the constructed locale has a name if and only if  has a name. Otherwise, the constructed locale has a name if and only if and  both have names.

Exceptions
@3,5@ std if the operating system has no locale named or if  is a null pointer.

@4,6@ std if the operating system has no locale named.