wip: 進捗率 40 % くらい

Author: nsfisis

reference/curl/constants_curl_setopt.xml

@@ -1982,20 +1982,20 @@
        <term><parameter>passwordPrompt</parameter></term>
        <listitem>
         <simpara>
-         A password prompt.
+         パスワードプロンプト。
         </simpara>
        </listitem>
       </varlistentry>
       <varlistentry>
        <term><parameter>maximumPasswordLength</parameter></term>
        <listitem>
         <simpara>
-         The maximum length of the password.
+         パスワードの最大長。
         </simpara>
        </listitem>
       </varlistentry>
      </variablelist>
-     The callback should return a <type>string</type> containing the password.
+     このコールバックは、パスワードが入った <type>string</type> を返さなければなりません。
      cURL 7.4.2 以降で利用可能でしたが、cURL 7.11.1 からは非推奨となっており、
      cURL 7.15.5 を最後に削除されました。
      PHP 7.3.0 で削除されました。
@@ -2219,45 +2219,45 @@
        <term><parameter>bytesToDownload</parameter></term>
        <listitem>
         <simpara>
-         The total number of bytes expected to be downloaded in this transfer.
+         この転送でダウンロードされようとしている総バイト数。
         </simpara>
        </listitem>
       </varlistentry>
       <varlistentry>
        <term><parameter>bytesDownloaded</parameter></term>
        <listitem>
         <simpara>
-         The number of bytes downloaded so far.
+         これまでにダウンロードされたバイト数。
         </simpara>
        </listitem>
       </varlistentry>
       <varlistentry>
        <term><parameter>bytesToUpload</parameter></term>
        <listitem>
         <simpara>
-         The total number of bytes expected to be uploaded in this transfer.
+         この転送でアップロードされようとしている総バイト数。
         </simpara>
        </listitem>
       </varlistentry>
       <varlistentry>
        <term><parameter>bytesUploaded</parameter></term>
        <listitem>
         <simpara>
-         The number of bytes uploaded so far.
+         これまでにアップロードされたバイト数。
         </simpara>
        </listitem>
       </varlistentry>
      </variablelist>
-     The callback should return an <type>int</type> with a non-zero value to abort the transfer
-     and set a <constant>CURLE_ABORTED_BY_CALLBACK</constant> error.
+     転送を中断し、<constant>CURLE_ABORTED_BY_CALLBACK</constant> エラーをセットするには、
+     このコールバックから非ゼロの <type>int</type> を返してください。
      <note>
       <para>
-       The callback is only called when the <constant>CURLOPT_NOPROGRESS</constant>
-       option is set to &false;.
+       このコールバックが呼ばれるのは、<constant>CURLOPT_NOPROGRESS</constant> オプションが
+       &false; に設定されている場合のみです。
       </para>
      </note>
      cURL 7.1.0 以降で利用可能ですが、cURL 7.32.0 以降は非推奨となりました。
-     Use <constant>CURLOPT_XFERINFOFUNCTION</constant> instead.
+     代わりに <constant>CURLOPT_XFERINFOFUNCTION</constant> を用いてください。
     </para>
    </listitem>
   </varlistentry>
@@ -2937,24 +2937,24 @@
        <term><parameter>streamResource</parameter></term>
        <listitem>
         <simpara>
-         Stream <type>resource</type> provided to cURL through the option
-     <constant>CURLOPT_READDATA</constant>.
+         <constant>CURLOPT_READDATA</constant> オプションを通して
+         cURL へと渡されたストリーム <type>resource</type>。
         </simpara>
        </listitem>
       </varlistentry>
       <varlistentry>
        <term><parameter>maxAmountOfDataToRead</parameter></term>
        <listitem>
         <simpara>
-         The maximum amount of data to be read.
+         読み出すべきデータの最大長。
         </simpara>
        </listitem>
       </varlistentry>
      </variablelist>
-     The callback should return a <type>string</type>
-     with a length equal or smaller than the amount of data requested,
-     typically by reading it from the passed stream <type>resource</type>. It should
-     return an empty <type>string</type> to signal <literal>EOF</literal>.
+     このコールバックは、要求されたデータ長以下の <type>string</type> を
+     返さなければなりません。
+     典型的には、渡されたストリーム <type>resource</type> からデータを読み出して返します。
+     <literal>EOF</literal> を伝えるためには空の <type>string</type> を返してください。
      cURL 7.1.0 以降で利用可能です。
     </para>
    </listitem>
@@ -4343,14 +4343,13 @@
        <term><parameter>data</parameter></term>
        <listitem>
         <simpara>
-         The data to be written.
+         書き込むべきデータ。
         </simpara>
        </listitem>
       </varlistentry>
      </variablelist>
-     The data must be saved by the callback
-     and the callback must return the exact number of bytes written
-     or the transfer will be aborted with an error.
+     このコールバックは、データを保存して書き込んだバイト数を返さなければなりません。
+     そうしないなら、転送はエラーで中止されます (訳注: 一度にすべてのデータを書き込む必要があり、部分的な書き込みはできません。つまり、返り値は渡されたデータ長と一致しなければなりません)。
      cURL 7.1.0 以降で利用可能です。
     </para>
    </listitem>
@@ -4410,37 +4409,37 @@
        <term><parameter>bytesToDownload</parameter></term>
        <listitem>
         <simpara>
-         The total number of bytes expected to be downloaded in this transfer.
+         この転送でダウンロードされようとしている総バイト数。
         </simpara>
        </listitem>
       </varlistentry>
       <varlistentry>
        <term><parameter>bytesDownloaded</parameter></term>
        <listitem>
         <simpara>
-         The number of bytes downloaded so far.
+         これまでにダウンロードされたバイト数。
         </simpara>
        </listitem>
       </varlistentry>
       <varlistentry>
        <term><parameter>bytesToUpload</parameter></term>
        <listitem>
         <simpara>
-         The total number of bytes expected to be uploaded in this transfer.
+         この転送でアップロードされようとしている総バイト数。
         </simpara>
        </listitem>
       </varlistentry>
       <varlistentry>
        <term><parameter>bytesUploaded</parameter></term>
        <listitem>
         <simpara>
-         The number of bytes uploaded so far.
+         これまでにアップロードされたバイト数。
         </simpara>
        </listitem>
       </varlistentry>
      </variablelist>
-     Return <literal>1</literal> to abort the transfer
-     and set a <constant>CURLE_ABORTED_BY_CALLBACK</constant> error.
+     転送を中断し、<constant>CURLE_ABORTED_BY_CALLBACK</constant> エラーをセットするには、
+     <literal>1</literal> を返してください。
      PHP 8.2.0 以降かつ cURL 7.32.0 以降で利用可能です。
     </para>
    </listitem>
@@ -4557,7 +4556,7 @@
    <listitem>
     <para>
      PHP 8.4.0 以降で利用可能です。
-     This option requires <constant>CURLOPT_VERBOSE</constant> option enabled.
+     このオプションを利用するには <constant>CURLOPT_VERBOSE</constant> オプションを有効にする必要があります。
      A <type>callable</type> to replace the standard cURL verbose output.
      This callback gets called during various stages of the request with verbose debug information.
      このコールバックは、以下のシグニチャである必要があります。