|
1 | 1 | <?xml version="1.0" encoding="utf-8"?>
|
2 | 2 | <!-- $Revision$ -->
|
3 |
| -<!-- EN-Revision: b7f8c11e56ff1c57a2993e2ed7e5c5ace18637fd Maintainer: takagi Status: ready --> |
| 3 | +<!-- EN-Revision: f414967c2c80702de6401191034d9837a2801dc1 Maintainer: takagi Status: ready --> |
4 | 4 | <refentry xml:id="function.curl-multi-select" xmlns="http://docbook.org/ns/docbook">
|
5 | 5 | <refnamediv>
|
6 | 6 | <refname>curl_multi_select</refname>
|
7 |
| - <refpurpose>curl_multi 接続のアクティビティを待つ</refpurpose> |
| 7 | + <refpurpose>任意の cURL マルチハンドル接続で読み取りまたは書き込みが可能になるまで待機する</refpurpose> |
8 | 8 | </refnamediv>
|
9 |
| - |
| 9 | + |
10 | 10 | <refsect1 role="description">
|
11 | 11 | &reftitle.description;
|
12 | 12 | <methodsynopsis>
|
|
15 | 15 | <methodparam choice="opt"><type>float</type><parameter>timeout</parameter><initializer>1.0</initializer></methodparam>
|
16 | 16 | </methodsynopsis>
|
17 | 17 | <para>
|
18 |
| - curl_multi 接続に関するアクティビティがあるまでブロックします。 |
| 18 | + スクリプトの実行をブロックし、次の <function>curl_multi_exec</function> の呼び出しで |
| 19 | + cURL マルチハンドルに関連付けられた cURL ハンドルが処理を進められるようになるか、 |
| 20 | + タイムアウトになるまで待機します(どちらか早い方が適用されます)。 |
19 | 21 | </para>
|
20 | 22 |
|
21 | 23 | </refsect1>
|
|
29 | 31 | <term><parameter>timeout</parameter></term>
|
30 | 32 | <listitem>
|
31 | 33 | <para>
|
32 |
| - レスポンスを待つ秒数。 |
| 34 | + アクティブな cURL マルチハンドル接続からのレスポンスを待機する時間(秒単位)。 |
33 | 35 | </para>
|
34 | 36 | </listitem>
|
35 | 37 | </varlistentry>
|
36 | 38 | </variablelist>
|
37 | 39 | </para>
|
38 | 40 | </refsect1>
|
39 |
| - |
| 41 | + |
40 | 42 | <refsect1 role="returnvalues">
|
41 | 43 | &reftitle.returnvalues;
|
42 | 44 | <para>
|
43 | 45 | 成功した場合は、記述子セットに含まれる記述子の数を返します。
|
44 |
| - どの記述子上にもアクティビティがなかった場合は、結果が 0 になることもあります。 |
45 |
| - select に失敗した場合は -1 を返し、それ以外の失敗時は |
46 |
| - (select システムコールから) タイムアウトします。 |
| 46 | + どの記述子上にもアクティビティがなかった場合は、結果が <literal>0</literal> になることもあります。 |
| 47 | + <literal>select()</literal> に失敗した場合は <literal>-1</literal> を返し、それ以外の失敗時は |
| 48 | + ( <literal>select()</literal> システムコールから) タイムアウトします。 |
47 | 49 | </para>
|
48 | 50 | </refsect1>
|
49 | 51 |
|
| 52 | + <refsect1 role="errors"> |
| 53 | + &reftitle.errors; |
| 54 | + <simpara> |
| 55 | + <parameter>timeout</parameter> が <literal>0</literal> 未満または <constant>PHP_INT_MAX</constant> |
| 56 | + を超える場合、<exceptionname>ValueError</exceptionname> をスローします。 |
| 57 | + </simpara> |
| 58 | + </refsect1> |
| 59 | + |
50 | 60 | <refsect1 role="changelog">
|
51 | 61 | &reftitle.changelog;
|
52 | 62 | <informaltable>
|
|
58 | 68 | </row>
|
59 | 69 | </thead>
|
60 | 70 | <tbody>
|
| 71 | + <row> |
| 72 | + <entry>8.4.0</entry> |
| 73 | + <entry> |
| 74 | + <parameter>timeout</parameter> が <literal>0</literal> 未満または <constant>PHP_INT_MAX</constant> |
| 75 | + を超える場合、<exceptionname>ValueError</exceptionname> をスローするようになりました。 |
| 76 | + </entry> |
| 77 | + </row> |
61 | 78 | &curl.changelog.multi-handle-param;
|
62 | 79 | </tbody>
|
63 | 80 | </tgroup>
|
|
0 commit comments