cvs: phpdoc-ru /reference/strings/functions substr-compare.xml
| From: | Antony Dovgal | Date: | Tue, 27 Apr 2004 06:22:54 +0000 |
| Subject: | cvs: phpdoc-ru /reference/strings/functions substr-compare.xml | ||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-317@lists.php.net to get a copy of this message | ||
tony2001 Tue Apr 27 02:22:54 2004 EDT
Modified files:
/phpdoc-ru/reference/strings/functions substr-compare.xml
Log:
add translation of substr_compare (Andrey Demenev)
http://cvs.php.net/diff.php/phpdoc-ru/reference/strings/functions/substr-compare.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc-ru/reference/strings/functions/substr-compare.xml
diff -u phpdoc-ru/reference/strings/functions/substr-compare.xml:1.1
phpdoc-ru/reference/strings/functions/substr-compare.xml:1.2
--- phpdoc-ru/reference/strings/functions/substr-compare.xml:1.1 Mon Apr 12 04:41:56 2004
+++ phpdoc-ru/reference/strings/functions/substr-compare.xml Tue Apr 27 02:22:53 2004
@@ -1,16 +1,16 @@
<?xml version="1.0" encoding="windows-1251"?>
-<!-- EN-Revision: 1.1 Maintainer: blindman Status: ready -->
-<!-- $Revision: 1.1 $ -->
+<!-- EN-Revision: 1.2 Maintainer: blindman Status: ready -->
+<!-- $Revision: 1.2 $ -->
<refentry id="function.substr-compare">
<refnamediv>
<refname>substr_compare</refname>
<refpurpose>
- Áåçîïàñíîå äëÿ îáðàáîòêè äàííûõ â äâîè÷íîé ôîðìå
ñðàâíåíèå 2 ñòðîê ñî
- ñìåùåíèì, ñ ó÷åòîì èëè áåç ó÷åòà ðåãèñòðà
+ Áåçîïàñíîå äëÿ îáðàáîòêè äàííûõ â äâîè÷íîé ôîðìå
ñðàâíåíèå 2 ñòðîê ñî
+ ñìåùåíèåì, ñ ó÷åòîì èëè áåç ó÷åòà ðåãèñòðà
</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Îïèñàíèå</title>
<methodsynopsis>
<type>int</type><methodname>substr_compare</methodname>
<methodparam><type>string</type><parameter>main_str</parameter></methodparam>
@@ -20,7 +20,42 @@
<methodparam
choice="opt"><type>bool</type><parameter>case_sensitivity</parameter></methodparam>
</methodsynopsis>
- &warn.undocumented.func;
+ <para>
+ <function>substr_compare</function> ñðàâíèâàåò ñòðîêó
+ <parameter>main_str</parameter> íà÷èíàÿ ñ ñèìâîëà, íîìåð
êîòîðîãî
+ çàäàí àðãóìåíòîì <parameter>offset</parameter>, ñî ñòðîêîé
+ <parameter>str</parameter>.  ñðàâíåíèè ó÷àñòâóþò
ìàêñèìóì
+ <parameter>length</parameter> ñèìâîëîâ.
+ </para>
+ <para>
+ Âîçâðàùàåò ÷èñëî < 0 åñëè
<parameter>main_str</parameter> íà÷èíàÿ
+ ñ ñèìâîëà <parameter>offset</parameter> ìåíüøå ÷åì
<parameter>str</parameter>, >
+ 0 åñëè îíà áîëüøå <parameter>str</parameter>, è 0 åñëè
ñòðîêè ðàâíû.
+ Åñëè <parameter>length</parameter> áîëüøå èëè ðàâåí äëèíå
+ <parameter>main_str</parameter> è <parameter>offset</parameter>
ïåðåäàí,
+ <function>substr_compare</function> âûâîäèò ïðåäóïðåæäåíèå è
âîçâðàùàåò &false;.
+ </para>
+ <para>
+ Åñëè <parameter>case_sensitivity</parameter> èìååò çíà÷åíèå
&true;,
+ ñðàâíåíèå âûïîëíÿåòñÿ ñ ó÷åòîì ðåãèñòðà.
+ </para>
+ <para>
+ <example>
+ <title>Ïðèìåð èñïîëüçîâàíèÿ
<function>substr_compare</function></title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+echo substr_compare("abcde", "bc", 1, 2); // 0
+echo substr_compare("abcde", "bcg", 1, 2); // 0
+echo substr_compare("abcde", "BC", 1, 2, true); // 0
+echo substr_compare("abcde", "bc", 1, 3); // 1
+echo substr_compare("abcde", "cd", 1, 2); // -1
+echo substr_compare("abcde", "abc", 5, 1); // warning
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
</refsect1>
</refentry>