_setmbcp
Sets a new multibyte code page.
Syntax
int _setmbcp(
int codepage
);
Parameters
codepage
New code page setting for locale-independent multibyte routines.
Return value
Returns 0 if the code page is set successfully. If an invalid code page value is supplied for codepage
, returns -1 and the code page setting is unchanged. Sets errno
to EINVAL
if a memory allocation failure occurs.
Remarks
The _setmbcp
function specifies a new multibyte code page. By default, the run-time system automatically sets the multibyte code page to the system-default ANSI code page. The multibyte code page setting affects all multibyte routines that aren't locale dependent. However, it's possible to instruct _setmbcp
to use the code page defined for the current locale (see the following list of manifest constants and associated behavior results). For a list of the multibyte routines that are dependent on the locale code page rather than the multibyte code page, see Interpretation of multibyte-character sequences.
The codepage
argument can be set to any of the following values:
_MB_CP_ANSI
Use ANSI code page obtained from operating system at program startup._MB_CP_LOCALE
Use the current locale's code page obtained from a previous call tosetlocale
._MB_CP_OEM
Use OEM code page obtained from operating system at program startup._MB_CP_SBCS
Use single-byte code page. When the code page is set to_MB_CP_SBCS
, a routine such as_ismbblead
always returns false._MB_CP_UTF8
Use UTF-8. When the code page is set to_MB_CP_UTF8
, a routine such as_ismbblead
always returns false.Any other valid code page value, regardless of whether the value is an ANSI, OEM, or other operating-system-supported code page (except UTF-7, which isn't supported).
By default, this function's global state is scoped to the application. To change this behavior, see Global state in the CRT.
Requirements
Routine | Required header |
---|---|
_setmbcp |
<mbctype.h> |
For more compatibility information, see Compatibility.
See also
Feedback
https://aka.ms/ContentUserFeedback.
În curând: Pe parcursul anului 2024, vom elimina treptat Probleme legate de GitHub ca mecanism de feedback pentru conținut și îl vom înlocui cu un nou sistem de feedback. Pentru mai multe informații, consultați:Trimiteți și vizualizați feedback pentru