-
Notifications
You must be signed in to change notification settings - Fork 79
Expand file tree
/
Copy pathip2long.xml
More file actions
140 lines (132 loc) · 4.52 KB
/
ip2long.xml
File metadata and controls
140 lines (132 loc) · 4.52 KB
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
140
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 184f3f7bd45643cb80f828d0bb001991ec3a5fad Maintainer: bfl Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.ip2long">
<refnamediv>
<refname>ip2long</refname>
<refpurpose>Конвертирует строку, содержащую IPv4-адрес в целое число</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>int</type><type>false</type></type><methodname>ip2long</methodname>
<methodparam><type>string</type><parameter>ip</parameter></methodparam>
</methodsynopsis>
<para>
Функция <function>ip2long</function> преобразовывает IPv4-адрес сети Интернет из стандартного
формата (строка с точками) в целое число.
</para>
<para>
Функция <function>ip2long</function> также будет работать с неполными IP-адресами. Смотрите <link xlink:href="&url.ip2long.tech;">&url.ip2long.tech;</link>
для более подробной информации.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>ip</parameter></term>
<listitem>
<para>
Адрес в стандартном формате.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает целое число или &false;, если параметр <parameter>ip</parameter>
содержит ошибку.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>ip2long</function></title>
<programlisting role="php">
<![CDATA[
<?php
$ip = gethostbyname('www.example.com');
$out = "Следующие URL эквивалентны:<br />\n";
$out .= 'http://www.example.com/, http://' . $ip . '/, и http://' . sprintf("%u", ip2long($ip)) . "/<br />\n";
echo $out;
?>
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>Отображение IP-адресов</title>
<para>
Второй пример показывает как выводить сконвертированные адреса с помощью функции <function>printf</function>:
</para>
<programlisting role="php">
<![CDATA[
<?php
$ip = gethostbyname('www.example.com');
$long = ip2long($ip);
if ($long == -1 || $long === FALSE) {
echo 'Неверный IP-адрес, попробуйте ещё раз';
} else {
echo $ip . "\n"; // 192.0.34.166
echo $long . "\n"; // -1073732954
printf("%u\n", ip2long($ip)); // 3221234342
}
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
Ввиду того, что тип PHP <type>int</type> является знаковым, и на 32-битных системах многие IP-адреса будут представлены в виде отрицательных чисел, необходимо
использовать "%u" в функции <function>sprintf</function> или <function>printf</function> для получения IP-адреса в строковом беззнаковом виде.
</para>
</note>
<note>
<para>
Функция <function>ip2long</function> возвратит <literal>-1</literal> для IP
<literal>255.255.255.255</literal> в 32-битных
системах из-за целочисленного переполнения.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>long2ip</function></member>
<member><function>sprintf</function></member>
</simplelist>
</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
-->