svn: /phpdoc/ru/trunk/reference/ cubrid/cubridmysql/cubrid-query.xml cubrid/cubridmysql/cubrid-real-escape-string.xml cubrid/cubridmysql/cubrid-result.xml cubrid/cubridmysql/cubrid-unbuffered-query.xml cyrus/functions/cyrus-bind.xml

[email protected] (Sergey Panteleev)
Newsgroups php.doc.ru
Message-ID <[email protected]>
sergey                                   Fri, 03 Jan 2020 09:38:11 +0000

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

Log:
docs(ru): Review

Changed paths:
    U   phpdoc/ru/trunk/reference/cubrid/cubridmysql/cubrid-query.xml
    U   phpdoc/ru/trunk/reference/cubrid/cubridmysql/cubrid-real-escape-string.xml
    U   phpdoc/ru/trunk/reference/cubrid/cubridmysql/cubrid-result.xml
    U   phpdoc/ru/trunk/reference/cubrid/cubridmysql/cubrid-unbuffered-query.xml
    U   phpdoc/ru/trunk/reference/cyrus/functions/cyrus-bind.xml
svn-diffs-348777.txt (text/x-diff, 12 KB)
Modified: phpdoc/ru/trunk/reference/cubrid/cubridmysql/cubrid-query.xml
===================================================================
--- phpdoc/ru/trunk/reference/cubrid/cubridmysql/cubrid-query.xml	2020-01-03 02:00:05 UTC (rev 348776)
+++ phpdoc/ru/trunk/reference/cubrid/cubridmysql/cubrid-query.xml	2020-01-03 09:38:11 UTC (rev 348777)
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 330626 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xml:id="function.cubrid-query" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>cubrid_query</refname>
-  <refpurpose>Посылка запроса CUBRID</refpurpose>
+  <refpurpose>Отправка запроса CUBRID</refpurpose>
  </refnamediv>

  <refsect1 role="description">
@@ -17,7 +17,7 @@
   </methodsynopsis>
   <para>
    Функция <function>cubrid_query</function> посылает уникальный запрос (множественные
-   запросы не поддерживаются) текущей активной базе данных заданной идентификатором
+   запросы не поддерживаются) текущей активной базе данных, заданной идентификатором
    соединения <parameter>conn_identifier</parameter>.
   </para>
  </refsect1>
@@ -42,7 +42,7 @@
      <listitem>
       <para>
        Идентификатор соединения. Если не задано, то будет использовано последнее,
-       открытое с помощью <function>cubrid_connect</function> соединений.
+       открытое с помощью <function>cubrid_connect</function> соединение.
       </para>
      </listitem>
     </varlistentry>
@@ -55,15 +55,15 @@
   <para>
    Для SELECT, SHOW, DESCRIBE, EXPLAIN и прочих запросах, возвращающих результирующий
    набор, <function>cubrid_query</function> возвращает <type>resource</type> в случае
-   успеха и &false; в случае ошибки.
+   успешного выполнения и &false; в случае возникновения ошибки.
   </para>
   <para>
    Для прочих типов SQL-запросов, INSERT, UPDATE, DELETE, DROP и т.д,
    <function>cubrid_query</function> возвращает &true; или &false; в зависимости от
-   успешности.
+   успешности выполнения.
   </para>
   <para>
-   Возвращенный результат можео передавать в функцию
+   Возвращенный результат можно передавать в функцию
    <function>cubrid_fetch_array</function> и ей подобные для работы с полученными данными.
   </para>
   <para>
@@ -73,7 +73,7 @@
    для запросов изменяющих данные, таких как DELETE, INSERT, REPLACE и UPDATE.
   </para>
   <para>
-   <function>cubrid_query</function> также может завершиться с ошибкой и вернуть &false;
+   <function>cubrid_query</function> также может завершиться с ошибкой и вернуть &false;,
    если пользоватиль не имеет прав на доступ к таблице, используемой в запросе.
   </para>
  </refsect1>
@@ -94,7 +94,7 @@

 $result = cubrid_query('SELECT * WHERE 1=1');
 if (!$result) {
-    die('Invalid query: ' . cubrid_error());
+    die('Некорректный запрос: ' . cubrid_error());
 }

 ?>
@@ -135,14 +135,14 @@
 // Проверяем результат
 // Показывает сам запрос и ошибку. полезно при отладке.
 if (!$result) {
-    $message  = 'Invalid query: ' . cubrid_error() . "\n";
-    $message .= 'Whole query: ' . $query;
+    $message  = 'Некорректный запрос: ' . cubrid_error() . "\n";
+    $message .= 'Всего запросов: ' . $query;
     die($message);
 }

 // Используем результат
