std::text_encoding:: environment
|
static
text_encoding environment
(
)
;
|
(since C++26) | |
Constructs a new
text_encoding
object representing the environment encoding that refers to the implementation-defined character encoding scheme of the execution environment. The execution environment at runtime is the
environment
in which the program is run.
The environment encoding in the execution environment is distinct from the encoding of
execution character set
which is locale-specific. In other words, the environment encoding remains locale-independent, that is, the value returned by
environment
(
)
is not affected by calls to the functions (e.g.
std::setlocale
and POSIX function
setenv()
) which can modify the environment.
This function is deleted unless the CHAR_BIT is 8 .
Contents |
Parameters
(none)
Return value
The object holding the representation of the environment character encoding.
Notes
The environment encoding may differ from the global locale-associated encoding that is accessible via std:: locale ( ) . encoding ( ) .
On Windows platforms, the environment encoding can be determined by
GetACP()
and then mapped to MIBenum values.
On POSIX platforms, the environment encoding is associated with the POSIX locale
""
which can be implemented to correspond to a value of
nl_langinfo_l()
when the environment locale
""
is set before the
global C++ locale
is set to
"C"
at program startup.
Example
|
This section is incomplete
Reason: no example |
See also
|
(C++26)
|
returns the character encoding scheme associated with the locale
(public member function of
std::locale
)
|