Skip to content

Commit c9720b6

Browse files
committed
Sync some string functions with EN
1 parent 95626f1 commit c9720b6

File tree

5 files changed

+34
-104
lines changed

5 files changed

+34
-104
lines changed

reference/strings/functions/crc32.xml

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: 33bb5e19aef8b15b0f8b3170cecc3a8f455020bc Maintainer: iSensetivity Status: ready -->
2+
<!-- EN-Revision: e095023e408c8cb6378ae16bb6870343a3946919 Maintainer: iSensetivity Status: ready -->
43
<!-- Reviewed: no -->
54

65
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.crc32">
@@ -13,11 +12,11 @@
1312
&reftitle.description;
1413
<methodsynopsis>
1514
<type>int</type><methodname>crc32</methodname>
16-
<methodparam><type>string</type><parameter>str</parameter></methodparam>
15+
<methodparam><type>string</type><parameter>string</parameter></methodparam>
1716
</methodsynopsis>
1817
<para>
1918
Функція обчислює циклічний надлишковий код 32-бітних поліномів
20-
для рядка <parameter>str</parameter>. Зазвичай використовується
19+
для рядка <parameter>string</parameter>. Зазвичай використовується
2120
для перевірки цілісності передачі даних.
2221
</para>
2322
<warning>
@@ -65,7 +64,7 @@
6564
<para>
6665
<variablelist>
6766
<varlistentry>
68-
<term><parameter>str</parameter></term>
67+
<term><parameter>string</parameter></term>
6968
<listitem>
7069
<para>
7170
Дані.
@@ -79,7 +78,7 @@
7978
<refsect1 role="returnvalues">
8079
&reftitle.returnvalues;
8180
<para>
82-
Повертає контрольну суму CRC32-рядка <parameter>str</parameter> у вигляді цілого числа.
81+
Повертає контрольну суму CRC32-рядка <parameter>string</parameter> у вигляді цілого числа.
8382
</para>
8483
</refsect1>
8584

@@ -118,7 +117,6 @@ printf("%u\n", $checksum);
118117
</refsect1>
119118

120119
</refentry>
121-
122120
<!-- Keep this comment at the end of the file
123121
Local variables:
124122
mode: sgml

reference/strings/functions/md5-file.xml

Lines changed: 7 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: iSensetivity Status: ready -->
2+
<!-- EN-Revision: 71e12e2df7b0bcf0dc2743681b73790ac0d45ccc Maintainer: iSensetivity Status: ready -->
43
<!-- Reviewed: no -->
54

65
<!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 -->
@@ -12,9 +11,9 @@
1211
<refsect1 role="description">
1312
&reftitle.description;
1413
<methodsynopsis>
15-
<type>string</type><methodname>md5_file</methodname>
14+
<type class="union"><type>string</type><type>false</type></type><methodname>md5_file</methodname>
1615
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
17-
<methodparam choice="opt"><type>bool</type><parameter>raw_output</parameter><initializer>&false;</initializer></methodparam>
16+
<methodparam choice="opt"><type>bool</type><parameter>binary</parameter><initializer>&false;</initializer></methodparam>
1817
</methodsynopsis>
1918
<para>
2019
Обчислює MD5-хеш файлу <parameter>filename</parameter> використовуючи
@@ -36,7 +35,7 @@
3635
</listitem>
3736
</varlistentry>
3837
<varlistentry>
39-
<term><parameter>raw_output</parameter></term>
38+
<term><parameter>binary</parameter></term>
4039
<listitem>
4140
<para>
4241
Якщо необов'язковий параметр <parameter>raw_output</parameter> встановлений у &true;,
@@ -55,33 +54,7 @@
5554
інакше &false;.
5655
</para>
5756
</refsect1>
58-
59-
<refsect1 role="changelog">
60-
&reftitle.changelog;
61-
<para>
62-
<informaltable>
63-
<tgroup cols="2">
64-
<thead>
65-
<row>
66-
<entry>&Version;</entry>
67-
<entry>&Description;</entry>
68-
</row>
69-
</thead>
70-
<tbody>
71-
<row>
72-
<entry>5.1.0</entry>
73-
<entry>
74-
Функцію змінено для роботи з потоковим API. Це означає,
75-
що її можна використовувати з обгортками, наприклад,
76-
так: <literal>md5_file('http://example.com/..')</literal>
77-
</entry>
78-
</row>
79-
</tbody>
80-
</tgroup>
81-
</informaltable>
82-
</para>
83-
</refsect1>
84-
57+
8558
<refsect1 role="examples">
8659
&reftitle.examples;
8760
<para>
@@ -104,14 +77,13 @@ echo 'MD5-хеш файлу ' . $file . ': ' . md5_file($file);
10477
&reftitle.seealso;
10578
<para>
10679
<simplelist>
80+
<member><function>hash_file</function></member>
81+
<member><function>hash_init</function></member>
10782
<member><function>md5</function></member>
108-
<member><function>sha1_file</function></member>
109-
<member><function>crc32</function></member>
11083
</simplelist>
11184
</para>
11285
</refsect1>
11386
</refentry>
114-
11587
<!-- Keep this comment at the end of the file
11688
Local variables:
11789
mode: sgml

