geoip_region_name_by_code
(PECL geoip >= 1.0.4)
geoip_region_name_by_code — 返回給定的國家和地區程式碼組合所對應的地區名稱
說明
$country_code
, string $region_code
): stringgeoip_region_name_by_code() 函式將會返回與給定的國家和地區程式碼組合相對應的地區名稱。
在美國,地區程式碼是每個州對應的兩個字母的縮寫,而在加拿大,則是由兩個字母組成的每個省的郵政編碼。
在世界其他地區,GeoIP使用 FIPS 給定的10到4位的程式碼來表示各地區。你可以點選以下連線 » http://www.maxmind.com/app/fips10_4 檢視詳細資訊。
該函式只在 GeoIP 1.4.1版本以上的庫才可用。並且結果集的數據來源是直接從 GeoIP 庫中獲取的,而不是從任何數據庫中。
參數
-
country_code
-
由兩個字母組成的國家程式碼 (參見 geoip_country_code_by_name())
-
region_code
-
由兩個字母組成的地區程式碼 (參見 geoip_region_by_name())
返回值
成功,返回地區名字,如果相關資訊未找到則返回 false
。
範例
示例 #1 geoip_region_name_by_code() 使用美國和加拿大地區的範例。
以下例程將會列印國家簡稱為 CA (加拿大),地區簡稱為 QC (魁北克)的地區名:
<?php
$region = geoip_region_name_by_code('CA', 'QC');
if ($region) {
echo 'Region name for CA/QC is: ' . $region;
}
?>
以上例程會輸出:
Region name for CA/QC is: Quebec
示例 #2 geoip_region_name_by_code() 使用 FIPS 程式碼的範例:
以下例程將會列印國家簡稱為 JP (日本)地區程式碼為 01的地區名稱。
<?php
$region = geoip_region_name_by_code('JP', '01');
if ($region) {
echo 'Region name for JP/01 is: ' . $region;
}
?>
以上例程會輸出:
Region name for JP/01 is: Aichi