로캘Locale

로캘은 프로그램을 사용자 지정하는 데 사용할 수 있는 국가/지역 및 언어 설정을 참조합니다.Locale refers to country/region and language settings that you can use to customize your program. 일부 로캘 종속 범주는 날짜 및 통화 값의 표시 형식을 포함합니다.Some locale-dependent categories include the display formats for dates and monetary values. 자세한 내용은 로캘 범주를 참조하세요.For more information, see Locale Categories.

_l 접미사 없이 함수를 사용하는 동안 현재 프로그램 또는 스레드 로캘 정보의 일부 또는 모두를 변경하거나 쿼리하려면 setlocale 함수를 사용하세요.Use the setlocale function to change or query some or all of the current program or thread locale information while using functions without the _l suffix. _l 접미사를 사용하는 이러한 함수는 해당 특정 함수만 실행되는 동안 로캘 정보에 대해 전달되는 로캘 매개 변수를 사용합니다.The functions with the _l suffix will use the locale parameter passed in for their locale information during the execution of that specific function only. _l 접미사를 사용하는 함수와 함께 사용할 로캘을 만들려면 _create_locale을 사용합니다.To create a locale for use with a function with a _l suffix, use _create_locale. 이 로캘을 해제하려면 _free_locale을 사용합니다.To free this locale, use _free_locale. 현재 로캘을 가져오려면 _get_current_locale을 사용합니다.To get the current locale, use _get_current_locale.

_configthreadlocale을 사용하여 각 스레드가 자체 로캘을 포함하는지 또는 프로그램의 모든 스레드가 동일한 로캘을 공유하는지를 제어합니다.Use _configthreadlocale to control whether each thread has its own locale, or all threads in a program share the same locale. 자세한 내용은 로캘 및 코드 페이지를 참조하세요.For more information, see Locales and Code Pages.

다음 표에 있는 _s("보안") 접미사로 표시된 우수한 보안 버전의 함수를 사용할 수 있습니다.More secure versions of the functions in the following table are available, indicated by the _s ("secure") suffix. 자세한 내용은 CRT의 보안 기능을 참조하세요.For more information, see Security Features in the CRT.

로캘 종속 루틴Locale-Dependent Routines

