geoip_region_name_by_code

Returns the region name for some country and region code combo

&reftitle.description; `string` `geoip_region_name_by_code` `string` `country_code` `string` `region_code`

The `geoip_region_name_by_code` function will return the region name corresponding to a country and region code combo.

In the United States, the region code corresponds to the two-letter abbreviation of each state. In Canada, the region code corresponds to the two-letter province or territory code as attributed by Canada Post.

For the rest of the world, GeoIP uses FIPS 10-4 codes to represent regions. You can check &url.maxmind.fips; for a detailed list of FIPS 10-4 codes.

This function is always available if using GeoIP Library version 1.4.1 or newer. The data is taken directly from the GeoIP Library and not from any database.

&reftitle.parameters;

`country_code`

- The two-letter country code (see `geoip_country_code_by_name`)

`region_code`

- The two-letter (or digit) region code (see `geoip_region_by_name`)

&reftitle.returnvalues;

Returns the region name on success, or &false; if the country and region code combo cannot be found.

&reftitle.examples;

### A `geoip_region_name_by_code` example using region code for US/Canada

This will print the region name for country CA (Canada), region QC (Quebec).

    <?php
    $region = geoip_region_name_by_code('CA', 'QC');
    if ($region) {
        echo 'Region name for CA/QC is: ' . $region;
    }
    ?>

&example.outputs;

    Region name for CA/QC is: Quebec

### A `geoip_region_name_by_code` example using FIPS codes

This will print the region name for country JP (Japan), region 01.

    <?php
    $region = geoip_region_name_by_code('JP', '01');
    if ($region) {
        echo 'Region name for JP/01 is: ' . $region;
    }
    ?>

&example.outputs;

    Region name for JP/01 is: Aichi