_create_locale，_wcreate_locale

  • 项目

创建区域设置对象。

语法

_locale_t _create_locale(
   int category,
   const char *locale
);
_locale_t _wcreate_locale(
   int category,
   const wchar_t *locale
);

参数

category
类别。

locale
区域设置说明符。

返回值

如果给定了有效的 locale 和 category，则函数返回指定区域设置作为 _locale_t 对象。 不更改程序的当前区域设置。

注解

_create_locale 函数允许创建表示某个特定于区域的设置的对象，以供许多特定于区域设置版本的 CRT 函数（具有 _l 后缀的函数）使用。 行为类似于 setlocale但将设置保存在返回的 _locale_t 结构中，而不是向当前环境应用指定的区域设置。 不再需要 _locale_t 结构时，应使用 _free_locale 将其释放。

_wcreate_locale 是 _create_locale的宽字符版本； locale 的 _wcreate_locale 参数是宽字符字符串。 除此以外，_wcreate_locale 和 _create_locale 的行为完全相同。

category 参数指定受影响的特定于区域设置的行为部分。 用于 category 的标志及其影响的程序部分如下表中所示：

category 标志 影响
LC_ALL 以下列出了所有类别。
LC_COLLATE strcoll、_stricoll、wcscoll、_wcsicoll、strxfrm、_strncoll、_strnicoll、_wcsncoll、_wcsnicoll 和 wcsxfrm 函数。
LC_CTYPE 字符处理函数（不受影响的 isdigit、isxdigit、mbstowcs 和 mbtowc 除外）。
LC_MONETARY localeconv 函数返回的货币格式信息。
LC_NUMERIC 格式化输出例程（例如 printf）、数据转换例程和 localeconv 所返回的非货币格式设置信息的十进制点字符。 除小数点字符之外，LC_NUMERIC 还设置 localeconv 返回的千位分隔符和分组控制字符串。
LC_TIME strftime 和 wcsftime 函数。

此函数验证 category 和 locale 参数。 如果类别参数不是上表中给定的值之一，或者如果 locale 是 NULL，则该函数将返回 NULL。

locale 参数是指向指定区域设置的字符串的指针。 有关 locale 参数的格式信息，请参阅区域设置名称、语言和国家/地区字符串。

locale 参数可以采用多种类型的值：区域设置名称、语言字符串、语言字符串和国家/地区代码、代码页或语言字符串、国家/地区代码和代码页的组合。 可用的区域设置名称、语言、国家/地区代码和代码页集合包括 Windows NLS API 支持的所有内容。 区域设置名称、语言和国家/地区字符串中介绍了 _create_locale 支持的区域设置名称集合。 语言字符串和国家/地区字符串中列出了 _create_locale 所支持的语言和国家/地区字符串集合。

有关区域设置的详细信息，请参阅 setlocale、_wsetlocale。

已弃用此函数之前的名称 __create_locale（带两个前导下划线）。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

要求

例程 必需的标头
_create_locale <locale.h>
_wcreate_locale <locale.h> 或 <wchar.h>

有关兼容性的详细信息，请参阅 兼容性。

示例

// crt_create_locale.c
// Sets the current locale to "de-CH" using the
// setlocale function and demonstrates its effect on the strftime
// function.

#include <stdio.h>
#include <locale.h>
#include <time.h>

int main(void)
{
    time_t ltime;
    struct tm thetime;
    unsigned char str[100];
    _locale_t locale;

    // Create a locale object representing the German (Switzerland) locale
    locale = _create_locale(LC_ALL, "de-CH");
    time (&ltime);
    _gmtime64_s(&thetime, &ltime);

    // %#x is the long date representation, appropriate to
    // the current locale
    if (!_strftime_l((char *)str, 100, "%#x",
                     (const struct tm *)&thetime, locale))
    {
        printf("_strftime_l failed!\n");
    }
    else
    {
        printf("In de-CH locale, _strftime_l returns '%s'\n", str);
    }

    _free_locale(locale);

    // Create a locale object representing the default C locale
    locale = _create_locale(LC_ALL, "C");
    time(&ltime);
    _gmtime64_s(&thetime, &ltime);

    if (!_strftime_l((char *)str, 100, "%#x",
                     (const struct tm *)&thetime, locale))
    {
        printf("_strftime_l failed!\n");
    }
    else
    {
        printf("In 'C' locale, _strftime_l returns '%s'\n", str);
    }

    _free_locale(locale);
}

In de-CH locale, _strftime_l returns 'Samstag, 9. Februar 2002'
In 'C' locale, _strftime_l returns 'Saturday, February 09, 2002'

另请参阅

区域设置名称、语言和国家/地区字符串
语言字符串
国家/地区字符串
_free_locale
_configthreadlocale
setlocale
区域设置
localeconv
_mbclen、mblen、_mblen_l
strlen、wcslen、_mbslen、_mbslen_l、_mbstrlen、_mbstrlen_l
mbstowcs、_mbstowcs_l
mbtowc、_mbtowc_l
_setmbcp
setlocale、_wsetlocale
strcoll 函数
strftime、wcsftime、_strftime_l、_wcsftime_l
strxfrm、wcsxfrm、_strxfrm_l、_wcsxfrm_l
wcstombs、_wcstombs_l
wctomb、_wctomb_l