Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/locale"

From cppreference.com
< cpp
 
m (→‎See also: -'\n')
 
(36 intermediate revisions by 10 users not shown)
Line 1: Line 1:
 
{{title|Localization library}}
 
{{title|Localization library}}
−
{{cpp/locale/sidebar}}
+
{{cpp/locale/navbar}}
  
−
* Locales <locale>
+
The locale facility includes internationalization support for character classification and string collation, numeric, monetary, and date/time formatting and parsing, and message retrieval. Locale settings control the behavior of stream I/O, regular expression library, and other components of the C++ standard library.
−
* Standard code conversion facets <codecvt>
+
−
* C library locales <clocale>
+
  
−
{{dcl list begin}}
+
===Locales and facets===
−
{{dcl list template | cpp/locale/dcl list setlocale}}
+
{{dsc begin}}
−
{{dcl list end}}
+
{{dsc header|locale}}
 +
{{dsc h2|Locales}}
 +
{{dsc inc|cpp/locale/dsc locale}}
 +
{{dsc inc|cpp/locale/dsc use_facet}}
 +
{{dsc inc|cpp/locale/dsc has_facet}}
 +
 
 +
{{dsc h2|Facet category base classes}}
 +
{{dsc inc|cpp/locale/dsc ctype_base}}
 +
{{dsc inc|cpp/locale/dsc codecvt_base}}
 +
{{dsc inc|cpp/locale/dsc messages_base}}
 +
{{dsc inc|cpp/locale/dsc time_base}}
 +
{{dsc inc|cpp/locale/dsc money_base}}
 +
 
 +
{{dsc h2|ctype facets}}
 +
{{dsc inc|cpp/locale/dsc ctype}}
 +
{{dsc inc|cpp/locale/dsc ctype_byname}}
 +
{{dsc inc|cpp/locale/dsc ctype_char}}
 +
{{dsc inc|cpp/locale/dsc codecvt}}
 +
{{dsc inc|cpp/locale/dsc codecvt_byname}}
 +
 
 +
{{dsc h2|numeric facets}}
 +
{{dsc inc|cpp/locale/dsc num_get}}
 +
{{dsc inc|cpp/locale/dsc num_put}}
 +
{{dsc inc|cpp/locale/dsc numpunct}}
 +
{{dsc inc|cpp/locale/dsc numpunct_byname}}
 +
 
 +
{{dsc h2|collate facets}}
 +
{{dsc inc|cpp/locale/dsc collate}}
 +
{{dsc inc|cpp/locale/dsc collate_byname}}
 +
 
 +
{{dsc h2|time facets}}
 +
{{dsc inc|cpp/locale/dsc time_get}}
 +
{{dsc inc|cpp/locale/dsc time_get_byname}}
 +
{{dsc inc|cpp/locale/dsc time_put}}
 +
{{dsc inc|cpp/locale/dsc time_put_byname}}
 +
 
 +
{{dsc h2|monetary facets}}
 +
{{dsc inc|cpp/locale/dsc money_get}}
 +
{{dsc inc|cpp/locale/dsc money_put}}
 +
{{dsc inc|cpp/locale/dsc moneypunct}}
 +
{{dsc inc|cpp/locale/dsc moneypunct_byname}}
 +
 
 +
{{dsc h2|messages facets}}
 +
{{dsc inc|cpp/locale/dsc messages}}
 +
{{dsc inc|cpp/locale/dsc messages_byname}}
 +
{{dsc end}}
 +
 
 +
===Character classification and conversion===
 +
{{dsc begin}}
 +
{{dsc header|locale}}
 +
{{dsc h2|Character classification}}
 +
{{dsc inc|cpp/locale/dsc isspace}}
 +
{{dsc inc|cpp/locale/dsc isblank}}
 +
{{dsc inc|cpp/locale/dsc iscntrl}}
 +
{{dsc inc|cpp/locale/dsc isupper}}
 +
{{dsc inc|cpp/locale/dsc islower}}
 +
{{dsc inc|cpp/locale/dsc isalpha}}
 +
{{dsc inc|cpp/locale/dsc isdigit}}
 +
{{dsc inc|cpp/locale/dsc ispunct}}
 +
{{dsc inc|cpp/locale/dsc isxdigit}}
 +
{{dsc inc|cpp/locale/dsc isalnum}}
 +
{{dsc inc|cpp/locale/dsc isprint}}
 +
{{dsc inc|cpp/locale/dsc isgraph}}
 +
 
 +
{{dsc h2|Character conversions}}
 +
{{dsc inc|cpp/locale/dsc toupper}}
 +
{{dsc inc|cpp/locale/dsc tolower}}
 +
 
 +
{{dsc h2|String and stream conversions}}
 +
{{dsc inc|cpp/locale/dsc wstring_convert}}
 +
{{dsc inc|cpp/locale/dsc wbuffer_convert}}
 +
{{dsc end}}
 +
 
 +
 
 +
{{rrev|since=c++26|
 +
===Text encoding identifications===
 +
{{dsc begin}}
 +
{{dsc header|text_encoding}}
 +
{{dsc inc|cpp/locale/dsc text_encoding}}
 +
{{dsc end}}
 +
}}
 +
 
 +
 
 +
{{rrev|until=c++26|
 +
===Locale-independent unicode conversion facets===
 +
{{dsc begin}}
 +
{{dsc header|codecvt}}
 +
{{dsc inc|cpp/locale/dsc codecvt_utf8}}
 +
{{dsc inc|cpp/locale/dsc codecvt_utf16}}
 +
{{dsc inc|cpp/locale/dsc codecvt_utf8_utf16}}
 +
{{dsc inc|cpp/locale/dsc codecvt_mode}}
 +
{{dsc end}}
 +
}}
 +
 
 +
