svn: /phpdoc/bg/trunk/reference/filesystem/functions/ pathinfo.xml

stanprog                                 Sun, 19 Jun 2016 22:53:57 +0000

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

Log:
sync with EN

Changed paths:
    U   phpdoc/bg/trunk/reference/filesystem/functions/pathinfo.xml

Modified: phpdoc/bg/trunk/reference/filesystem/functions/pathinfo.xml
===================================================================
--- phpdoc/bg/trunk/reference/filesystem/functions/pathinfo.xml	2016-06-19 22:27:10 UTC (rev 339412)
+++ phpdoc/bg/trunk/reference/filesystem/functions/pathinfo.xml	2016-06-19 22:53:57 UTC (rev 339413)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: ogre Status: ready -->
+<!-- EN-Revision: 331135 Maintainer: stanprog Status: ready -->
+<!-- CREDITS: ogre -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.pathinfo">
  <refnamediv>
   <refname>pathinfo</refname>
@@ -12,13 +13,15 @@
   <methodsynopsis>
    <type>mixed</type><methodname>pathinfo</methodname>
    <methodparam><type>string</type><parameter>path</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>PATHINFO_DIRNAME | PATHINFO_BASENAME | PATHINFO_EXTENSION | PATHINFO_FILENAME</initializer></methodparam>
   </methodsynopsis>
   <para>
-   <function>pathinfo</function> връща асоциативен масив, съдържащ информация отностно <parameter>path</parameter>.
+   <function>pathinfo</function> връща информация за
+   <parameter>path</parameter>: или асоциативен масив, или низ,
+   в зависимост от параметъра <parameter>options</parameter>.
   </para>
  </refsect1>
-
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -35,31 +38,51 @@
      <term><parameter>options</parameter></term>
      <listitem>
       <para>
-    Можете да определите кои елементи да бъдат върнати чрез опционалния параметър <parameter>options</parameter>. Той се съставя чрез
-   <constant>PATHINFO_DIRNAME</constant>,
-   <constant>PATHINFO_BASENAME</constant>,
-   <constant>PATHINFO_EXTENSION</constant> и
-   <constant>PATHINFO_FILENAME</constant> (наличен от PHP 5.2.0). По подразбиране стойността му е да връща всички елементи.
+       Ако е установен, ще бъдат върнати някои от следните стойности
+       <constant>PATHINFO_DIRNAME</constant>,
+       <constant>PATHINFO_BASENAME</constant>,
+       <constant>PATHINFO_EXTENSION</constant> или
+       <constant>PATHINFO_FILENAME</constant>.
       </para>
+      <para>Ако не е установен параметър <parameter>options</parameter>, се връщат всички
+       налични елементи.
+      </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>
-
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Върнатият масив съдържа следните елементи: <literal>dirname</literal>,
-   <literal>basename</literal>, <literal>extension</literal> (ако има) и
-   <literal>filename</literal>
+   Ако параметъра <parameter>options</parameter> не е установен,
+   се връща асоциативен масив, съдържащ следните
+   елементи:
+   <literal>dirname</literal>, <literal>basename</literal>,
+   <literal>extension</literal> (ако има) и <literal>filename</literal>
   </para>
-
+  <note>
+   <para>
+    Ако <parameter>path</parameter> има повече от едно разширение,
+    <constant>PATHINFO_EXTENSION</constant> връща само последното, а
+    <constant>PATHINFO_FILENAME</constant> отрязва само последното.
+    (вижте първият пример по-долу).
+   </para>
+  </note>
+  <note>
+   <para>
+    Ако <parameter>path</parameter> няма разширение,
+    няма да бъде върнат елемент <literal>extension</literal>.
+    (вижте вторият пример по-долу).
+   </para>
+  </note>
   <para>
-   Ако не всички елементи са изискани чрез <parameter>options</parameter> функцията връща низ.
+   Ако е наличен <parameter>options</parameter>, връща
+   низ съдържащ заявения елемент.
   </para>
  </refsect1>
-
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <para>
@@ -83,7 +106,7 @@
    </informaltable>
   </para>
  </refsect1>
-
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -104,25 +127,57 @@
     &example.outputs;
     <screen>
 <![CDATA[
-/www/htdocs
-index.html
-html
-index
+/www/htdocs/inc
+lib.inc.php
+php
+lib.inc
 ]]>
     </screen>
    </example>
   </para>
+  <para>
+   <example>
+    <title>Пример за <function>pathinfo</function>, показващ разликата между null и липсата на разширение</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$path_parts = pathinfo('/path/emptyextension.');
+var_dump($path_parts['extension']);
+
+$path_parts = pathinfo('/path/noextension');
+var_dump($path_parts['extension']);
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <screen>
+<![CDATA[
+string(0) ""
+
+Notice: Undefined index: extension in test.php on line 6
+NULL
+]]>
+    </screen>
+   </example>
+  </para>
  </refsect1>
-
+
  <refsect1 role="notes">
   &reftitle.notes;
   <note>
    <para>
     За информация относно извличането на текущия път, прочетете раздел
     <link linkend="language.variables.predefined">
-    Предварително-дефинирани променливи</link>.
+     Предварително-дефинирани променливи</link>.
    </para>
   </note>
+  <note>
+   <para>
+    <function>pathinfo</function> зависи от локала, така че, за да може да анализира път,
+    съдържащ многобайтов знак правилно, съответният локал трябва да бъде установен посредством
+    функция <function>setlocale</function>.
+   </para>
+  </note>
  </refsect1>

  <refsect1 role="seealso">
@@ -136,7 +191,7 @@
    </simplelist>
   </para>
  </refsect1>
-
+
 </refentry>

 <!-- Keep this comment at the end of the file