GEOIP_REGION_NAME_BY_CODE(3) 1 GEOIP_REGION_NAME_BY_CODE(3)geoip_region_name_by_code - Returns the region name for some country and region code comboSYNOPSIS
string geoip_region_name_by_code (string $country_code, string $region_code)
DESCRIPTION
The geoip_region_name_by_code(3) 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 http://www.maxmind.com/app/fips10_4 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.
PARAMETERS
o $country_code
- The two-letter country code (see geoip_country_code_by_name(3))
o $region_code
- The two-letter (or digit) region code (see geoip_region_by_name(3))
RETURN VALUES
Returns the region name on success, or FALSE if the country and region code combo cannot be found.
EXAMPLES
Example #1
A geoip_region_name_by_code(3) 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;
}
?>
The above example will output:
Region name for CA/QC is: Quebec
Example #2
A geoip_region_name_by_code(3) 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;
}
?>
The above example will output:
Region name for JP/01 is: Aichi
PHP Documentation Group GEOIP_REGION_NAME_BY_CODE(3)
Check Out this Related Man Page
XIntersectRegion(3) XLIB FUNCTIONS XIntersectRegion(3)NAME
XIntersectRegion, XUnionRegion, XUnionRectWithRegion, XSubtractRegion, XXorRegion, XOffsetRegion, XShrinkRegion - region arithmetic
SYNTAX
int XIntersectRegion(Region sra, Region srb, Region dr_return);
int XUnionRegion(Region sra, Region srb, Region dr_return);
int XUnionRectWithRegion(XRectangle *rectangle, Region src_region, Region dest_region_return);
int XSubtractRegion(Region sra, Region srb, Region dr_return);
int XXorRegion(Region sra, Region srb, Region dr_return);
int XOffsetRegion(Region r, int dx, int dy);
int XShrinkRegion(Region r, int dx, int dy);
ARGUMENTS
dest_region_return
Returns the destination region.
dr_return Returns the result of the computation. ds Dy move or shrink
dx
dy Specify the x and y coordinates, which define the amount you want to the specified region.
r Specifies the region.
rectangle Specifies the rectangle.
sra
srb Specify the two regions with which you want to perform the computation.
src_region
Specifies the source region to be used.
DESCRIPTION
The XIntersectRegion function computes the intersection of two regions.
The XUnionRegion function computes the union of two regions.
The XUnionRectWithRegion function updates the destination region from a union of the specified rectangle and the specified source region.
The XSubtractRegion function subtracts srb from sra and stores the results in dr_return.
The XXorRegion function calculates the difference between the union and intersection of two regions.
The XOffsetRegion function moves the specified region by a specified amount.
The XShrinkRegion function reduces the specified region by a specified amount. Positive values shrink the size of the region, and negative
values expand the region.
SEE ALSO XCreateRegion(3), XDrawRectangle(3), XEmptyRegion(3)
Xlib - C Language X Interface
X Version 11 libX11 1.5.0 XIntersectRegion(3)