svn: /phpdoc/bg/trunk/reference/strings/functions/ wordwrap.xml

stanprog                                 Sun, 27 Dec 2015 20:25:41 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=338375

Log:
sync to EN

Changed paths:
    U   phpdoc/bg/trunk/reference/strings/functions/wordwrap.xml

Modified: phpdoc/bg/trunk/reference/strings/functions/wordwrap.xml
===================================================================
--- phpdoc/bg/trunk/reference/strings/functions/wordwrap.xml	2015-12-27 20:10:51 UTC (rev 338374)
+++ phpdoc/bg/trunk/reference/strings/functions/wordwrap.xml	2015-12-27 20:25:41 UTC (rev 338375)
@@ -1,11 +1,13 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: stanprog Status: ready -->
+<!-- EN-Revision: 336762 Maintainer: stanprog Status: ready -->
+<!-- Reviewed: yes Maintainer: stanprog -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.wordwrap">
  <refnamediv>
   <refname>wordwrap</refname>
   <refpurpose>Извършва пренос на низ, по зададен брой знаци</refpurpose>
  </refnamediv>
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
@@ -16,7 +18,8 @@
    <methodparam choice="opt"><type>bool</type><parameter>cut</parameter><initializer>false</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Извършва пренос на низ, по зададен брой знаци, използвайки знак за пренос.
+   Извършва пренос на низ, по зададен брой знаци, използвайки знак
+   за пренос.
   </para>
  </refsect1>

@@ -36,7 +39,7 @@
      <term><parameter>width</parameter></term>
      <listitem>
       <para>
-       Ширината на колоната. По подразбиране е 75.
+       Брой знаци, при който низът ще бъде пренесен на нов ред.
       </para>
      </listitem>
     </varlistentry>
@@ -44,8 +47,8 @@
      <term><parameter>break</parameter></term>
      <listitem>
       <para>
-       Преносът се извършва посредством незадължителен
-       параметър за знак за пренос. По подразбиране е '<literal>\n</literal>'.
+       Преносът се извършва посредством незадължителният
+       параметър <parameter>break</parameter>.
       </para>
      </listitem>
     </varlistentry>
@@ -53,10 +56,11 @@
      <term><parameter>cut</parameter></term>
      <listitem>
       <para>
-       Ако параметърът <parameter>cut</parameter> е установен в &true;,
-       пренасянето се осъществява точно от зададената колона.
-       Поради това, ако в низа има дума по-дълга от зададената дължина,
-       то тя бива разделена на части. (Вж. вторият пример)
+       Ако параметърът <parameter>cut</parameter> е установен в &true;, низът
+       винаги се пренася на или преди указаната ширина (<parameter>width</parameter>). Така че, ако има
+       дума, която по-дълга от зададената ширина, тя бива разделена на части.
+       (Вж. вторият пример). Ако параметърът има стойност &false;, функцията не разделя думата
+       дори и ако параметъра <parameter>width</parameter> има по-малка стойност от ширината на думата.
       </para>
      </listitem>
     </varlistentry>
@@ -71,30 +75,6 @@
   </para>
  </refsect1>

- <refsect1 role="changelog">
-  &reftitle.changelog;
-  <para>
-   <informaltable>
-    <tgroup cols="2">
-     <thead>
-      <row>
-       <entry>&Version;</entry>
-       <entry>&Description;</entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>4.0.3</entry>
-       <entry>
-        Добавен е незадължителният параметър <parameter>cut</parameter>.
-       </entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </informaltable>
-  </para>
- </refsect1>
-
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -103,7 +83,7 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-$text = "Бързата кафява лисица прескочи ленивото куче.";
+$text = "The quick brown fox jumped over the lazy dog.";
 $newtext = wordwrap($text, 20, "<br />\n");

 echo $newtext;
@@ -113,9 +93,9 @@
     &example.outputs;
     <screen>
 <![CDATA[
-Бързата кафява<br />
-лисица прескочи<br />
-ленивото куче.
+The quick brown fox<br />
+jumped over the lazy<br />
+dog.
 ]]>
     </screen>
    </example>
@@ -124,7 +104,7 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-$text = "Тази дума е много дъъъъъъъъъъълга.";
+$text = "A very long woooooooooooord.";
 $newtext = wordwrap($text, 8, "\n", true);

 echo "$newtext\n";
@@ -134,14 +114,36 @@
     &example.outputs;
     <screen>
 <![CDATA[
-Тази
-дума е
-много
-дъъъъъъъ
-ъъъълга.
+A very
+long
+wooooooo
+ooooord.
 ]]>
     </screen>
    </example>
+   <example>
+    <title>Пример за <function>wordwrap</function></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$text = "A very long woooooooooooooooooord. and something";
+$newtext = wordwrap($text, 8, "\n", false);
+
+echo "$newtext\n";
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+A very
+long
+woooooooooooooooooord.
+and
+something
+]]>
+    </screen>
+   </example>
   </para>
  </refsect1>