reference/strings/functions/md5.xml

Lines changed: 7 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: iSensetivity Status: ready -->
2+
<!-- EN-Revision: 71e12e2df7b0bcf0dc2743681b73790ac0d45ccc Maintainer: iSensetivity Status: ready -->
43
<!-- Reviewed: no -->
54

65
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.md5">
@@ -17,11 +16,11 @@
1716
&reftitle.description;
1817
<methodsynopsis>
1918
<type>string</type><methodname>md5</methodname>
20-
<methodparam><type>string</type><parameter>str</parameter></methodparam>
21-
<methodparam choice="opt"><type>bool</type><parameter>raw_output</parameter><initializer>&false;</initializer></methodparam>
19+
<methodparam><type>string</type><parameter>string</parameter></methodparam>
20+
<methodparam choice="opt"><type>bool</type><parameter>binary</parameter><initializer>&false;</initializer></methodparam>
2221
</methodsynopsis>
2322
<para>
24-
Обчислює MD5-хеш рядка <parameter>str</parameter> використовуючи
23+
Обчислює MD5-хеш рядка <parameter>string</parameter> використовуючи
2524
<link xlink:href="&url.rfc;1321">RSA Data Security, Inc.
2625
MD5 Message-Digest Algorithm</link>, та повертає цей хеш.
2726
</para>
@@ -32,18 +31,18 @@
3231
<para>
3332
<variablelist>
3433
<varlistentry>
35-
<term><parameter>str</parameter></term>
34+
<term><parameter>string</parameter></term>
3635
<listitem>
3736
<para>
3837
Рядок.
3938
</para>
4039
</listitem>
4140
</varlistentry>
4241
<varlistentry>
43-
<term><parameter>raw_output</parameter></term>
42+
<term><parameter>binary</parameter></term>
4443
<listitem>
4544
<para>
46-
Якщо необов'язковий параметр <parameter>raw_output</parameter> встановлений у &true;,
45+
Якщо необов'язковий параметр <parameter>binary</parameter> встановлений у &true;,
4746
то повертається бінарний рядок з 16 символів.
4847
</para>
4948
</listitem>
@@ -83,19 +82,13 @@ if (md5($str) === '58bb8ca76e4a13037e7cd0232f387643') {
8382
&reftitle.seealso;
8483
<para>
8584
<simplelist>
86-
<member><function>md5_file</function></member>
87-
<member><function>sha1_file</function></member>
88-
<member><function>crc32</function></member>
89-
<member><function>sha1</function></member>
9085
<member><function>hash</function></member>
91-
<member><function>crypt</function></member>
9286
<member><function>password_hash</function></member>
9387
</simplelist>
9488
</para>
9589
</refsect1>
9690

9791
</refentry>
98-
9992
<!-- Keep this comment at the end of the file
10093
Local variables:
10194
mode: sgml

reference/strings/functions/sha1-file.xml

Lines changed: 8 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: iSensetivity Status: ready -->
2+
<!-- EN-Revision: 71e12e2df7b0bcf0dc2743681b73790ac0d45ccc Maintainer: iSensetivity Status: ready -->
43
<!-- Reviewed: no -->
54

65
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.sha1-file">
@@ -11,9 +10,9 @@
1110
<refsect1 role="description">
1211
&reftitle.description;
1312
<methodsynopsis>
14-
<type>string</type><methodname>sha1_file</methodname>
13+
<type class="union"><type>string</type><type>false</type></type><methodname>sha1_file</methodname>
1514
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
16-
<methodparam choice="opt"><type>bool</type><parameter>raw_output</parameter><initializer>&false;</initializer></methodparam>
15+
<methodparam choice="opt"><type>bool</type><parameter>binary</parameter><initializer>&false;</initializer></methodparam>
1716
</methodsynopsis>
1817
<simpara>
1918
Обчислює SHA1-хеш файла <parameter>filename</parameter> використовуючи
@@ -35,10 +34,10 @@
3534
</listitem>
3635
</varlistentry>
3736
<varlistentry>
38-
<term><parameter>raw_output</parameter></term>
37+
<term><parameter>binary</parameter></term>
3938
<listitem>
4039
<para>
41-
Якщо необов'язковий параметр <parameter>raw_output</parameter>
40+
Якщо необов'язковий параметр <parameter>binary</parameter>
4241
встановлений у &true;,
4342
хеш повернеться у вигляді бінарного рядка з 20 символів,
4443
інакше повернеться 40-символьне шістнадцяткове число.
@@ -79,44 +78,18 @@ foreach(glob('/home/Kalle/myproject/*.php') as $ent)
7978
</example>
8079
</para>
8180
</refsect1>
82-
<refsect1 role="changelog">
83-
&reftitle.changelog;
84-
<para>
85-
<informaltable>
86-
<tgroup cols="2">
87-
<thead>
88-
<row>
89-
<entry>&Version;</entry>
90-
<entry>&Description;</entry>
91-
</row>
92-
</thead>
93-
<tbody>
94-
<row>
95-
<entry>5.1.0</entry>
96-
<entry>
97-
Функцію змінено для роботи з потоковим API. Це означає,
98-
що її можна використовувати з обгортками, наприклад, так:
99-
<literal>sha1_file('http://example.com/..')</literal>
100-
</entry>
101-
</row>
102-
</tbody>
103-
</tgroup>
104-
</informaltable>
105-
</para>
106-
</refsect1>
107-
81+
10882
<refsect1 role="seealso">
10983
&reftitle.seealso;
11084
<para>
11185
<simplelist>
86+
<member><function>hash_file</function></member>
87+
<member><function>hash_init</function></member>
11288
<member><function>sha1</function></member>
113-
<member><function>md5_file</function></member>
114-
<member><function>crc32</function></member>
11589
</simplelist>
11690
</para>
11791
</refsect1>
11892
</refentry>
119-
12093
<!-- Keep this comment at the end of the file
12194
Local variables:
12295
mode: sgml

reference/strings/functions/sha1.xml

Lines changed: 7 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: iSensetivity Status: ready -->
2+
<!-- EN-Revision: 71e12e2df7b0bcf0dc2743681b73790ac0d45ccc Maintainer: iSensetivity Status: ready -->
43
<!-- Reviewed: no -->
54

65
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.sha1">
@@ -17,11 +16,11 @@
1716
&reftitle.description;
1817
<methodsynopsis>
1918
<type>string</type><methodname>sha1</methodname>
20-
<methodparam><type>string</type><parameter>str</parameter></methodparam>
21-
<methodparam choice="opt"><type>bool</type><parameter>raw_output</parameter><initializer>&false;</initializer></methodparam>
19+
<methodparam><type>string</type><parameter>string</parameter></methodparam>
20+
<methodparam choice="opt"><type>bool</type><parameter>binary</parameter><initializer>&false;</initializer></methodparam>
2221
</methodsynopsis>
2322
<simpara>
24-
Обчислює SHA1-хеш рядка <parameter>str</parameter> використовуючи алгоритм
23+
Обчислює SHA1-хеш рядка <parameter>string</parameter> використовуючи алгоритм
2524
<link xlink:href="&url.rfc;3174">US Secure Hash Algorithm 1</link>,
2625
та повертає цей хеш.
2726
</simpara>
@@ -32,18 +31,18 @@
3231
<para>
3332
<variablelist>
3433
<varlistentry>
35-
<term><parameter>str</parameter></term>
34+
<term><parameter>string</parameter></term>
3635
<listitem>
3736
<para>
3837
Рядок.
3938
</para>
4039
</listitem>
4140
</varlistentry>
4241
<varlistentry>
43-
<term><parameter>raw_output</parameter></term>
42+
<term><parameter>binary</parameter></term>
4443
<listitem>
4544
<para>
46-
Якщо необов'язковий параметр <parameter>raw_output</parameter>
45+
Якщо необов'язковий параметр <parameter>binary</parameter>
4746
встановлений у &true;,
4847
хеш повернеться у вигляді бінарного рядка з 20 символів,
4948
інакше повернеться 40-символьне шістнадцяткове число.
@@ -85,18 +84,13 @@ if (sha1($str) === '78742c4f7790d580dca68606a7efad0dcc446709') {
8584
&reftitle.seealso;
8685
<para>
8786
<simplelist>
88-
<member><function>sha1_file</function></member>
89-
<member><function>crc32</function></member>
90-
<member><function>md5</function></member>
9187
<member><function>hash</function></member>
92-
<member><function>crypt</function></member>
9388
<member><function>password_hash</function></member>
9489
</simplelist>
9590
</para>
9691
</refsect1>
9792

9893
</refentry>
99-
10094
<!-- Keep this comment at the end of the file
10195
Local variables:
10296
mode: sgml

0 commit comments

Comments
 (0)