svn: /phpdoc/ru/trunk/reference/curl/functions/ curl-multi-info-read.xml

From: Date: Tue, 08 Feb 2011 18:49:53 +0000
Subject: svn: /phpdoc/ru/trunk/reference/curl/functions/ curl-multi-info-read.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-1386@lists.php.net to get a copy of this message
shein Tue, 08 Feb 2011 18:49:53 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=308138 Log: Updated translation. Changed paths: U phpdoc/ru/trunk/reference/curl/functions/curl-multi-info-read.xml Modified: phpdoc/ru/trunk/reference/curl/functions/curl-multi-info-read.xml =================================================================== --- phpdoc/ru/trunk/reference/curl/functions/curl-multi-info-read.xml 2011-02-08 18:38:34 UTC (rev 308137) +++ phpdoc/ru/trunk/reference/curl/functions/curl-multi-info-read.xml 2011-02-08 18:49:53 UTC (rev 308138) @@ -1,27 +1,204 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: n/a Maintainer: blindman Status: ready --> +<!-- EN-Revision: 298918 Maintainer: shein Status: ready --> +<!-- Reviewed: no --> <!-- $Revision$ --> - <refentry xml:id="function.curl-multi-info-read" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>curl_multi_info_read</refname> - <refpurpose>Возвращает информацию о текущих операциях</refpurpose> - </refnamediv> - <refsect1> - <title>Описание</title> - <methodsynopsis> - <type>array</type><methodname>curl_multi_info_read</methodname> - <methodparam><type>resource</type><parameter>mh</parameter></methodparam> - </methodsynopsis> - - &warn.undocumented.func; - - <simpara> - См. также описание функции - <function>curl_multi_init</function>. - </simpara> - </refsect1> - </refentry> +<refentry xml:id="function.curl-multi-info-read" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>curl_multi_info_read</refname> + <refpurpose>Возвращает информацию о текущих операциях</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>curl_multi_info_read</methodname> + <methodparam><type>resource</type><parameter>mh</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">msgs_in_queue</parameter><initializer>&null;</initializer></methodparam> + </methodsynopsis> + <para> + Опрашивает набор дескрипторов о наличии сообщений или информации + от индивидуальных передач. Сообщения могут включать такую информацию + как код ошибки передачи или прост факт завершения передачи. + </para> + <para> + Повторяющиеся вызовы этой функции будут каждый раз возвращать + новый результат, пока не будет возвращено &false; в качестве + сигнала окончания сообщений. Целое число, содержащееся в + <parameter>msgs_in_queue</parameter>, указывает количество оставшихся + сообщений после вызова данной функции. + </para> + <warning> + <para> + Данные, на которые указывает возвращаемый ресурс, будут затерты + вызовом <function>curl_multi_remove_handle</function>. + </para> + </warning> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &curl.mh.description; + <varlistentry> + <term><parameter>msgs_in_queue</parameter></term> + <listitem> + <para> + Количество оставшихся сообщений в очереди + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + В случае успеха, возвращает ассоциативный массив сообщений, или &false; в случае + неудачи. + </para> + <para> + <table> + <title>Содержимое возвращаемого массива</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Ключ:</entry> + <entry>Значение:</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>msg</literal></entry> + <entry>Константа <constant>CURLMSG_DONE</constant>. Остальные возвращаемые + значения пока недоступны.</entry> + </row> + <row> + <entry><literal>result</literal></entry> + <entry>Одна из констант <constant>CURLE_*</constant>. Если все + OK, результатом будет константа <constant>CURLE_OK</constant>.</entry> + </row> + <row> + <entry><literal>handle</literal></entry> + <entry>Ресурс типа curl, указывающий на дескриптор, к которому он относится.</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Пример использования <function>curl_multi_info_read</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +$urls = array( + "http://www.cnn.com/", + "http://www.bbc.co.uk/", + "http://www.yahoo.com/" +); + +$mh = curl_multi_init(); + +foreach ($urls as $i => $url) { + $conn[$i] = curl_init($url); + curl_setopt($conn[$i], CURLOPT_RETURNTRANSFER, 1); + curl_multi_add_handle($mh, $conn[$i]); +} + +do { + $status = curl_multi_exec($mh, $active); + $info = curl_multi_info_read($mh); + if (false !== $info) { + var_dump($info); + } +} while ($status === CURLM_CALL_MULTI_PERFORM || $active); + +foreach ($urls as $i => $url) { + $res[$i] = curl_multi_getcontent($conn[$i]); + curl_close($conn[$i]); +} + +var_dump(curl_multi_info_read($mh)); + +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +array(3) { + ["msg"]=> + int(1) + ["result"]=> + int(0) + ["handle"]=> + resource(5) of type (curl) +} +array(3) { + ["msg"]=> + int(1) + ["result"]=> + int(0) + ["handle"]=> + resource(7) of type (curl) +} +array(3) { + ["msg"]=> + int(1) + ["result"]=> + int(0) + ["handle"]=> + resource(6) of type (curl) +} +bool(false) +]]> + </screen> + </example> + </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.2.0</entry> + <entry> + Добавлен параметр <parameter>msgs_in_queue</parameter>. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>curl_multi_init</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -33,7 +210,7 @@ sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil -sgml-default-dtd-file:"../~/.phpdoc/manual.ced" +sgml-default-dtd-file:"~/.phpdoc/manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil

« previous php.doc.ru (#1386) next »