Linux程序员手册 第3部分
更新日期： 2020-06-09

名称

uselocale-设置/获取调用线程的语言环境

语法

#include <locale.h>

locale_t uselocale(locale_t newloc);

glibc的功能测试宏要求(请参阅feature_test_macros(7))：

uselocale()：

Since glibc 2.10:

_XOPEN_SOURCE>= 700

Before glibc 2.10:

_GNU_SOURCE

说明

uselocale()函数设置调用线程的当前语言环境，并返回线程先前的当前语言环境。成功调用uselocale()之后，此线程对依赖于语言环境的函数的任何调用都将像将语言环境设置为newloc一样进行操作。

newloc参数可以具有以下值之一：

A handle returned by a call to newlocale(3) or duplocale(3)

调用线程的当前语言环境设置为指定的语言环境。

The special locale object handle LC_GLOBAL_LOCALE

调用线程的当前语言环境设置为由setlocale(3)确定的全局语言环境。

(locale_t) 0

调用线程的当前语言环境保持不变(并且当前语言环境作为函数结果返回)。

返回值

成功后，uselocale()返回该线程中先前对uselocale()的调用所设置的语言环境句柄；如果不存在先前的调用，则返回LC_GLOBAL_LOCALE。发生错误时，它将返回(locale_t)0，并设置errno以指示错误原因。

错误说明

EINVAL

newloc没有引用有效的语言环境对象。

版本

uselocale()函数首次出现在GNU C库的2.3版中。

遵循规范

POSIX.1-2008。

备注

与setlocale(3)不同，uselocale()不允许选择性替换单个区域设置类别。要使用与当前语言环境仅几个类别不同的​​语言环境，请使用对duplocale(3)和newlocale(3)的调用来获得与当前语言环境等效的语言环境对象，并在该对象中修改所需的类别。

示例

参见newlocale(3)和duplocale(3)。

另外参见

locale(1)，duplocale(3)，freelocale(3)，newlocale(3)，setlocale(3)，locale(5)，locale(7)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。