_setmbcp (original) (raw)
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.
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_ANSIUse ANSI code page obtained from operating system at program startup._MB_CP_LOCALEUse the current locale's code page obtained from a previous call to setlocale._MB_CP_OEMUse OEM code page obtained from operating system at program startup._MB_CP_SBCSUse single-byte code page. When the code page is set to_MB_CP_SBCS, a routine such as _ismbblead always returns false._MB_CP_UTF8Use 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.