array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.geoip-region-name-by-code.php', 1 => 'geoip_region_name_by_code', 2 => 'Retourne le nom de la région pour un pays et un code de région', ), 'up' => array ( 0 => 'ref.geoip.php', 1 => 'Fonctions GeoIP', ), 'prev' => array ( 0 => 'function.geoip-region-by-name.php', 1 => 'geoip_region_by_name', ), 'next' => array ( 0 => 'function.geoip-setup-custom-directory.php', 1 => 'geoip_setup_custom_directory', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/geoip/functions/geoip-region-name-by-code.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

geoip_region_name_by_code

(PECL geoip >= 1.0.4)

geoip_region_name_by_code — Retourne le nom de la région pour un pays et un code de région

Description

geoip_region_name_by_code(string $country_code, string $region_code): string

geoip_region_name_by_code() retourne le nom de la région correspondant à un couple pays et région.

Aux États-Unis d'Amérique, la région correspond à l'abréviation en deux lettres de l'état. Au Canada, cette région correspond à l'abréviation de la province ou du territoire, tel qu'attribué par Poste Canada.

Pour le reste du monde, GeoIP utilise les codes FIPS 10-4 pour représenter les régions. Il est possible de vérifier le site » http://www.maxmind.com/app/fips10_4 pour une liste détaillée des codes FIPS 10-4.

Cette fonction est toujours disponible, si l'on utilise GeoIP Library version 1.4.1 ou plus récent. Les données sont issues directement de GeoIP Library et non pas d'une table de référence.

Liste de paramètres

country_code
Le code de pays, en deux lettres (voir geoip_country_code_by_name())
region_code
Le code de région en deux lettres (voir geoip_region_by_name())

Valeurs de retour

Retourne le nom de la région en cas de succès, ou false si le pays, la région ou la combinaison des deux n'a pas pu être trouvée.

Exemples

Exemple #1 Exemple avec geoip_region_name_by_code() pour les USA et le Canada

Ce script va afficher le nom de la région pour la région QC au CA.

<?php
$region = geoip_region_name_by_code('CA', 'QC');
if ($region) {
echo 'Nom de la région CA/QC : ' . $region;
}
?>

L'exemple ci-dessus va afficher :

Nom de la région CA/QC: Quebec

Exemple #2 Exemple avec geoip_region_name_by_code() en utilisant les codes FIPS

Ce script va afficher le nom de la région pour la région 01 au JP (Japon).

<?php
$region = geoip_region_name_by_code('JP', '01');
if ($region) {
echo 'Nom de la région JP/01: ' . $region;
}
?>

L'exemple ci-dessus va afficher :

Nom de la région JP/01: Aichi