-// Попытrf распечатать $result не позволит получить доступ к информации в ресурсе
-// Должны быть использована одна из функций cubrid
+// Попытка распечатать $result не позволит получить доступ к информации в ресурсе
+// Должна быть использована одна из функций cubrid
 // Смотрите cubrid_result(), cubrid_fetch_array(), cubrid_fetch_row() и т.д.
 while ($row = cubrid_fetch_assoc($result)) {
     echo $row['firstname'];

Modified: phpdoc/ru/trunk/reference/cubrid/cubridmysql/cubrid-real-escape-string.xml
===================================================================
--- phpdoc/ru/trunk/reference/cubrid/cubridmysql/cubrid-real-escape-string.xml	2020-01-03 02:00:05 UTC (rev 348776)
+++ phpdoc/ru/trunk/reference/cubrid/cubridmysql/cubrid-real-escape-string.xml	2020-01-03 09:38:11 UTC (rev 348777)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 317663 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xml:id="function.cubrid-real-escape-string" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -16,7 +16,7 @@
    <methodparam choice="opt"><type>resource</type><parameter>conn_identifier</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Эта функция возвращает экранированную версию переданной строки.
+   Функция возвращает экранированную версию переданной строки.
    Она экранирует символы: <constant>'</constant>.

    В целом, одинарная кавычка используется для обертывания символьной строки.
@@ -55,7 +55,7 @@
    Экранированная строка.
   </para>
   <para>
-   &false; в случае неудачи.
+   &false; в случае возникновения ошибки.
   </para>
  </refsect1>


Modified: phpdoc/ru/trunk/reference/cubrid/cubridmysql/cubrid-result.xml
===================================================================
--- phpdoc/ru/trunk/reference/cubrid/cubridmysql/cubrid-result.xml	2020-01-03 02:00:05 UTC (rev 348776)
+++ phpdoc/ru/trunk/reference/cubrid/cubridmysql/cubrid-result.xml	2020-01-03 09:38:11 UTC (rev 348777)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 317663 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xml:id="function.cubrid-result" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,7 +17,7 @@
    <methodparam choice="opt"><type>mixed</type><parameter>field</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Эта функция возвращает значение из заданного столбца заданной строки результирующего набора.
+   Функция возвращает значение из заданного столбца заданной строки результирующего набора.
   </para>
  </refsect1>

@@ -50,10 +50,10 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Значение заданного столбца в случае успеха (&null; если значение равно null).
+   Значение заданного столбца в случае успешного выполнения (NULL, если значение равно null).
   </para>
   <para>
-   &false; в случае неудачи.
+   &false; в случае возникновения ошибки.
   </para>
  </refsect1>


Modified: phpdoc/ru/trunk/reference/cubrid/cubridmysql/cubrid-unbuffered-query.xml
===================================================================
--- phpdoc/ru/trunk/reference/cubrid/cubridmysql/cubrid-unbuffered-query.xml	2020-01-03 02:00:05 UTC (rev 348776)
+++ phpdoc/ru/trunk/reference/cubrid/cubridmysql/cubrid-unbuffered-query.xml	2020-01-03 09:38:11 UTC (rev 348777)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 331312 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xml:id="function.cubrid-unbuffered-query" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -16,7 +16,7 @@
    <methodparam choice="opt"><type>resource</type><parameter>conn_identifier</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Эта функция выполняет запрос без ожидания его выполнения. Она возвращает значение
+   Функция выполняет запрос без ожидания его выполнения. Она возвращает значение
    в процессе создания результирующего набора.
   </para>
  </refsect1>
@@ -32,7 +32,7 @@
    <varlistentry>
     <term><parameter>conn_identifier</parameter></term>
     <listitem><para>
-     Идентификатор соединения CUBRID. Если не задано, то будет использован последнее
+     Идентификатор соединения CUBRID. Если не задано, то будет использовано последнее
      соединение, возвращенное <function>cubrid_connect</function>.
      </para></listitem>
    </varlistentry>
@@ -43,16 +43,16 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   For SELECT, SHOW, DESCRIBE or EXPLAIN statements returns a request identifier resource on success.
-  </para>
-  <para>
    Для SELECT, SHOW, DESCRIBE, EXPLAIN и прочих запросах, возвращающих результирующий
    набор, <function>cubrid_query</function> возвращает <type>resource</type> в случае
-   успеха.
+   успешного выполнения.
   </para>
   <para>
-   &false; в случае неудачи.
+   Для операторов SQL другого типа, UPDATE, DELETE, DROP и т.д. возвращает &true; в случае успешного выполнения.
   </para>
+  <para>
+   &false; в случае возникновения ошибки.
+  </para>
  </refsect1>

  <refsect1 role="notes">
@@ -77,7 +77,7 @@
     $link = cubrid_connect("localhost", 30000, "demodb", "dba", "");
     if (!$link)
     {
-        die('Could not connect.');
+        die('Не удалось соединиться.');
     }
     $query = "select * from code";
     $result = cubrid_unbuffered_query($query, $link);

Modified: phpdoc/ru/trunk/reference/cyrus/functions/cyrus-bind.xml
===================================================================
--- phpdoc/ru/trunk/reference/cyrus/functions/cyrus-bind.xml	2020-01-03 02:00:05 UTC (rev 348776)
+++ phpdoc/ru/trunk/reference/cyrus/functions/cyrus-bind.xml	2020-01-03 09:38:11 UTC (rev 348777)
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 297028 Maintainer: mch Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xml:id="function.cyrus-bind" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>cyrus_bind</refname>
-  <refpurpose>Привязать callback-функци для Cyrus IMAP соединения</refpurpose>
+  <refpurpose>Привязать callback-функции для Cyrus IMAP соединения</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.