svn: /phpdoc/bg/trunk/reference/filesystem/functions/ fnmatch.xml
[email protected] (Stanislav Yordanov) Sun, 26 Jun 2016 21:16:37 +0000
| Newsgroups | php.doc.bg |
|---|---|
| Message-ID | <[email protected]> |
stanprog Sun, 26 Jun 2016 21:16:37 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=339506
Log:
sync with EN
Changed paths:
U phpdoc/bg/trunk/reference/filesystem/functions/fnmatch.xml
Modified: phpdoc/bg/trunk/reference/filesystem/functions/fnmatch.xml
===================================================================
--- phpdoc/bg/trunk/reference/filesystem/functions/fnmatch.xml 2016-06-26 20:58:10 UTC (rev 339505)
+++ phpdoc/bg/trunk/reference/filesystem/functions/fnmatch.xml 2016-06-26 21:16:37 UTC (rev 339506)
@@ -1,26 +1,28 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: ogre Status: ready -->
+<!-- EN-Revision: 334762 Maintainer: ogre Status: ready -->
+<!-- Reviewed: no Maintainer: stanprog -->
+<!-- CREDITS: kouber -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fnmatch">
<refnamediv>
<refname>fnmatch</refname>
<refpurpose>Търси съвпадение между име и шаблон</refpurpose>
</refnamediv>
-
+
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>fnmatch</methodname>
<methodparam><type>string</type><parameter>pattern</parameter></methodparam>
<methodparam><type>string</type><parameter>string</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
<function>fnmatch</function> проверява дали подаденият низ <parameter>string</parameter>
-съвпада с шаблона на обвивката <parameter>pattern</parameter>.
+ съвпада с шаблона на обвивката <parameter>pattern</parameter>.
</para>
</refsect1>
-
+
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -41,9 +43,12 @@
използвана и върху обикновени низове.
</para>
<para>
- Средностатистическият потребител е свикнал да използва шаблони на обвивката или поне
- на техните най-прости форми като <literal>'?'</literal> и <literal>'*'</literal>, така че
- използването на <function>fnmatch</function> е по-лесно, отколкото <function>preg_match</function>.
+ Средностатистическият потребител е свикнал да използва шаблони на обвивката или поне на техните
+ най-прости форми като <literal>'?'</literal> и <literal>'*'</literal>,
+ така че използването на <function>fnmatch</function> вместо,
+ <function>preg_match</function>
+ може да е много по-удобно за
+ потребители, които не са програмисти.
</para>
</listitem>
</varlistentry>
@@ -51,22 +56,86 @@
<term><parameter>flags</parameter></term>
<listitem>
<para>
- Вижте документацията на Unix за <literal>fnmatch(3)</literal> за имената на флаговете
- (тъй като те не са документирани тук).
+ Стойността на параметър <parameter>flags</parameter> може да бъде всяка комбинация от
+ следните флагове, разделени с
+ <link linkend="language.operators.bitwise">оператора за двоични ИЛИ (|)</link>.
+ <table>
+ <title>
+ Списък на наличните флагове за <function>fnmatch</function>
+ </title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry><parameter>Флаг</parameter></entry>
+ <entry>Описание</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><constant>FNM_NOESCAPE</constant></entry>
+ <entry>
+ Изключва екранирането на обратно-наклонената черта.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>FNM_PATHNAME</constant></entry>
+ <entry>
+ Наклонената черта в низа съвпада само с наклонена черта в дадения шаблон.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>FNM_PERIOD</constant></entry>
+ <entry>
+ Точката в началото на низ може да съвпада точно с точка в дадения шаблон.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>FNM_CASEFOLD</constant></entry>
+ <entry>
+ Съвпадение без отчитане на регистъра. Част от разширението GNU.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
-
+
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Връща &true; ако има съвпадение или &false; - в противен случай.
</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>5.3.0</entry>
+ <entry>
+ Функцията вече е налична на платформи под Windows.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -84,17 +153,17 @@
</example>
</para>
</refsect1>
-
+
<refsect1 role="notes">
&reftitle.notes;
<warning>
<para>
- Засега тази функция не е налична под Windows или други системи, несъвместими с POSIX.
-
+ Засега тази функция не е налична на системи, несъвместими с POSIX,
+ освен Windows.
</para>
</warning>
</refsect1>
-
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -107,7 +176,7 @@
</simplelist>
</para>
</refsect1>
-
+
</refentry>
<!-- Keep this comment at the end of the file