locale.h File Reference

#include <corecrt.h>

Include dependency graph for locale.h:

Go to the source code of this file.

Classes
struct	lconv

Macros
#define	LC_ALL   0
#define	LC_COLLATE   1
#define	LC_CTYPE   2
#define	LC_MONETARY   3
#define	LC_NUMERIC   4
#define	LC_TIME   5
#define	LC_MIN   LC_ALL
#define	LC_MAX   LC_TIME
#define	_LCONV_DEFINED
#define	_CONFIG_LOCALE_SWT
#define	_ENABLE_PER_THREAD_LOCALE   0x1
#define	_DISABLE_PER_THREAD_LOCALE   0x2
#define	_ENABLE_PER_THREAD_LOCALE_GLOBAL   0x10
#define	_DISABLE_PER_THREAD_LOCALE_GLOBAL   0x20
#define	_ENABLE_PER_THREAD_LOCALE_NEW   0x100
#define	_DISABLE_PER_THREAD_LOCALE_NEW   0x200
#define	_WLOCALE_DEFINED

Functions
_ACRTIMP char *__cdecl	setlocale (int, const char *)
_ACRTIMP struct lconv *__cdecl	localeconv (void)
_ACRTIMP size_t __cdecl	_Strftime (char *, size_t, const char *, const struct tm *, void *)
_ACRTIMP int __cdecl	_configthreadlocale (int)
_ACRTIMP _locale_t __cdecl	_get_current_locale (void)
_ACRTIMP _locale_t __cdecl	_create_locale (int, const char *)
_ACRTIMP void __cdecl	_free_locale (_locale_t)
_ACRTIMP unsigned int __cdecl	___lc_codepage_func (void)
_ACRTIMP wchar_t *__cdecl	_wsetlocale (int, const wchar_t *)

Macro Definition Documentation

_CONFIG_LOCALE_SWT

#define _CONFIG_LOCALE_SWT

Definition at line 72 of file locale.h.

_DISABLE_PER_THREAD_LOCALE

#define _DISABLE_PER_THREAD_LOCALE   0x2

Definition at line 75 of file locale.h.

_DISABLE_PER_THREAD_LOCALE_GLOBAL

#define _DISABLE_PER_THREAD_LOCALE_GLOBAL   0x20

Definition at line 77 of file locale.h.

_DISABLE_PER_THREAD_LOCALE_NEW

#define _DISABLE_PER_THREAD_LOCALE_NEW   0x200

Definition at line 79 of file locale.h.

_ENABLE_PER_THREAD_LOCALE

#define _ENABLE_PER_THREAD_LOCALE   0x1

Definition at line 74 of file locale.h.

_ENABLE_PER_THREAD_LOCALE_GLOBAL

#define _ENABLE_PER_THREAD_LOCALE_GLOBAL   0x10

Definition at line 76 of file locale.h.

_ENABLE_PER_THREAD_LOCALE_NEW

#define _ENABLE_PER_THREAD_LOCALE_NEW   0x100

Definition at line 78 of file locale.h.

_LCONV_DEFINED

#define _LCONV_DEFINED

Definition at line 35 of file locale.h.

_WLOCALE_DEFINED

#define _WLOCALE_DEFINED

Definition at line 98 of file locale.h.

LC_ALL

#define LC_ALL   0

Definition at line 25 of file locale.h.

LC_COLLATE

#define LC_COLLATE   1

Definition at line 26 of file locale.h.

LC_CTYPE

#define LC_CTYPE   2

Definition at line 27 of file locale.h.

LC_MAX

#define LC_MAX   LC_TIME

Definition at line 32 of file locale.h.

LC_MIN

#define LC_MIN   LC_ALL

Definition at line 31 of file locale.h.

LC_MONETARY

#define LC_MONETARY   3

Definition at line 28 of file locale.h.

LC_NUMERIC

#define LC_NUMERIC   4

Definition at line 29 of file locale.h.