===C library locales===
 +
{{dsc begin}}
 +
{{dsc header|clocale}}
 +
{{dsc inc|cpp/locale/dsc setlocale}}
 +
{{dsc inc|cpp/locale/dsc LC_categories}}
 +
{{dsc inc|cpp/locale/dsc localeconv}}
 +
{{dsc inc|cpp/locale/dsc lconv}}
 +
{{dsc end}}
 +
 
 +
===See also===
 +
{{dsc begin}}
 +
{{dsc see c|c/locale|Localization support|nomono=true}}
 +
{{dsc end}}
 +
 
 +
{{langlinks|ar|de|es|fr|it|ja|pt|ru|zh}}

Latest revision as of 20:29, 30 December 2023

 
C++
 
Localization library
 

The locale facility includes internationalization support for character classification and string collation, numeric, monetary, and date/time formatting and parsing, and message retrieval. Locale settings control the behavior of stream I/O, regular expression library, and other components of the C++ standard library.

Contents

[edit] Locales and facets

Defined in header <locale>
Locales
set of polymorphic facets that encapsulate cultural differences
(class) [edit]
obtains a facet from a locale
(function template) [edit]
checks if a locale implements a specific facet
(function template) [edit]
Facet category base classes
defines character classification categories
(class) [edit]
defines character conversion errors
(class) [edit]
defines messages catalog type
(class) [edit]
defines date format constants
(class) [edit]
defines monetary formatting patterns
(class) [edit]
ctype facets
defines character classification tables
(class template) [edit]
represents the system-supplied std::ctype for the named locale
(class template) [edit]
specialization of std::ctype for type char
(class template specialization) [edit]
converts between character encodings, including UTF-8, UTF-16, UTF-32
(class template) [edit]
represents the system-supplied std::codecvt for the named locale
(class template) [edit]
numeric facets
parses numeric values from an input character sequence
(class template) [edit]
formats numeric values for output as character sequence
(class template) [edit]
defines numeric punctuation rules
(class template) [edit]
represents the system-supplied std::numpunct for the named locale
(class template) [edit]
collate facets
defines lexicographical comparison and hashing of strings
(class template) [edit]
represents the system-supplied std::collate for the named locale
(class template) [edit]
time facets
parses time/date values from an input character sequence into std::tm
(class template) [edit]
represents the system-supplied std::time_get for the named locale
(class template) [edit]
formats contents of std::tm for output as character sequence
(class template) [edit]
represents the system-supplied std::time_put for the named locale
(class template) [edit]
monetary facets
parses and constructs a monetary value from an input character sequence
(class template) [edit]
formats a monetary value for output as a character sequence
(class template) [edit]
defines monetary formatting parameters used by std::money_get and std::money_put
(class template) [edit]
represents the system-supplied std::moneypunct for the named locale
(class template) [edit]
messages facets
implements retrieval of strings from message catalogs
(class template) [edit]
represents the system-supplied std::messages for the named locale
(class template) [edit]

[edit] Character classification and conversion

Defined in header <locale>
Character classification
checks if a character is classified as whitespace by a locale
(function template) [edit]
(C++11)
 checks if a character is classified as a blank character by a locale
(function template) [edit]
checks if a character is classified as a control character by a locale
(function template) [edit]
checks if a character is classified as uppercase by a locale
(function template) [edit]
checks if a character is classified as lowercase by a locale
(function template) [edit]
checks if a character is classified as alphabetic by a locale
(function template) [edit]
checks if a character is classified as a digit by a locale
(function template) [edit]
checks if a character is classified as punctuation by a locale
(function template) [edit]
checks if a character is classified as a hexadecimal digit by a locale
(function template) [edit]
checks if a character is classified as alphanumeric by a locale
(function template) [edit]
checks if a character is classified as printable by a locale
(function template) [edit]
checks if a character is classified as graphical by a locale
(function template) [edit]
Character conversions
converts a character to uppercase using the ctype facet of a locale
(function template) [edit]
converts a character to lowercase using the ctype facet of a locale
(function template) [edit]
String and stream conversions
(C++11)(deprecated in C++17)(removed in C++26)
 performs conversions between a wide string and a byte string
(class template) [edit]
(C++11)(deprecated in C++17)(removed in C++26)
 performs conversion between a byte stream buffer and a wide stream buffer
(class template) [edit]


Text encoding identifications

Defined in header <text_encoding>
(C++26)
 describes an interface for accessing the IANA Character Sets registry
(class) [edit]
(since C++26)


Locale-independent unicode conversion facets

Defined in header <codecvt>
(C++11)(deprecated in C++17)(removed in C++26)
 converts between UTF-8 and UCS-2/UCS-4
(class template) [edit]
(C++11)(deprecated in C++17)(removed in C++26)
 converts between UTF-16 and UCS-2/UCS-4
(class template) [edit]
(C++11)(deprecated in C++17)(removed in C++26)
 converts between UTF-8 and UTF-16
(class template) [edit]
(C++11)(deprecated in C++17)(removed in C++26)
 tags to alter behavior of the standard codecvt facets
(enum) [edit]
(until C++26)

[edit] C library locales

Defined in header <clocale>
gets and sets the current C locale
(function) [edit]
locale categories for std::setlocale
(macro constant) [edit]
queries numeric and monetary formatting details of the current locale
(function) [edit]
formatting details, returned by std::localeconv
(class) [edit]

[edit] See also

C documentation for Localization support
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/locale&oldid=167800"