【函数功能】
该函数设置指定的地区信息(地域信息)。地区信息是针对一个地理区域的语言、货币、时间以及其他信息。如果执行成功,则返回当前的地域设置,否则返回false。
【函数语法】
setlocale ($category, $locale)
【参数说明】
constant 必需。规定应该设置什么地区信息。可用的常量:
LC_ALL - 包括下面的所有选项
LC_COLLATE - 排序次序
LC_CTYPE - 字符类别及转换(例如所有字符大写或小写)
LC_MESSAGES - 系统消息格式
LC_MONETARY - 货币格式
LC_NUMERIC - 数字格式
LC_TIME - 日期和时间格式
location 必需。规定把地区信息设置为哪个国家/地区。可以是字符串或者数组。可以传递多个位置。
如果 location 参数是 NULL 或空字符串 "",则位置名称会被设置为上面常量中同名的环境变量的值或者根据 "LANG" 进行设置。
如果 location 参数是 "0",则位置设置不受影响,只返回当前的设置。
如果 location 参数是数组,setlocale() 会尝试每个数组元素,直到找到合法的语言或地区代码为止。如果某个地区在不同的系统上拥有不同的名称,这一点很有用。
【演示程序】
<?php
/**
* setlocale ($category, $locale)
* **/
echo setlocale(LC_ALL,'Chinese');//设置本地地区为中国
echo '<br>';
echo setlocale(LC_ALL,'us');//设置本地地区为美国
echo '<br>';
echo setlocale(LC_ALL,null);//设置为系统默认
echo '<br>';
echo setlocale(LC_ALL,array('Chinese','us'));//传入数组,以最后一个有效地区为基准
echo '<br>';
var_dump(setlocale(LC_ALL, 'aaaaa'));//设置一个无效的地域信息
?>
【输出结果】
Chinese_People's Republic of China.936
English_United States.1252
Chinese (Simplified)_People's Republic of China.936
Chinese_People's Republic of China.936
bool(false)
【特别注意】
1.若传入无效的地区值,则返回false。
2.若传入数组,则按照顺序找合法的地区信息,若全部合法,则取最后一个元素的值,其原则为取最后一个有效值。
3.PHP 版本:4+
更新日志:
4.在 PHP 4.2.0 中,已废弃将常量作为字符串传递已废弃。请使用可用的常量代替。将常量作为字符串传递会产生一条警告消息。
5.在 PHP 4.3.0 中,可传递多个 locations。
6.自 PHP 5.3.0 起,如果传递给 constant 参数的是字符串,而不是 LC_ 常量之一,该函数会抛出一个 E_DREPRECATED 通知。
转载请注明出处:php1234.cn ,原文地址:http://php1234.cn/a/functions/2016/0905/49.html