geoip_country_name_by_name(3) php man page | unix.com

GEOIP_COUNTRY_NAME_BY_NAME(3)						 1					     GEOIP_COUNTRY_NAME_BY_NAME(3)

geoip_country_name_by_name - Get the full country name

SYNOPSIS
       string geoip_country_name_by_name (string  $hostname)

DESCRIPTION
	The geoip_country_name_by_name(3) function will return the full country name corresponding to a hostname or an IP address.

PARAMETERS
	      o $hostname
		- The hostname or IP address whose location is to be looked-up.

RETURN VALUES
	Returns the country name on success, or FALSE if the address cannot be found in the database.

EXAMPLES
       Example #1

	      A geoip_country_name_by_name(3) example

	       This will print where the host example.com is located.

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

	      The above example will output:

	      This host is located in: United States

SEE ALSO
       geoip_country_code_by_name(3), geoip_country_code3_by_name(3).

PHP Documentation Group 											     GEOIP_COUNTRY_NAME_BY_NAME(3)