# geoip_country_name_by_name

(PECL geoip >= 0.2.0)

geoip_country_name_by_name — 获取国家的全称

### 说明

geoip_country_name_by_name ( string `$hostname` ) : string

geoip_country_name_by_name() 函数返回主机或者 IP 地址所对应的国家名全称。

### 参数

`hostname`

  定位所用的主机或者 IP 地址。

### 返回值

成功，返回国家全称，如果在数据库中未找到相关信息则返回 `FALSE` 。

### 范例

Example #1 geoip_country_name_by_name() 函数的使用范例：

以下代码将会打印 example.com 主机的定位信息。

    <?php
    $country = geoip_country_name_by_name('www.example.com');
    if ($country) {
        echo 'This host is located in: ' . $country;
    }
    ?>

以上例程会输出：

     This host is located in: United States

### 参见

- geoip_country_code_by_name() - 获取国家代码
- geoip_country_code3_by_name() - 获取三个字母组成的国家简称