-
Notifications
You must be signed in to change notification settings - Fork 70
/
geoip-region-name-by-code.xml
139 lines (136 loc) · 4.81 KB
/
geoip-region-name-by-code.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: aur Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.geoip-region-name-by-code" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>geoip_region_name_by_code</refname>
<refpurpose>Возвращает название региона для выбранной страны и кода региона</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>geoip_region_name_by_code</methodname>
<methodparam><type>string</type><parameter>country_code</parameter></methodparam>
<methodparam><type>string</type><parameter>region_code</parameter></methodparam>
</methodsynopsis>
<para>
Функция <function>geoip_region_name_by_code</function> возвращает название региона,
соответствующей страны и кода региона.
</para>
<para>
В США код региона соответствует двухбуквенному сокращению каждому штату.
В Канаде код региона соответствует двухбуквенному сокращению имени провинции или
территории, присвоенный почтовой службой Канады.
</para>
<para>
Для остального мира GeoIP использует коды FIPS 10-4 для представления региона.
Смотрите также <link xlink:href="&url.maxmind.fips;">&url.maxmind.fips;</link>
-- детальный список кодов FIPS 10-4.
</para>
<para>
Данная функция всегда доступна при использовании библиотеки GeoIP версии 1.4.1 и новее.
Данные берутся непосредственно из библиотеки GeoIP, а не из какой-либо базы.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>country_code</parameter></term>
<listitem>
<para>
Двухбуквенный код страны
<function>geoip_country_code_by_name</function>)
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>region_code</parameter></term>
<listitem>
<para>
Двухбуквенный (или цифровой) код региона
<function>geoip_region_by_name</function>)
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает название региона в случае успехе или &false;,
если страна и код региона не найдены в базе данных.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>geoip_region_name_by_code</function> (Для Канады/США)</title>
<para>
Будет выведено название региона для страны CA (Канада), региона QC (Квебек).
</para>
<programlisting role="php">
<![CDATA[
<?php
$region = geoip_region_name_by_code('CA', 'QC');
if ($region) {
echo 'Название региона для CA/QC: ' . $region;
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Название региона для CA/QC: Quebec
]]>
</screen>
</example>
<example>
<title>Пример использования <function>geoip_region_name_by_code</function>, используя коды FIPS</title>
<para>
Будет выведено имя региона для страны JP (Япония), региона 01 (префектура Айти).
</para>
<programlisting role="php">
<![CDATA[
<?php
$region = geoip_region_name_by_code('JP', '01');
if ($region) {
echo 'Название региона для JP/01: ' . $region;
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Название региона для JP/01: Aichi
]]>
</screen>
</example>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->