루틴Routine 기능Use setlocale 범주 설정 종속성setlocale category setting dependence
atof, _atof_l, _wtof, _wtof_latof, _atof_l, _wtof, _wtof_l 문자를 부동 소수점 값으로 변환합니다.Convert character to floating-point value LC_NUMERIC
atoi, _atoi_l, _wtoi, _wtoi_latoi, _atoi_l, _wtoi, _wtoi_l 문자를 정수 값으로 변환합니다.Convert character to integer value LC_NUMERIC
_atoi64, _atoi64_l, _wtoi64, _wtoi64_l_atoi64, _atoi64_l, _wtoi64, _wtoi64_l 문자를 64비트 정수 값으로 변환합니다.Convert character to 64-bit integer value LC_NUMERIC
atol, _atol_l, _wtol, _wtol_latol, _atol_l, _wtol, _wtol_l 문자를 long 값으로 변환합니다.Convert character to long value LC_NUMERIC
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt, _atoflt_l_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt, _atoflt_l 문자를 double-long 값으로 변환합니다.Convert character to double-long value LC_NUMERIC
is 루틴is Routines 지정된 정수를 특정 조건에 대해 테스트합니다.Test given integer for particular condition. LC_CTYPE
isleadbyte, _isleadbyte_lisleadbyte, _isleadbyte_l 선행 바이트를 테스트합니다.Test for lead byte LC_CTYPE
localeconvlocaleconv 숫자 수량 형식 지정에 대한 적합한 값을 읽습니다.Read appropriate values for formatting numeric quantities LC_MONETARY, LC_NUMERIC
MB_CUR_MAXMB_CUR_MAX 현재 로캘(STDLIB.H에 정의된 매크로) 내의 모든 멀티바이트 문자의 최대 길이(바이트)입니다.Maximum length in bytes of any multibyte character in current locale (macro defined in STDLIB.H) LC_CTYPE
_mbccpy, _mbccpy_l,_mbccpy_s, _mbccpy_s_l_mbccpy, _mbccpy_l,_mbccpy_s, _mbccpy_s_l 하나의 멀티바이트 문자를 복사합니다.Copy one multibyte character LC_CTYPE
_mbclen, mblen, _mblen_l_mbclen, mblen, _mblen_l 멀티바이트 문자의 바이트 수의 유효성을 검사하고 해당 수를 반환합니다.Validate and return number of bytes in multibyte character LC_CTYPE
strlen, wcslen, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_lstrlen, wcslen, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l 멀티바이트 문자열의 경우: 문자열의 각 문자의 유효성을 검사합니다. 문자열 길이를 반환합니다.For multibyte-character strings: validate each character in string; return string length LC_CTYPE
mbstowcs, _mbstowcs_l,mbstowcs_s, _mbstowcs_s_lmbstowcs, _mbstowcs_l,mbstowcs_s, _mbstowcs_s_l 멀티바이트 문자의 시퀀스를 해당되는 와이드 문자 시퀀스로 변환합니다.Convert sequence of multibyte characters to corresponding sequence of wide characters LC_CTYPE
mbtowc, _mbtowc_lmbtowc, _mbtowc_l 멀티바이트 문자를 해당되는 와이드 문자로 변환합니다.Convert multibyte character to corresponding wide character LC_CTYPE
printf 함수printf functions 형식이 지정된 출력을 씁니다.Write formatted output LC_NUMERIC(기수 문자 출력 여부 결정)LC_NUMERIC (determines radix character output)
scanf 함수scanf functions 형식이 지정된 입력을 읽습니다.Read formatted input LC_NUMERIC(기수 문자 인식 여부 결정)LC_NUMERIC (determines radix character recognition)
setlocale, _wsetlocalesetlocale, _wsetlocale 프로그램에 대한 로캘을 선택합니다.Select locale for program 해당 없음Not applicable
strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_lstrcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l 두 문자열의 문자를 비교합니다.Compare characters of two strings LC_COLLATE
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l 대/소문자에 상관없이 두 문자열을 비교합니다.Compare two strings without regard to case LC_CTYPE
_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l 두 문자열의 문자를 비교합니다(대/소문자 구분 없음).Compare characters of two strings (case insensitive) LC_COLLATE
_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l 두 문자열의 첫 n자를 비교합니다.Compare first n characters of two strings LC_COLLATE
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l 대/소문자에 상관없이 두 문자열의 문자를 비교합니다.Compare characters of two strings without regard to case. LC_CTYPE
_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l 두 문자열의 처음 n자를 비교합니다(대/소문자 구분 없음).Compare first n characters of two strings (case insensitive) LC_COLLATE
strftime, wcsftime, _strftime_l, _wcsftime_lstrftime, wcsftime, _strftime_l, _wcsftime_l 제공된 format 인수에 따라 날짜 및 시간 값의 형식을 지정합니다.Format date and time value according to supplied format argument LC_TIME
_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l,_strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l,_strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l 현재 위치에서 제공된 문자열의 각 대문자를 소문자로 변환합니다.Convert, in place, each uppercase letter in given string to lowercase LC_CTYPE
strtod, _strtod_l, wcstod, _wcstod_lstrtod, _strtod_l, wcstod, _wcstod_l 문자열을 double 값으로 변환합니다.Convert character string to double value LC_NUMERIC(기수 문자 인식 여부 결정)LC_NUMERIC (determines radix character recognition)
strtol, wcstol, _strtol_l, _wcstol_lstrtol, wcstol, _strtol_l, _wcstol_l 문자열을 long 값으로 변환합니다.Convert character string to long value LC_NUMERIC(기수 문자 인식 여부 결정)LC_NUMERIC (determines radix character recognition)
strtoul, _strtoul_l, wcstoul, _wcstoul_lstrtoul, _strtoul_l, wcstoul, _wcstoul_l 문자열을 부호 없는 long 값으로 변환합니다.Convert character string to unsigned long value LC_NUMERIC(기수 문자 인식 여부 결정)LC_NUMERIC (determines radix character recognition)
_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr,_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr,_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l 현재 위치에서 문자열의 각 소문자를 대문자로 변환합니다.Convert, in place, each lowercase letter in string to uppercase LC_CTYPE
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_lstrxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l 문자열을 로캘에 따라 데이터 정렬된 형식으로 변형합니다.Transform string into collated form according to locale LC_COLLATE
tolower, _tolower, towlower, _tolower_l, _towlower_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_ltolower, _tolower, towlower, _tolower_l, _towlower_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l 제공된 문자를 해당 소문자로 변환합니다.Convert given character to corresponding lowercase character LC_CTYPE
toupper, _toupper, towupper, _toupper_l, _towupper_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_ltoupper, _toupper, towupper, _toupper_l, _towupper_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l 제공된 문자를 해당 대문자로 변환합니다.Convert given character to corresponding uppercase letter LC_CTYPE
wcstombs, _wcstombs_l,wcstombs_s, _wcstombs_s_lwcstombs, _wcstombs_l,wcstombs_s, _wcstombs_s_l 와이드 문자의 시퀀스를 해당되는 멀티바이트 문자의 시퀀스로 변환합니다.Convert sequence of wide characters to corresponding sequence of multibyte characters LC_CTYPE
wctomb, _wctomb_l,wctomb_s, _wctomb_s_lwctomb, _wctomb_l,wctomb_s, _wctomb_s_l 와이드 문자를 해당되는 멀티바이트 문자로 변환합니다.Convert wide character to corresponding multibyte character LC_CTYPE

참고

멀티바이트 루틴의 경우 멀티바이트 코드 페이지는 setlocale로 설정된 로캘과 동일해야 합니다.For multibyte routines, the multibyte code page must be equivalent to the locale set with setlocale. _MB_CP_LOCALE의 인수를 사용하는 _setmbcp는 멀티바이트 코드 페이지를 setlocale 코드 페이지와 동일하게 만듭니다._setmbcp, with an argument of _MB_CP_LOCALE makes the multibyte code page the same as the setlocale code page.

참고 항목See Also

국제화 Internationalization
범주별 런타임 루틴Run-Time Routines by Category