LC_TIME

#define LC_TIME   5

Definition at line 30 of file locale.h.

Function Documentation

___lc_codepage_func()

_ACRTIMP unsigned int __cdecl ___lc_codepage_func

(

void

)

Definition at line 1047 of file locale.c.

{
    return get_locinfo()->lc_codepage;
}

Referenced by get_aw_cp(), mbrtowc(), START_TEST(), Test___lc_codepage(), test_fopen(), and tzset_from_system_nolock().

_configthreadlocale()

_ACRTIMP int __cdecl _configthreadlocale

(

int

i

)

Definition at line 71 of file wsetlocale.cpp.

{
    /*
     * ownlocale flag struct:
     * bits: 000000000000000000000000 000W 00P1
     * P is set when _ENABLE_PER_THREAD_LOCALE is called for this thread
     * or _ENABLE_PER_THREAD_LOCALE_NEW was set when this thread was created.
     * W is set when _WSETLOCALE_AVOID_SYNC_LOCALE_BIT is set by _wsetlocale.
     * It is used to disable global-ptd resynchronization during a call to _wsetlocale.
     *
     * __globallocalestatus structure:
     * bits: 111111111111111111111111 1111 1N1G
     * G is set if _ENABLE_PER_THREAD_LOCALE_GLOBAL is set.
     * G is 0 if _ENABLE_PER_THREAD_LOCALE_GLOBAL is not set.
     * N is set if _ENABLE_PER_THREAD_LOCALE_NEW is set.
     * N is 0 if _ENABLE_PER_THREAD_LOCALE_NEW is not set.
     */
    __acrt_ptd* const ptd = __acrt_getptd();
    int retval = (ptd->_own_locale & _PER_THREAD_LOCALE_BIT)==0 ? _DISABLE_PER_THREAD_LOCALE:_ENABLE_PER_THREAD_LOCALE;
 
    switch(i)
    {
        case _ENABLE_PER_THREAD_LOCALE:
            // same behavior as __acrt_disable_global_locale_sync()
            ptd->_own_locale = ptd->_own_locale | _PER_THREAD_LOCALE_BIT;
            break;
 
        case _DISABLE_PER_THREAD_LOCALE:
            // same behavior as __acrt_enable_global_locale_sync()
            ptd->_own_locale = ptd->_own_locale & ~_PER_THREAD_LOCALE_BIT;
            break;
 
        case 0:
            break;
 
        /* used only during dll startup for linkopt */
        case -1:
            __globallocalestatus = -1;
            break;
 
        default:
            _VALIDATE_RETURN(("Invalid parameter for _configthreadlocale",0),EINVAL,-1);
            break;
    }
 
    return retval;
}

_create_locale()

_ACRTIMP _locale_t __cdecl _create_locale	(	int	category,
		const char *	locale
	)

Definition at line 1981 of file locale.c.

{
    _locale_t loc;
 
    loc = malloc(sizeof(_locale_tstruct));
    if(!loc)
        return NULL;
 
    loc->locinfo = create_locinfo(category, locale, NULL);
    if(!loc->locinfo) {
        free(loc);
        return NULL;
    }
 
    loc->mbcinfo = create_mbcinfo(loc->locinfo->lc_id[LC_CTYPE].wCodePage,
            loc->locinfo->lc_handle[LC_CTYPE], NULL);
    if(!loc->mbcinfo) {
        free_locinfo(loc->locinfo);
        free(loc);
        return NULL;
    }
    return loc;
}

Referenced by msvcrt_init_locale(), test_C_locale(), and test_SpecialCasing().

_free_locale()

_ACRTIMP void __cdecl _free_locale

(

_locale_t

locale

)

Definition at line 1183 of file locale.c.

{
    if (!locale)
        return;
 
    free_locale_noalloc(locale);
    free(locale);
}

Referenced by DllMain(), test_C_locale(), and test_SpecialCasing().

_get_current_locale()

_ACRTIMP _locale_t __cdecl _get_current_locale

(

void

)

Definition at line 1171 of file locale.c.

{
    _locale_t loc = malloc(sizeof(_locale_tstruct));
    if(!loc)
        return NULL;
 
    return get_current_locale_noalloc(loc);
}

_Strftime()

_ACRTIMP size_t __cdecl _Strftime	(	char *	str,
		size_t	max,
		const char *	format,
		const struct tm *	mstm,
		void *	time_data
	)

Definition at line 1528 of file time.c.

{
    return strftime_helper(str, max, format, mstm, time_data, NULL);
}

Referenced by test_strftime().

_wsetlocale()

_ACRTIMP wchar_t *__cdecl _wsetlocale	(	int	category,
		const wchar_t *	wlocale
	)

Definition at line 2097 of file locale.c.

{
    static wchar_t current_lc_all[MAX_LOCALE_LENGTH];
 
    char *locale = NULL;
    const char *ret;
    size_t len;
 
    if(wlocale) {
        len = wcstombs(NULL, wlocale, 0);
        if(len == -1)
            return NULL;
 
        locale = malloc(++len);
        if(!locale)
            return NULL;
 
        wcstombs(locale, wlocale, len);
    }
 
    _lock_locales();
    ret = setlocale(category, locale);
    free(locale);
 
    if(ret && mbstowcs(current_lc_all, ret, MAX_LOCALE_LENGTH)==-1)
        ret = NULL;
 
    _unlock_locales();
    return ret ? current_lc_all : NULL;
}

Referenced by call_wsetlocale().

localeconv()

_ACRTIMP struct lconv *__cdecl localeconv

(

void

)

Definition at line 1004 of file locale.c.

{
    return get_locinfo()->lconv;
}

Referenced by ftoes(), and ftofs().

setlocale()

_ACRTIMP char *__cdecl setlocale	(	int	category,
		const char *	locale
	)

Definition at line 2035 of file locale.c.

{
    thread_data_t *data = msvcrt_get_thread_data();
    pthreadlocinfo locinfo = get_locinfo(), newlocinfo;
    int locale_flags;
 
    if(category<LC_MIN || category>LC_MAX)
        return NULL;
 
    if(!locale) {
        if(category == LC_ALL)
            return construct_lc_all(locinfo);
 
        return locinfo->lc_category[category].locale;
    }
 
    /* Make sure that locinfo is not updated by e.g. stricmp function */
    locale_flags = data->locale_flags;
    data->locale_flags |= LOCALE_THREAD;
    newlocinfo = create_locinfo(category, locale, locinfo);
    data->locale_flags = locale_flags;
    if(!newlocinfo) {
        WARN("%d %s failed\n", category, locale);
        return NULL;
    }
 
    if(locale[0] != 'C' || locale[1] != '\0')
        initial_locale = FALSE;
 
    if(data->locale_flags & LOCALE_THREAD)
    {
        if(data->locale_flags & LOCALE_FREE)
            free_locinfo(data->locinfo);
        data->locinfo = newlocinfo;
    }
    else
    {
        int i;
 
        _lock_locales();
        free_locinfo(MSVCRT_locale->locinfo);
        MSVCRT_locale->locinfo = newlocinfo;
 
        MSVCRT___lc_codepage = newlocinfo->lc_codepage;
        MSVCRT___lc_collate_cp = newlocinfo->lc_collate_cp;
        MSVCRT___mb_cur_max = newlocinfo->mb_cur_max;
        MSVCRT__pctype = newlocinfo->pctype;
        for(i=LC_MIN; i<=LC_MAX; i++)
            MSVCRT___lc_handle[i] = MSVCRT_locale->locinfo->lc_handle[i];
        _unlock_locales();
        update_thread_locale(data);
    }
 
    if(category == LC_ALL)
        return construct_lc_all(data->locinfo);
 
    return data->locinfo->lc_category[category].locale;
}