This is a MIME encoded message

--hirokawa987089404
Content-Type: text/plain

hirokawa		Thu Apr 12 08:30:04 2001 EDT

  Modified files:              
    /phpdoc/ja/functions	imap.xml strings.xml 
    /phpdoc/ja/language	control-structures.xml 
  Log:
  update translation.
  
--hirokawa987089404
Content-Type: text/plain
Content-Disposition: attachment; filename="hirokawa-20010412083004.txt"

Index: phpdoc/ja/functions/imap.xml
diff -u phpdoc/ja/functions/imap.xml:1.17 phpdoc/ja/functions/imap.xml:1.18
--- phpdoc/ja/functions/imap.xml:1.17	Sat Mar  3 16:53:36 2001
+++ phpdoc/ja/functions/imap.xml	Thu Apr 12 08:30:00 2001
@@ -83,6 +83,60 @@
     url="&url.imap.book;"> Managing IMAP</ulink>でも得ることができます。
    </para> 
   </partintro> 
+
+  <refentry id="function.imap-8bit"> 
+   <refnamediv> 
+    <refname> imap_8bit</refname>
+    <refpurpose> 
+     8bit 文字列を quoted-printable 文字列に変換する
+    </refpurpose> 
+   </refnamediv> 
+   <refsect1> 
+    <title> 説明</title>
+    <funcsynopsis> 
+     <funcprototype> 
+      <funcdef> string <function>imap_8bit</function></funcdef>
+      <paramdef> string <parameter>string</parameter></paramdef>
+     </funcprototype> 
+    </funcsynopsis> 
+    <para>   
+     (<ulink url="&url.rfc;rfc2045.html"> RFC2045</ulink>, section 6.7
+     に基づき)8bit 文字列をquoted-printable文字列に変換します。
+    </para> 
+    <para> 
+     quoted-printable文字列を返します。
+    </para> 
+    <para> 
+     <function> imap_qprint</function>も参照下さい。
+    </para> 
+   </refsect1> 
+  </refentry> 
+
+  <refentry id="function.imap-alerts"> 
+   <refnamediv> 
+    <refname> imap_alerts</refname>
+    <refpurpose> 
+     ページリクエストの間または最後にスタックがリセットされてä»
¥æ¥ç™ºç”Ÿã—た
+     全てのIMAP警告メッセージを返す
+    </refpurpose> 
+   </refnamediv> 
+   <refsect1> 
+    <title> 説明</title>
+    <funcsynopsis> 
+     <funcprototype> 
+      <funcdef> array <function>imap_alerts</function></funcdef>
+      <paramdef> void </paramdef>
+     </funcprototype> 
+    </funcsynopsis> 
+    <para> 
+     この関数は、直近に <function> imap_alerts</function> をコールして
+     以来、またはページ処理を開始して以来生成された å…¨ IMAP 警告ã
ƒ¡ãƒƒã‚»ãƒ¼
+     ジの配列を得ます。<function> imap_alerts</function> がコールされた
+     場合、カレントのスタックは、処理後にクリアされます。IMAP 規
約では、
+     これらのメッセージをユーザに渡すことが規定されています。
+    </para> 
+   </refsect1> 
+  </refentry> 
  
   <refentry id="function.imap-append"> 
    <refnamediv> 
@@ -173,6 +227,32 @@
    </refsect1> 
   </refentry> 
 
+  <refentry id="function.imap-binary"> 
+   <refnamediv> 
+    <refname> imap_binary</refname>
+     <refpurpose> 8ビット文字列をbase64文字列に変換する</refpurpose>
+   </refnamediv> 
+    <refsect1> 
+    <title> 説明</title>
+    <funcsynopsis> 
+     <funcprototype> 
+      <funcdef> string <function>imap_binary</function></funcdef>
+      <paramdef> string <parameter>string</parameter></paramdef>
+     </funcprototype> 
+    </funcsynopsis> 
+    <para> 
+     (<ulink url="&url.rfc;rfc2045.html"> RFC2045</ulink>,Section 6.8に
+     基づき)8ビット文字列をbase64文字列に変換します。
+    </para> 
+    <para> 
+     base64 文字列を返します。
+    </para> 
+    <para> 
+     <function> imap_base64</function>も参照下さい。
+    </para> 
+   </refsect1> 
+  </refentry> 
+ 
   <refentry id="function.imap-body"> 
    <refnamediv> 
     <refname> imap_body</refname>
@@ -280,6 +360,38 @@
    </refsect1> 
   </refentry> 
 
+  <refentry id="function.imap-clearflag-full"> 
+   <refnamediv> 
+    <refname> imap_clearflag_full</refname>
+    <refpurpose> メッセージのフラグをクリアする</refpurpose>
+   </refnamediv> 
+   <refsect1> 
+    <title> 説明</title>
+    <funcsynopsis> 
+     <funcprototype> 
+      <funcdef> string <function>imap_clearflag_full</function></funcdef>
+      <paramdef> int <parameter>stream</parameter></paramdef>
+      <paramdef> string <parameter>sequence</parameter></paramdef>
+      <paramdef> string <parameter>flag</parameter></paramdef>
+      <paramdef> string <parameter>options</parameter></paramdef>
+     </funcprototype> 
+    </funcsynopsis> 
+    <para> 
+     この関数は、指定したシーケンスのメッセージのフラグからにæŒ
‡å®šã—たフラグ
+     を削除します。設定可能なフラグは、(RFC2060で定義された) "\\Seen
",
+     "\\Answered", "\\Flagged", "\\Deleted", "\\Draft", "\\Recent" です。
+    </para> 
+    <para> 
+     オプションはビットマスクであり、以下の組み合わせとなりまã
™ã€‚
+     <informalexample> 
+      <literallayout> 
+       ST_UID          シーケンス引数はシーケンス番号の代わりに UID を
含みます
+      </literallayout> 
+     </informalexample> 
+    </para> 
+   </refsect1> 
+  </refentry> 
+ 
   <refentry id="function.imap-close"> 
    <refnamediv> 
     <refname> imap_close</refname>
@@ -478,6 +590,32 @@
    </refsect1> 
   </refentry> 
 
+  <refentry id="function.imap-errors"> 
+   <refnamediv> 
+    <refname> imap_errors</refname>
+    <refpurpose> 
+     ページのリクエストの間かエラースタックがリセットされて以æ
¥
+     生じた全てのIMAPエラーを返す
+    </refpurpose> 
+   </refnamediv> 
+   <refsect1> 
+    <title> 説明</title>
+    <funcsynopsis> 
+     <funcprototype> 
+      <funcdef> array <function>imap_errors</function></funcdef>
+      <paramdef> void </paramdef>
+     </funcprototype> 
+    </funcsynopsis> 
+    <para> 
+     この関数は、最後に <function> imap_errors</function> コールを
+     行ってからまたはそのページの処理を開始してから
+     発生した全ての IMAP エラーメッセージの配列を返します。
+     <function> imap_errors</function> がコールされた場合、エラースタックã
¯
+     処理後にクリアされます。
+    </para> 
+   </refsect1> 
+  </refentry> 
+ 
   <refentry id="function.imap-expunge"> 
    <refnamediv> 
     <refname> imap_expunge</refname>
@@ -505,6 +643,125 @@
    </refsect1> 
   </refentry> 
 
+  <refentry id="function.imap-fetch-overview"> 
+   <refnamediv> 
+    <refname> imap_fetch_overview</refname>
+    <refpurpose> 
+     指定したメッセージのヘッダ情報の概要を読む
+    </refpurpose> 
+   </refnamediv> 
+   <refsect1> 
+    <title> 説明</title>
+    <funcsynopsis> 
+     <funcprototype> 
+      <funcdef> array <function>imap_fetch_overview</function></funcdef>
+      <paramdef> int <parameter>imap_stream</parameter></paramdef>
+      <paramdef> string <parameter>sequence</parameter></paramdef>
+     </funcprototype> 
+    </funcsynopsis> 
+    <para> 
+     この関数はメールヘッダを取得し、その内容の概要を返しますã€
‚
+     オブジェクトの配列を返します。
+     各ヘッダを次のように記述するオブジェクトの配列を返しますã€
‚
+     <itemizedlist> 
+      <listitem> 
+       <simpara> 
+        subject - メッセージの題名(subject)
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+        from - 送信者
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+        date - 送信日
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+        message_id - メッセージID 
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+        references - このメッセージIDへのリファレンス
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+        size - サイズ(バイト数)
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+        uid - メールボックスにおけるこのメッセージのUID
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+        msgno - メールボックスにおけるこのメッセージのメッセージ番
号
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+        recent - このメッセージのrecentフラグの有無
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+        flagged -  このメッセージのフラグの有無
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+        answered -  このメッセージの返信済フラグの有無
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+        deleted -  このメッセージの削除フラグの有無
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+        seen -  このメッセージの既読フラグの有無
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+        draft -  このメッセージのドラフトフラグの有無
+       </simpara> 
+      </listitem> 
+     </itemizedlist> 
+    </para> 
+    <para> 
+     <example> 
+      <title> <function>imap_fetch_overview</function> の例</title>
+      <programlisting role="php"> 
+$mbox = imap_open ("{your.imap.host:143}","username","password")
+     || die("can't connect: ".imap_last_error());
+ 
+$overview = imap_fetch_overview ($mbox,"2,4:6",0);
+ 
+if(is_array($overview)) {
+        reset($overview);
+        while( list($key,$val) = each($overview)) {
+                print     $val-> msgno
+                . " - " . $val-> date
+                . " - " . $val-> subject
+                . "\n";
+        }
+}
+ 
+imap_close ($mbox);
+      </programlisting> 
+     </example> 
+    </para> 
+   </refsect1> 
+  </refentry> 
+
   <refentry id="function.imap-fetchbody"> 
    <refnamediv> 
     <refname> imap_fetchbody</refname>
@@ -554,9 +811,49 @@
       </listitem> 
      </itemizedlist> 
     </para> 
+    <para> 
+     <function> imap_fetchstructure</function>も参照下さい。
+    </para> 
    </refsect1> 
   </refentry> 
 
+  <refentry id="function.imap-fetchheader"> 
+   <refnamediv> 
+    <refname> imap_fetchheader</refname>
+    <refpurpose> メッセージのヘッダを返す</refpurpose>
+   </refnamediv> 
+   <refsect1> 
+    <title> 説明</title>
+    <funcsynopsis> 
+     <funcprototype> 
+      <funcdef> string<function>imap_fetchheader</function></funcdef>
+      <paramdef> int <parameter>imap_stream</parameter></paramdef>
+      <paramdef> int <parameter>msgno</parameter></paramdef>
+      <paramdef> int <parameter>flags</parameter></paramdef>
+     </funcprototype> 
+    </funcsynopsis> 
+    <para> 
+     この関数は、指定したメッセージのヘッダーを完全でフィルタãƒ
¼ãƒªãƒ³ã‚°
+     されていない<ulink url="&url.rfc;rfc822.html"> RFC822</ulink>フォー
+     マットのテキスト文字列として取得し、テキスト文字列を返しã
¾ã™ã€‚
+    </para> 
+    <para> 
+     オプションは次のようになります。
+     <informalexample> 
+      <literallayout> 
+FT_UID          msgno 引数は UID である 
+FT_INTERNAL     返される文字列を "internal" フォーマットとする。
+                ただし、CRLF 改行は例外とする。
+FT_PREFETCHTEXT RFC822.TEXT は同時に事前に取得する必要があります。
+       これは、メッセージテキスト全体を取得したい場合にIMAP
+       接続において別の RTT を回避します。
+       (例えば、"ローカルファイルに保存する"操作)
+      </literallayout> 
+     </informalexample> 
+    </para> 
+   </refsect1> 
+  </refentry> 
+ 
   <refentry id="function.imap-fetchstructure"> 
    <refnamediv> 
     <refname> imap_fetchstructure</refname>
@@ -722,259 +1019,88 @@
        </tgroup> 
      </table> 
     </para> 
+    <para> 
+     <function> imap_fetchbody</function>も参照下さい。
+    </para> 
   </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-headerinfo"> 
+  <refentry id="function.imap-get-quota"> 
    <refnamediv> 
-    <refname> imap_headerinfo</refname>
-    <refpurpose> メッセージヘッダを読み込む</refpurpose>
+    <refname> imap_get_quota</refname>
+    <refpurpose> 
+     クオータレベルの設定、メールボックス毎の使用状況を取得すã‚
‹
+    </refpurpose> 
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> object <function>imap_headerinfo</function></funcdef>
+      <funcdef> array <function>imap_get_quota</function></funcdef>
       <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> int <parameter>msg_number</parameter></paramdef>
-      <paramdef> int 
-       <parameter> 
-	<replaceable> <optional>fromlength</optional></replaceable>
-       </parameter> 
-      </paramdef> 
-      <paramdef> int 
-       <parameter> 
-	<replaceable> <optional>subjectlength</optional></replaceable>
-       </parameter> 
-      </paramdef> 
-      <paramdef> string 
-        <parameter> 
-	<replaceable> <optional>defaulthost</optional></replaceable>
-       </parameter> 
-      </paramdef> 
+      <paramdef> string <parameter>quota_root</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
     <para> 
-    この関数は、様々なヘッダー要素を有するオブジェクトを返しま
す。
+     指定したメールボックスのlimitとusageをキーとした整数値を配列ã
¨ã—
+     て返します。limitの値は、このメールボックスで最大使用可能な
大きさ
+     を表します。usageの値は、このメールボックスの現在の使用状況
を示し
+     ます。失敗した場合に FALSE を返します。
     </para> 
-    <para>   
-     <informalexample> 
-      <literallayout> 
-        remail,date,Date,subject,Subject,in_reply_to,message_id,newsgroups,
-        followup_to,references
-
- message flags:
-   Unseen - 'U' if unseen, ' ' if seen
-   Answered - 'A' if answered, ' ' if unanswered
-   Deleted - 'D' if deleted, ' ' if not deleted
-   Draft - 'X' if draft, ' ' if not draft
-   Flagged - 'F' if flagged, ' ' if not flagged
-
- toaddress (to: 行?、最大 1024 文字)
- 
- to[] (TO 行から、以下の要素を含むオブジェクト配列を返します)
-    personal
-    adl
-    mailbox
-    host
- 
- fromaddress (from: 行全体、最大 1024 文字)
- 
- from[] (From 行から、以下の要素を含むオブジェクト配列を返します)
-    personal
-    adl
-    mailbox
-    host
- 
- ccaddress (cc: 行全体、最大 1024 文字)
- cc[] (Cc 行から、以下の要素を含むオブジェクト配列を返します)
-    personal
-    adl
-    mailbox
-    host
- 
- bccaddress (bcc: 行全体、最大 1024 文字)(full bcc line, up to 1024 characters)
- bcc[] (Bcc 行から、以下の要素を含むオブジェクト配列を返します)
-    personal
-    adl
-    mailbox
-    host
- 
- reply_toaddress (reply_to: 行全体、最大 1024 文字)
- reply_to[] (Reply_to 行から、以下の要素を含むオブジェクト配列を返し
ます)
-    personal
-    adl
-    mailbox
-    host
- 
- senderaddress (sender: 行全体、最大 1024 文字)
- sender[] (sender 行から、以下の要素を含むオブジェクト配列を返しまã
™)
-    personal
-    adl
-    mailbox
-    host
- 
- return_path (return-path: 行全体、最大 1024 文字)
- return_path[] (return_path 行から、以下の要素を含むオブジェクト配列を
返します)
-    personal
-    adl
-    mailbox
-    host
-  
- udate ( UNIX 時間で表した mail メッセージの日付)
-  
- fetchfrom (<parameter> fromlength</parameter> 文字に適合するようフォーマット
された from 行)
- fetchsubject (<parameter> subjectlength</parameter> 文字に適合するようフォーマ
ットされた subject 行)
-      </literallayout> 
-     </informalexample> 
+    <para> 
+     この関数は、現在、c-client2000 を使用しているユーザのみ使用可è
ƒ½ã§
+     す。
     </para> 
-   </refsect1> 
-  </refentry> 
-
-  <refentry id="function.imap-header"> 
-   <refnamediv> 
-    <refname> imap_header</refname>
-    <refpurpose> メッセージのヘッダを読む</refpurpose>
-   </refnamediv> 
-   <refsect1> 
-    <title> 説明</title>
-    <funcsynopsis> 
-     <funcprototype> 
-      <funcdef> object <function>imap_header</function></funcdef>
-      <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> int <parameter>msg_number</parameter></paramdef>
-      <paramdef> int 
-       <parameter> 
-	<replaceable> <optional>fromlength</optional></replaceable>
-       </parameter> 
-      </paramdef> 
-      <paramdef> int 
-       <parameter> 
-       <replaceable> <optional>subjectlength</optional></replaceable>
-       </parameter> 
-      </paramdef> 
-      <paramdef> string 
-       <parameter> 
-	<replaceable> <optional>defaulthost</optional></replaceable>
-       </parameter> 
-      </paramdef> 
-     </funcprototype> 
-    </funcsynopsis> 
     <para> 
-     この関数は、<function> imap_headerinfo</function>へのエイリアスで
-     あり、全く同様に動作します。
+     <parameter> imap_stream</parameter> は、
+     <function> imap_status</function>から返された値とする必要がありま
+     す。クオータ関数を使用するには、このストリームをメール管ç
†è€…とし
+     てオープンする必要があります。<parameter> quota_root</parameter>
+     は、通常、user.name という形式にする必要があります。ただし、n
ame
+     は情報を取得したいメールボックスの名前です。
     </para> 
-   </refsect1> 
-  </refentry> 
-
-  <refentry id="function.imap-rfc822-parse-headers"> 
-   <refnamediv> 
-    <refname> imap_rfc822_parse_headers</refname>
-    <refpurpose> 文字列からメールヘッダを解釈する</refpurpose>
-   </refnamediv> 
-   <refsect1> 
-    <title> 説明</title>
-    <funcsynopsis> 
-     <funcprototype> 
-      <funcdef> object <function>imap_rfc822_parse_headers</function></funcdef>
-      <paramdef> string <parameter>headers</parameter></paramdef>
-      <paramdef> string 
-       <parameter> 
-	<replaceable> <optional>defaulthost</optional></replaceable>
-       </parameter> 
-      </paramdef> 
-     </funcprototype> 
-    </funcsynopsis> 
     <para> 
-     この関数は複数のヘッダ要素を有するオブジェクトを返しますã€
‚
-     この関数は<function> imap_header</function>に似ていますが、
-     フラグおよび他の要素はIMAPサーバーから取得されるところが異ã
ªã‚Šã¾ã™ã€‚
+     <example> 
+      <title> <function>imap_get_quota</function>の例</title>
+      <programlisting role="php"> 
+$mbox = imap_open("{your.imap.host}","mailadmin","password",OP_HALFOPEN)
+      || die("接続できません: ".imap_last_error());
+ 
+$quota_value = imap_get_quota($mbox, "user.kalowsky");
+if(is_array($quota_value)) {
+    print "Usage level is: " . $quota_value['usage'];
+    print "Limit level is: " . $quota_value['limit'];
+} 
+ 
+imap_close($mbox); 
+      </programlisting> 
+     </example> 
+    </para> 
+    <para> 
+     <function> imap_open</function>,
+     <function> imap_set_quota</function> も参照下さい。
     </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-headers"> 
+  <refentry id="function.imap-getmailboxes"> 
    <refnamediv> 
-    <refname> imap_headers</refname>
+    <refname> imap_getmailboxes</refname>
     <refpurpose> 
-     メールボックス内の、すべてのメッセージのヘッダを返す
+     メールボックスのリストを読み込み、各ボックスに関する詳細ã
ªæƒ…報を返す
     </refpurpose> 
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> array <function>imap_headers</function></funcdef>
+      <funcdef> array <function>imap_getmailboxes</function></funcdef>
       <paramdef> int <parameter>imap_stream</parameter></paramdef>
+      <paramdef> string <parameter>ref</parameter></paramdef>
+      <paramdef> string <parameter>pattern</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
     <para> 
-     ヘッダ情報でフォーマットされた文字列の配列を返します。1 つ
の
-     メールメッセージ毎に 1 つの要素が格納されます。
-    </para> 
-   </refsect1> 
-  </refentry> 
-
-  <refentry id="function.imap-listmailbox"> 
-   <refnamediv> 
-    <refname> imap_listmailbox</refname>
-    <refpurpose> メールボックスのリストを読む</refpurpose>
-   </refnamediv> 
-   <refsect1> 
-    <title> 説明</title>
-    <funcsynopsis> 
-     <funcprototype> 
-      <funcdef> array <function>imap_listmailbox</function></funcdef>
-      <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> string <parameter>ref</parameter></paramdef>
-      <paramdef> string <parameter>pattern</parameter></paramdef>
-     </funcprototype> 
-    </funcsynopsis> 
-    <para> 
-     メールボックス名を保持する配列を返します。
-     <parameter> ref</parameter>および<parameter>pattern</parameter>
-     の説明については、<function> imap_getmailboxes</function>を参照下さい。
-    </para> 
-    <para> 
-     <example> 
-      <title> <function>imap_listmailbox</function> の例</title>
-      <programlisting role="php"> 
-$mbox = imap_open("{your.imap.host}","username","password",OP_HALFOPEN)
-      || die("can't connect: ".imap_last_error());
- 
-$list = imap_listmailbox($mbox,"{your.imap.host}","*");
-if(is_array($list)) {
-  reset($list);
-  while (list($key, $val) = each($list))
-    print imap_utf7_decode($val)."&lt;br> \n";
-} else
-  print "imap_listmailbox failed: ".imap_last_error()."\n";
- 
-imap_close($mbox);                                                                
-      </programlisting> 
-     </example> 
-    </para> 
-   </refsect1> 
-  </refentry> 
-
-  <refentry id="function.imap-getmailboxes"> 
-   <refnamediv> 
-    <refname> imap_getmailboxes</refname>
-    <refpurpose> 
-     メールボックスのリストを読み込み、各ボックスに関する詳細ã
ªæƒ…報を返す
-    </refpurpose> 
-   </refnamediv> 
-   <refsect1> 
-    <title> 説明</title>
-    <funcsynopsis> 
-     <funcprototype> 
-      <funcdef> array <function>imap_getmailboxes</function></funcdef>
-      <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> string <parameter>ref</parameter></paramdef>
-      <paramdef> string <parameter>pattern</parameter></paramdef>
-     </funcprototype> 
-    </funcsynopsis> 
-    <para> 
     メールボックス情報を有するオブジェクトの配列を返します。各
オブジェクトは、
     メールボックスの完全な名前である <parameter> name</parameter>、
     このメールボックスの階層の区切りを示す属性<parameter> delimiter</pa
rameter> 、
@@ -1057,88 +1183,6 @@
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-get-quota"> 
-   <refnamediv> 
-    <refname> imap_get_quota</refname>
-    <refpurpose> 
-     クオータレベルの設定、メールボックス毎の使用状況を取得すã‚
‹
-    </refpurpose> 
-   </refnamediv> 
-   <refsect1> 
-    <title> 説明</title>
-    <funcsynopsis> 
-     <funcprototype> 
-      <funcdef> array <function>imap_get_quota</function></funcdef>
-      <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> string <parameter>quota_root</parameter></paramdef>
-     </funcprototype> 
-    </funcsynopsis> 
-    <para> 
-     指定したメールボックスのlimitとusageをキーとした整数値を配列ã
¨ã—
-     て返します。limitの値は、このメールボックスで最大使用可能な
大きさ
-     を表します。usageの値は、このメールボックスの現在の使用状況
を示し
-     ます。失敗した場合に FALSE を返します。
-    </para> 
-    <para> 
-     この関数は、現在、c-client2000 を使用しているユーザのみ使用可è
ƒ½ã§
-     す。
-    </para> 
-    <para> 
-     <parameter> imap_stream</parameter> は、
-     <function> imap_status</function>から返された値とする必要がありま
-     す。クオータ関数を使用するには、このストリームをメール管ç
†è€…とし
-     てオープンする必要があります。<parameter> quota_root</parameter>
-     は、通常、user.name という形式にする必要があります。ただし、n
ame
-     は情報を取得したいメールボックスの名前です。
-    </para> 
-    <para> 
-     <example> 
-      <title> <function>imap_get_quota</function>の例</title>
-      <programlisting role="php"> 
-$mbox = imap_open("{your.imap.host}","mailadmin","password",OP_HALFOPEN)
-      || die("接続できません: ".imap_last_error());
- 
-$quota_value = imap_get_quota($mbox, "user.kalowsky");
-if(is_array($quota_value)) {
-    print "Usage level is: " . $quota_value['usage'];
-    print "Limit level is: " . $quota_value['limit'];
-} 
- 
-imap_close($mbox); 
-      </programlisting> 
-     </example> 
-    </para> 
-    <para> 
-     <function> imap_open</function>,
-     <function> imap_set_quota</function> も参照下さい。
-    </para> 
-   </refsect1> 
-  </refentry> 
-
-  <refentry id="function.imap-listsubscribed"> 
-   <refnamediv> 
-    <refname> imap_listsubscribed</refname>
-    <refpurpose> 購読中のすべてのメールボックス一覧</refpurpose>
-   </refnamediv> 
-   <refsect1> 
-    <title> 説明</title>
-    <funcsynopsis> 
-     <funcprototype> 
-      <funcdef> array <function>imap_listsubscribed</function></funcdef>
-      <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> string <parameter>ref</parameter></paramdef>
-      <paramdef> string <parameter>pattern</parameter></paramdef>
-     </funcprototype> 
-    </funcsynopsis> 
-    <para> 
-     購読中のすべてのメールボックスの配列を返します。
-     この関数はほぼ<function> imap_listmailbox</function>と同じですが、
-     自分がログインしているユーザーが購読中のメールボックスのã
¿ã‚’
-     返します。
-    </para> 
-   </refsect1> 
-  </refentry> 
-
   <refentry id="function.imap-getsubscribed"> 
    <refnamediv> 
     <refname> imap_getsubscribed</refname>
@@ -1161,1027 +1205,1082 @@
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-mail-copy"> 
+  <refentry id="function.imap-header"> 
    <refnamediv> 
-    <refname> imap_mail_copy</refname>
-    <refpurpose> 指定されたメッセージをメールボックスにコピーする
-    </refpurpose> 
+    <refname> imap_header</refname>
+    <refpurpose> メッセージのヘッダを読む</refpurpose>
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> int <function>imap_mail_copy</function></funcdef>
+      <funcdef> object <function>imap_header</function></funcdef>
       <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> string <parameter>msglist</parameter></paramdef>
-      <paramdef> string <parameter>mbox</parameter></paramdef>
+      <paramdef> int <parameter>msg_number</parameter></paramdef>
       <paramdef> int 
        <parameter> 
-        <replaceable> <optional>flags</optional></replaceable>
+	<replaceable> <optional>fromlength</optional></replaceable>
+       </parameter> 
+      </paramdef> 
+      <paramdef> int 
+       <parameter> 
+       <replaceable> <optional>subjectlength</optional></replaceable>
+       </parameter> 
+      </paramdef> 
+      <paramdef> string 
+       <parameter> 
+	<replaceable> <optional>defaulthost</optional></replaceable>
        </parameter> 
       </paramdef> 
      </funcprototype> 
     </funcsynopsis> 
-    <para> 
-     成功するとtrue、失敗するとfalseを返します。
-    </para> 
     <para> 
-     <parameter> msglist</parameter> で指定されたメッセージを、指定した
-     メールボックスにコピーします。<parameter> msglist</parameter> は、
-     (<ulink url="&url.rfc;rfc2060.html"> RFC2060</ulink>に記述されたよ
-     うに)ただのメッセージ番号ではなく、範囲を示します。
-    </para> 
-    <para>  
-     flags はビットマスクであり、以下の組み合わせです。
-     <itemizedlist> 
-      <listitem> 
-       <simpara> 
- 	CP_UID - UIDS を含む処理の数
-       </simpara> 
-      </listitem> 
-      <listitem> 
-       <simpara> 
- 	CP_MOVE - コピー後にメールボックスからメッセージを削除
-       </simpara> 
-      </listitem> 
-     </itemizedlist> 
+     この関数は、<function> imap_headerinfo</function>へのエイリアスで
+     あり、全く同様に動作します。
     </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-mail-move"> 
+  <refentry id="function.imap-headerinfo"> 
    <refnamediv> 
-    <refname> imap_mail_move</refname>
-    <refpurpose> 
-     指定されたメッセージをメールボックスに移動する
-    </refpurpose> 
+    <refname> imap_headerinfo</refname>
+    <refpurpose> メッセージヘッダを読み込む</refpurpose>
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> int <function>imap_mail_move</function></funcdef>
+      <funcdef> object <function>imap_headerinfo</function></funcdef>
       <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> string <parameter>msglist</parameter></paramdef>
-      <paramdef> string <parameter>mbox</parameter></paramdef>
+      <paramdef> int <parameter>msg_number</parameter></paramdef>
       <paramdef> int 
        <parameter> 
-        <replaceable> <optional>flags</optional></replaceable>
+	<replaceable> <optional>fromlength</optional></replaceable>
+       </parameter> 
+      </paramdef> 
+      <paramdef> int 
+       <parameter> 
+	<replaceable> <optional>subjectlength</optional></replaceable>
+       </parameter> 
+      </paramdef> 
+      <paramdef> string 
+        <parameter> 
+	<replaceable> <optional>defaulthost</optional></replaceable>
        </parameter> 
       </paramdef> 
      </funcprototype> 
     </funcsynopsis> 
-    <para>   
-     <parameter> msglist</parameter> で指定されたメッセージを、指定された
-     メールボックスに移動します。<parameter> msglist</parameter> は
-     単なるメッセージ番号でなく、
-     (<ulink url="&url.rfc;rfc2060.html"> RFC2060</ulink>で解説された)
-     メッセージの範囲を指定します。
-    </para> 
-    <para> 
-     flagsはビットマスクであり、指定できるオプションは1つだけでã
™ã€‚
-     <itemizedlist> 
-      <listitem> 
-       <simpara> 
-	CP_UID - シーケンス番号にUIDを含む
-       </simpara> 
-      </listitem> 
-     </itemizedlist> 
-    </para> 
     <para> 
-     成功するとtrue、失敗するとfalseを返します。
+    この関数は、様々なヘッダー要素を有するオブジェクトを返しま
す。
     </para> 
-   </refsect1> 
-  </refentry> 
+    <para>   
+     <informalexample> 
+      <literallayout> 
+        remail,date,Date,subject,Subject,in_reply_to,message_id,newsgroups,
+        followup_to,references
 
-  <refentry id="function.imap-num-msg"> 
-   <refnamediv> 
-    <refname> imap_num_msg</refname>
-    <refpurpose> 
-     現在のメールボックスのメッセージ数を取得する
-    </refpurpose> 
-   </refnamediv> 
-   <refsect1> 
-    <title> 説明</title>
-    <funcsynopsis> 
-     <funcprototype> 
-      <funcdef> int <function>imap_num_msg</function></funcdef>
-      <paramdef> int <parameter>stream_id</parameter></paramdef>
-     </funcprototype> 
-    </funcsynopsis> 
-    <para> 
-     現在のメールボックスにあるメッセージ数を返します。
-    </para> 
-   </refsect1> 
-  </refentry> 
+ message flags:
+   Unseen - 'U' if unseen, ' ' if seen
+   Answered - 'A' if answered, ' ' if unanswered
+   Deleted - 'D' if deleted, ' ' if not deleted
+   Draft - 'X' if draft, ' ' if not draft
+   Flagged - 'F' if flagged, ' ' if not flagged
 
+ toaddress (to: 行?、最大 1024 文字)
+ 
+ to[] (TO 行から、以下の要素を含むオブジェクト配列を返します)
+    personal
+    adl
+    mailbox
+    host
+ 
+ fromaddress (from: 行全体、最大 1024 文字)
+ 
+ from[] (From 行から、以下の要素を含むオブジェクト配列を返します)
+    personal
+    adl
+    mailbox
+    host
+ 
+ ccaddress (cc: 行全体、最大 1024 文字)
+ cc[] (Cc 行から、以下の要素を含むオブジェクト配列を返します)
+    personal
+    adl
+    mailbox
+    host
+ 
+ bccaddress (bcc: 行全体、最大 1024 文字)(full bcc line, up to 1024 characters)
+ bcc[] (Bcc 行から、以下の要素を含むオブジェクト配列を返します)
+    personal
+    adl
+    mailbox
+    host
+ 
+ reply_toaddress (reply_to: 行全体、最大 1024 文字)
+ reply_to[] (Reply_to 行から、以下の要素を含むオブジェクト配列を返し
ます)
+    personal
+    adl
+    mailbox
+    host
+ 
+ senderaddress (sender: 行全体、最大 1024 文字)
+ sender[] (sender 行から、以下の要素を含むオブジェクト配列を返しまã
™)
+    personal
+    adl
+    mailbox
+    host
+ 
+ return_path (return-path: 行全体、最大 1024 文字)
+ return_path[] (return_path 行から、以下の要素を含むオブジェクト配列を
返します)
+    personal
+    adl
+    mailbox
+    host
+  
+ udate ( UNIX 時間で表した mail メッセージの日付)
+  
+ fetchfrom (<parameter> fromlength</parameter> 文字に適合するようフォーマット
された from 行)
+ fetchsubject (<parameter> subjectlength</parameter> 文字に適合するようフォーマ
ットされた subject 行)
+      </literallayout> 
+     </informalexample> 
+    </para> 
+   </refsect1> 
+  </refentry> 
 
-  <refentry id="function.imap-num-recent"> 
+  <refentry id="function.imap-headers"> 
    <refnamediv> 
-    <refname> imap_num_recent</refname>
-    <refpurpose> 現在のメールボックスにある新規メッセージの数の取得
</refpurpose> 
+    <refname> imap_headers</refname>
+    <refpurpose> 
+     メールボックス内の、すべてのメッセージのヘッダを返す
+    </refpurpose> 
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> int <function>imap_num_recent</function></funcdef>
+      <funcdef> array <function>imap_headers</function></funcdef>
       <paramdef> int <parameter>imap_stream</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
     <para> 
-     現在のメールボックスにある新しいメッセージの数を返しますã€
‚
+     ヘッダ情報でフォーマットされた文字列の配列を返します。1 つ
の
+     メールメッセージ毎に 1 つの要素が格納されます。
     </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-open"> 
+  <refentry id="function.imap-last-error"> 
    <refnamediv> 
-    <refname> imap_open</refname>
+    <refname> imap_last_error</refname>
     <refpurpose> 
-     メールボックスへのIMAPストリームをオープンする
+     ページリクエスト時に生じた直近の IMAP エラーを返す
     </refpurpose> 
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> int <function>imap_open</function></funcdef>
-      <paramdef> string <parameter>mailbox</parameter></paramdef>
-      <paramdef> string <parameter>username</parameter></paramdef>
-      <paramdef> string <parameter>password</parameter></paramdef>
-      <paramdef> int 
-       <parameter> 
-	<replaceable> <optional>flags</optional></replaceable>
-       </parameter> 
-      </paramdef> 
+      <funcdef> string <function>imap_last_error</function></funcdef>
+      <paramdef> void </paramdef>
      </funcprototype> 
     </funcsynopsis> 
-    <para> 
-     成功するとIMAPストリームを返し、失敗するとfalseを返します。ã
“の関
-     数は、POP3やNNTPサーバーへのストリームをオープンする際にも使
用可
-     能です。しかし、いくつかの関数および機能はIMAPサーバーではå
ˆ©ç”¨ã§
-     きません。
-    </para> 
     <para> 
-     メールボックス名(mailbox)は、サーバー名の部分と使用するサーãƒ
ãƒ¼ã«
-     おけるメールボックスへのパスから構成されます。特別な名前IN
BOXは、
-     カレントのユーザの個人メールボックスを意味します。サーバãƒ
¼éƒ¨ã¯'{'
-     および'}'で括られ、サーバー名またはIPアドレス、('/'で始まる)ã
ƒ—ロ
-     トコル指定、そして':'から始まるオプションのポート指定子かã‚
‰æ§‹æˆã•
-     れます。サーバー部は、全てのmailboxパラメータで必須です。
-     ASCII空間で出力可能な文字以外の外国文字を含むメールボックス
名は
-     <function> imap_utf7_encode</function>でエンコードする必要がありま
-     す。
+     この関数は、カレントページに生じた直近のIMAPエラーメッセーã
‚¸ã®
+     全文を返します。エラースタックは変更されません。
+     <function> imap_last_error</function> を続けてコールした際、
+     コール間に新規エラーが生じていない場合は、同じエラーが返ã
•ã‚Œã¾ã™ã€‚
     </para> 
+   </refsect1> 
+  </refentry> 
+  
+  <refentry id="function.imap-listmailbox"> 
+   <refnamediv> 
+    <refname> imap_listmailbox</refname>
+    <refpurpose> メールボックスのリストを読む</refpurpose>
+   </refnamediv> 
+   <refsect1> 
+    <title> 説明</title>
+    <funcsynopsis> 
+     <funcprototype> 
+      <funcdef> array <function>imap_listmailbox</function></funcdef>
+      <paramdef> int <parameter>imap_stream</parameter></paramdef>
+      <paramdef> string <parameter>ref</parameter></paramdef>
+      <paramdef> string <parameter>pattern</parameter></paramdef>
+     </funcprototype> 
+    </funcsynopsis> 
     <para> 
-     オプションは、ビットマスクであり、以下の組み合わせとなりã
¾ã™ã€‚
-     <itemizedlist> 
-      <listitem> 
-       <simpara> 
-	OP_READONLY - メールボックスを読みこみのみ可でオープン
-       </simpara> 
-      </listitem> 
-      <listitem> 
-       <simpara> 
-	OP_ANONYMOUS - news に関して.newsrcの使用・更新をしない(NNTPのみ)
-       </simpara> 
-      </listitem> 
-      <listitem> 
-       <simpara> 
-	OP_HALFOPEN - IMAPおよびNNTP名について、接続をオープンするがメールãƒ
œãƒƒã‚¯ã‚¹ã‚’オープンしない
-       </simpara> 
-      </listitem> 
-      <listitem> 
-       <simpara> 
-	CL_EXPUNGE - メールボックスを閉じた際に、自動的にメールボックスã‚
’削除する
-       </simpara> 
-      </listitem> 
-     </itemizedlist> 
+     メールボックス名を保持する配列を返します。
+     <parameter> ref</parameter>および<parameter>pattern</parameter>
+     の説明については、<function> imap_getmailboxes</function>を参照下さい。
     </para> 
     <para> 
-     ローカルマシンのポート143で実行しているIMAPサーバーに接続
-     する際には、以下のようにします。
-     <informalexample> 
+     <example> 
+      <title> <function>imap_listmailbox</function> の例</title>
       <programlisting role="php"> 
-$mbox = imap_open ("{localhost:143}INBOX","user_id","password");
-      </programlisting> 
-     </informalexample> 
-      ローカルマシンのポート110で実行しているPOP3サーバーに接続す
る際には、
-     以下のようにします。
-     <informalexample> 
-      <programlisting> 
-$mbox = imap_open ("{localhost/pop3:110}INBOX","user_id","password");
-      </programlisting> 
-     </informalexample> 
-     ローカルマシンのポート119で実行しているNNTPサーバーに接続すã
‚‹éš›ã«ã¯ã€
-     以下のようにします。
-     <informalexample> 
-      <programlisting> 
-$nntp = imap_open ("{localhost/nntp:119}comp.test","","");
+$mbox = imap_open("{your.imap.host}","username","password",OP_HALFOPEN)
+      || die("can't connect: ".imap_last_error());
+ 
+$list = imap_listmailbox($mbox,"{your.imap.host}","*");
+if(is_array($list)) {
+  reset($list);
+  while (list($key, $val) = each($list))
+    print imap_utf7_decode($val)."&lt;br> \n";
+} else
+  print "imap_listmailbox failed: ".imap_last_error()."\n";
+ 
+imap_close($mbox);                                                                
       </programlisting> 
-     </informalexample> 
-     リモートサーバーに接続するには、"localhost" を接続したいサーãƒ
ãƒ¼ã®
-     名前または IP アドレスに代えてください。
+     </example> 
     </para> 
-    <para> 
-     <example> 
-      <title> <function>imap_open</function>の例</title>
-      <programlisting> 
-$mbox = imap_open("{your.imap.host:143}","username","password");
-
-echo "&lt;p&gt;&lt;h1&gt;Mailboxes&lt;/h1&gt;\n";
-$folders = imap_listmailbox($mbox, "{your.imap.host:143}", "*");
-if($folders == false)
-  echo "Call failed&lt;br&gt;\n";
-else
-  while(list($key,$val) = each($folders))
-    echo $val."&lt;br&gt;\n";
+   </refsect1> 
+  </refentry> 
 
-echo "&lt;p&gt;&lt;h1&gt;Headers in INBOX&lt;/h1&gt;\n";
-$headers = imap_headers($mbox);
-if($headers == false)
-  echo "Call failed&lt;br&gt;\n";
-else
-  while(list($key,$val) = each($headers))
-    echo $val."&lt;br&gt;\n";
+  <refentry id="function.imap-listsubscribed"> 
+   <refnamediv> 
+    <refname> imap_listsubscribed</refname>
+    <refpurpose> 購読中のすべてのメールボックス一覧</refpurpose>
+   </refnamediv> 
+   <refsect1> 
+    <title> 説明</title>
+    <funcsynopsis> 
+     <funcprototype> 
+      <funcdef> array <function>imap_listsubscribed</function></funcdef>
+      <paramdef> int <parameter>imap_stream</parameter></paramdef>
+      <paramdef> string <parameter>ref</parameter></paramdef>
+      <paramdef> string <parameter>pattern</parameter></paramdef>
+     </funcprototype> 
+    </funcsynopsis> 
+    <para> 
+     購読中のすべてのメールボックスの配列を返します。
+     この関数はほぼ<function> imap_listmailbox</function>と同じですが、
+     自分がログインしているユーザーが購読中のメールボックスのã
¿ã‚’
+     返します。
+    </para> 
+   </refsect1> 
+  </refentry> 
 
-imap_close($mbox);
-      </programlisting> 
-     </example> 
+  <refentry id="function.imap-mail"> 
+   <refnamediv> 
+    <refname> imap_mail</refname>
+    <refpurpose> 
+     e-mailメッセージを送信する
+    </refpurpose> 
+   </refnamediv> 
+   <refsect1> 
+    <title> 説明</title>
+    <funcsynopsis> 
+     <funcprototype> 
+      <funcdef> string <function>imap_mail</function></funcdef>
+      <paramdef> string <parameter>to</parameter></paramdef>
+      <paramdef> string <parameter>subject</parameter></paramdef>
+      <paramdef> string <parameter>message</parameter></paramdef>
+      <paramdef> string 
+       <parameter> 
+	<replaceable> <optional>additional_headers</optional></replaceable>
+       </parameter> 
+      </paramdef> 
+      <paramdef> string 
+       <parameter> 
+	<replaceable> <optional>cc</optional></replaceable>
+       </parameter> 
+      </paramdef> 
+      <paramdef> string 
+       <parameter> 
+	<replaceable> <optional>bcc</optional></replaceable>
+       </parameter> 
+      </paramdef> 
+      <paramdef> string 
+       <parameter> 
+	<replaceable> <optional>rpath</optional></replaceable>
+       </parameter> 
+      </paramdef> 
+     </funcprototype> 
+    </funcsynopsis> 
+    <para> 
+     この関数は、現在、PHP 3でのみ利用可能です。
     </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-ping"> 
+  <refentry id="function.imap-mail-compose"> 
    <refnamediv> 
-    <refname> imap_ping</refname>
-    <refpurpose> IMAP ストリームの有効性チェック</refpurpose>
+    <refname> imap_mail_compose</refname>
+    <refpurpose> 
+     指定したエンベロープおよびボディーセクションに基づきMIMEメã
ƒƒã‚»ãƒ¼
+     ジを作成
+    </refpurpose> 
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> int <function>imap_ping</function></funcdef>
-      <paramdef> int <parameter>imap_stream</parameter></paramdef>
+      <funcdef> string <function>imap_mail_compose</function></funcdef>
+      <paramdef> array <parameter>envelope</parameter></paramdef>
+      <paramdef> array <parameter>body</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
     <para> 
-     ストリームがまだ有効であればtrueを、そうでなければfalseã‚’è¿”ã
—ます。
     </para> 
     <para> 
-     <function> imap_ping</function> 関数は、ストリームに ping を行い、
-     まだ有効であるかどうかをチェックします。これにより新しいãƒ
¡ãƒ¼ãƒ«ã®åˆ°ç€
-     を知る場合もあります。これは、有効時間のタイムアウトが設å®
š
-     してあるサーバに対して "接続を持続させる" ことに加え、定期ç
š„な
-     "新着メールのチェック" としてもよい方法です。
-     (PHPスクリプトはこれほどの長時間実行されることはほとんどなã
„ので、
-     この関数が実際に役に立つかどうかは定かではありません。)
+     <example> 
+      <title> <function>imap_mail_compose</function> の例</title>
+      <programlisting role="php"> 
+&lt;?php
+
+$envelope["from"]="musone@afterfive.com";
+$envelope["to"]="musone@darkstar";
+$envelope["cc"]="musone@edgeglobal.com";
+
+$part1["type"]=TYPEMULTIPART;
+$part1["subtype"]="mixed";
+
+$filename="/tmp/imap.c.gz";
+$fp=fopen($filename,"r");
+$contents=fread($fp,filesize($filename));
+fclose($fp);
+
+$part2["type"]=TYPEAPPLICATION;
+$part2["encoding"]=ENCBINARY;
+$part2["subtype"]="octet-stream";
+$part2["description"]=basename($filename);
+$part2["contents.data"]=$contents;
+
+$part3["type"]=TYPETEXT;
+$part3["subtype"]="plain";
+$part3["description"]="description3";
+$part3["contents.data"]="contents.data3\n\n\n\t";
+
+$body[1]=$part1;
+$body[2]=$part2;
+$body[3]=$part3;
+
+echo nl2br(imap_mail_compose($envelope,$body));
+
+?&gt;
+      </programlisting> 
+     </example> 
     </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-renamemailbox"> 
+  <refentry id="function.imap-mail-copy"> 
    <refnamediv> 
-    <refname> imap_renamemailbox</refname>
-    <refpurpose> メールボックスの名前を変更する</refpurpose>
+    <refname> imap_mail_copy</refname>
+    <refpurpose> 指定されたメッセージをメールボックスにコピーする
+    </refpurpose> 
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> int <function>imap_renamemailbox</function></funcdef>
+      <funcdef> int <function>imap_mail_copy</function></funcdef>
       <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> string <parameter>old_mbox</parameter></paramdef>
-      <paramdef> string <parameter>new_mbox</parameter></paramdef>
+      <paramdef> string <parameter>msglist</parameter></paramdef>
+      <paramdef> string <parameter>mbox</parameter></paramdef>
+      <paramdef> int 
+       <parameter> 
+        <replaceable> <optional>flags</optional></replaceable>
+       </parameter> 
+      </paramdef> 
      </funcprototype> 
     </funcsynopsis> 
-    <para>   
-     この関数は、古いメールボックスを新しいメールボックスにリãƒ
ãƒ¼ãƒ 
-     します。 (<parameter> mbox</parameter>名のフォーマットについては
-     <function> imap_open</function>を参照下さい)
-    </para> 
     <para> 
      成功するとtrue、失敗するとfalseを返します。
     </para> 
     <para> 
-     <parameter> mbox</parameter>のフォーマットについては、
-     <function> imap_createmailbox</function>,
-     <function> imap_deletemailbox</function>,
-     <function> imap_open</function>も参照下さい。
+     <parameter> msglist</parameter> で指定されたメッセージを、指定した
+     メールボックスにコピーします。<parameter> msglist</parameter> は、
+     (<ulink url="&url.rfc;rfc2060.html"> RFC2060</ulink>に記述されたよ
+     うに)ただのメッセージ番号ではなく、範囲を示します。
+    </para> 
+    <para>  
+     flags はビットマスクであり、以下の組み合わせです。
+     <itemizedlist> 
+      <listitem> 
+       <simpara> 
+ 	CP_UID - UIDS を含む処理の数
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+ 	CP_MOVE - コピー後にメールボックスからメッセージを削除
+       </simpara> 
+      </listitem> 
+     </itemizedlist> 
     </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-reopen"> 
+  <refentry id="function.imap-mail-move"> 
    <refnamediv> 
-    <refname> imap_reopen</refname>
-    <refpurpose> 新規メールボックスへのIMAP ストリームを再度オープンã
™ã‚‹
+    <refname> imap_mail_move</refname>
+    <refpurpose> 
+     指定されたメッセージをメールボックスに移動する
     </refpurpose> 
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> int <function>imap_reopen</function></funcdef>
+      <funcdef> int <function>imap_mail_move</function></funcdef>
       <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> string <parameter>mailbox</parameter></paramdef>
-      <paramdef> string
+      <paramdef> string <parameter>msglist</parameter></paramdef>
+      <paramdef> string <parameter>mbox</parameter></paramdef>
+      <paramdef> int 
        <parameter> 
-	<replaceable> <optional>flags</optional></replaceable>
+        <replaceable> <optional>flags</optional></replaceable>
        </parameter> 
       </paramdef> 
      </funcprototype> 
     </funcsynopsis> 
-    <para> 
-     成功するとtrue、失敗するとfalseを返します。
-    </para> 
     <para>   
-     この関数は、IMAPまたはNNTPサーバー上の新しいメールボックスに
対して
-     指定されたストリームを再オープンします。
+     <parameter> msglist</parameter> で指定されたメッセージを、指定された
+     メールボックスに移動します。<parameter> msglist</parameter> は
+     単なるメッセージ番号でなく、
+     (<ulink url="&url.rfc;rfc2060.html"> RFC2060</ulink>で解説された)
+     メッセージの範囲を指定します。
     </para> 
     <para> 
-     オプションは、ビットマスクであり、以下の組み合わせとなりã
¾ã™ã€‚
+     flagsはビットマスクであり、指定できるオプションは1つだけでã
™ã€‚
      <itemizedlist> 
       <listitem> 
-       <simpara> 
- 	OP_READONLY - メールボックスを読みこみのみ可でオープン
-       </simpara> 
-      </listitem> 
-      <listitem> 
-       <simpara> 
- 	OP_ANONYMOUS - news に関して .newsrc の使用・更新をしない (NNTPのみ)
-       </simpara> 
-      </listitem> 
-      <listitem> 
        <simpara> 
- 	OP_HALFOPEN - IMAP および NNTP 名について、接続をオープンするが
-	              メールボックスをオープンしない
-       </simpara> 
-      </listitem> 
-      <listitem> 
-       <simpara> 
- 	CL_EXPUNGE - メールボックスを閉じた際に、自動的にメールボック
- 	スを削除する (<function> imap_delete</function>および
-	<function> imap_expunge</function>も参照下さい )
+	CP_UID - シーケンス番号にUIDを含む
        </simpara> 
       </listitem> 
      </itemizedlist> 
     </para> 
     <para> 
-     成功時にtrue、エラー時にfalseを返します。
+     成功するとtrue、失敗するとfalseを返します。
     </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-set-quota"> 
+  <refentry id="function.imap-mailboxmsginfo"> 
    <refnamediv> 
-    <refname> imap_set_quota</refname>
-    <refpurpose> 指定したメールボックスにクオータを設定する</refpurpose
> 
+    <refname> imap_mailboxmsginfo</refname>
+    <refpurpose> 現在のメールボックスに関する情報を得る</refpurpose>
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> int <function>imap_set_quota</function></funcdef>
+      <funcdef> array <function>imap_mailboxmsginfo</function></funcdef>
       <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> string <parameter>quota_root</parameter></paramdef>
-      <paramdef> int <parameter>quota_limit</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
-    <para>   
-     メールボックス単位でクオータ上限(最大容量)を設定します。こ
の関数
-     は、メール管理者のアカウントでオープンされている
-     <parameter> imap_stream</parameter> を必要とします。他のユーザでオー
-     プンされている場合は、この関数は動作しません。
-    </para> 
     <para> 
-     この関数は、c-client2000ライブラリのユーザのみ使用可能です。
+     現在のメールボックスに関する情報を返します。
+     失敗した場合にfalseを返します。
     </para> 
-    <para> 
-    <parameter> imap_stream</parameter> は、
-     <function> imap_open</function>コール時に返されたストリームポイン
-     タです。このストリームはメール管理者としてオープンする必è¦
ãŒã‚ã‚Š
-     ます。そうでない場合は、この関数は動作しません。
-     <parameter> quota_root</parameter> は、クオータを設定するメールボッ
-     クスです。これは、メールボックスのIMAP標準フォーマット
-     'user.name' に基づき指定する必要があります。
-     <parameter> quota_limit</parameter> は、
-     <parameter> quota_root</parameter> の最大サイズ(KB単位)です。
+    <para>   
+     <function> imap_mailboxmsginfo</function> 関数は、
+     サーバーにおける現在のメールボックスのステータスを調べ、
+     次のプロパティを有するオブジェクトの情報を返します。
+     この関数は<function> imap_status</function>に似ていますが、
+     メールボックスの中の全てのメッセージのサイズを合計しますã€
‚
+     このため、実行時間は幾分余計にかかります。
     </para> 
     <para> 
-     成功時にtrue、エラー時にfalseを返します。
+     <table> 
+      <title> mailboxのプロパティ</title>
+      <tgroup cols="2"> 
+       <tbody> 
+         <row> 
+	 <entry> Date   </entry>
+	 <entry> 最終変更日</entry>
+	</row> 
+         <row> 
+	 <entry> Driver </entry>
+	 <entry> ドライバ</entry>
+	</row> 
+         <row> 
+	 <entry> Mailbox</entry>
+	 <entry> メールボックスの名前</entry>
+	</row> 
+	<row> 
+	 <entry> Nmsgs  </entry>
+	 <entry> メッセージ数</entry>
+	</row> 
+	<row> 
+	 <entry> Recent </entry>
+	 <entry> 最近のメッセージの数</entry>
+	</row> 
+         <row> 
+	 <entry> Unread </entry>
+	 <entry> 未読のメッセージの数</entry>
+	</row> 
+	<row> 
+	 <entry> Size   </entry>
+	 <entry> メールボックスのサイズ</entry>
+	</row> 
+       </tbody> 
+      </tgroup> 
+     </table> 
     </para> 
     <para> 
      <example> 
-      <title> <function>imap_set_quota</function>の例</title>
+      <title> <function>imap_mailboxmsginfo</function> の例</title>
       <programlisting role="php"> 
-$mbox = imap_open ("{your.imap.host:143}", "mailadmin", "password");
+&lt;?php
 
-if(!imap_set_quota($mbox, "user.kalowsky", 3000)) {
-	print "Error in setting quota\n";
-	return;
+$mbox = imap_open("{your.imap.host}INBOX","username", "password")
+      || die("can't connect: ".imap_last_error());
+ 
+$check = imap_mailboxmsginfo($mbox);
+ 
+if($check) {
+    print "Date: "    . $check-> Date    ."&lt;br>\n" ;
+    print "Driver: "  . $check-> Driver  ."&lt;br>\n" ;
+    print "Mailbox: " . $check-> Mailbox ."&lt;br>\n" ;
+    print "Messages: ". $check-> Nmsgs   ."&lt;br>\n" ;
+    print "Recent: "  . $check-> Recent  ."&lt;br>\n" ;
+    print "Unread: "  . $check-> Unread  ."&lt;br>\n" ;
+    print "Deleted: " . $check-> Deleted ."&lt;br>\n" ;
+    print "Size: "    . $check-> Size    ."&lt;br>\n" ;
+} else {
+    print "imap_check() failed: ".imap_last_error(). "&lt;br> \n";
 }
-
+ 
 imap_close($mbox);
+
+?&gt;
       </programlisting> 
      </example> 
     </para> 
-    <para> 
-     <function> imap_open</function>,
-     <function> imap_set_quota</function> も参照下さい。
-    </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-subscribe"> 
+  <refentry id="function.imap-mime-header-decode"> 
    <refnamediv> 
-    <refname> imap_subscribe</refname>
-    <refpurpose> メールボックスの購読</refpurpose>
+    <refname> imap_mime_header_decode</refname>
+    <refpurpose> MIMEヘッダーエレメントをデコードする</refpurpose>
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> int <function>imap_subscribe</function></funcdef>
-      <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> string <parameter>mbox</parameter></paramdef>
+      <funcdef> array <function>imap_header_decode</function></funcdef>
+      <paramdef> string <parameter>text</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
-    <para>   
-     新規メールボックスを購読します。
-    </para> 
     <para> 
-     成功するとtrue、失敗するとfalseを返します。
-    </para> 
-   </refsect1> 
-  </refentry> 
-
-  <refentry id="function.imap-undelete"> 
-   <refnamediv> 
-    <refname> imap_undelete</refname>
-    <refpurpose> 削除マークがついているメッセージのマークをはずす</r
efpurpose> 
-   </refnamediv> 
-   <refsect1> 
-    <title> 説明</title>
-    <funcsynopsis> 
-     <funcprototype> 
-      <funcdef> int <function>imap_undelete</function></funcdef>
-      <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> int <parameter>msg_number</parameter></paramdef>
-     </funcprototype> 
-    </funcsynopsis> 
-    <para>   
-     この関数は、<function> imap_delete</function>または
-     <function> imap_mail_move</function>によりセットされた指定されたメッ
-     セージの削除フラグをはずします。
+     関数<function> imap_mime_header_decode</function>は、非ASCIIテキス
+     トのMIMEメッセージヘッダエクステンションをデコードします。
+     (<ulink url="&url.rfc;rfc2047.html"> RFC2047</ulink>を参照下さい) 
+     デコードされた要素は、オブジェクトの配列で返されます。
+     ただし、各オブジェクトは二つのプロパティ"charset"と"text"を有ã
—ています。
+     要素がエンコードされていない場合、言い替えるとプレーンなUS
-ASCIIの場合、
+     この要素の"charset"プロパティは"default"に設定されます。
     </para> 
     <para> 
-     成功するとtrue、失敗するとfalseを返します。
-    </para> 
-   </refsect1> 
-  </refentry> 
+     <example> 
+      <title> <function>imap_mime_header_decode</function>の例</title>
+      <programlisting role="php"> 
+$text="=?ISO-8859-1?Q?Keld_J=F8rn_Simonsen?= &lt;keld@[...].dk> ";
 
-  <refentry id="function.imap-unsubscribe"> 
-   <refnamediv> 
-    <refname> imap_unsubscribe</refname>
-    <refpurpose> メールボックスの購読をやめる</refpurpose>
-   </refnamediv> 
-   <refsect1> 
-    <title> 説明</title>
-    <funcsynopsis> 
-     <funcprototype> 
-      <funcdef> int <function>imap_unsubscribe</function></funcdef>
-      <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> string <parameter>mbox</parameter></paramdef>
-     </funcprototype> 
-    </funcsynopsis> 
-    <para> 
-     指定されたメールボックスの購読を中止します。
+$elements=imap_mime_header_decode($text);
+for($i=0;$i&lt;count($elements);$i++) {
+	echo "Charset: {$elements[$i]-> charset}\n";
+	echo "Text: {$elements[$i]-> text}\n\n";
+}
+
+      </programlisting> 
+     </example> 
     </para> 
     <para> 
-     成功するとtrue、失敗するとfalseを返します。
+     上の例には二つの要素があります。最初の要素はISO-8859-1、
+     2番目の要素はプレーンなUS-ASCIIで事前にエンコードされていまã
™ã€‚
     </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-qprint"> 
+  <refentry id="function.imap-msgno"> 
    <refnamediv> 
-    <refname> imap_qprint</refname>
-    <refpurpose> quoted-printable 文字列を 8 ビット文字列に変換する
-    </refpurpose> 
+    <refname> imap_msgno</refname>
+    <refpurpose> 指定したUIDのメッセージ番号を返す</refpurpose>
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> string <function>imap_qprint</function></funcdef>
-      <paramdef> string <parameter>string</parameter></paramdef>
+      <funcdef> int <function>imap_msgno</function></funcdef>
+      <paramdef> int <parameter>imap_stream</parameter></paramdef>
+      <paramdef> int <parameter>uid</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
-    <para>   
-     (<ulink url="&url.rfc;rfc2045.html"> RFC2045</ulink>, section 6.7
-     に基づき)quoted-printable 文字列を 8 ビット文字列に変換します。
-    </para> 
-    <para> 
-     8ビット(バイナリ)文字列を返します。
-    </para> 
     <para> 
-     <function> imap_8bit</function>も参照下さい。
+     この関数は、指定したUIDnメッセージ番号を返します。
+     これは、<function> imap_uid</function> の逆の動作となります。
     </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-8bit"> 
+  <refentry id="function.imap-num-msg"> 
    <refnamediv> 
-    <refname> imap_8bit</refname>
+    <refname> imap_num_msg</refname>
     <refpurpose> 
-     8bit 文字列を quoted-printable 文字列に変換する
+     現在のメールボックスのメッセージ数を取得する
     </refpurpose> 
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> string <function>imap_8bit</function></funcdef>
-      <paramdef> string <parameter>string</parameter></paramdef>
+      <funcdef> int <function>imap_num_msg</function></funcdef>
+      <paramdef> int <parameter>stream_id</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
-    <para>   
-     (<ulink url="&url.rfc;rfc2045.html"> RFC2045</ulink>, section 6.7
-     に基づき)8bit 文字列をquoted-printable文字列に変換します。
-    </para> 
     <para> 
-     quoted-printable文字列を返します。
+     現在のメールボックスにあるメッセージ数を返します。
     </para> 
     <para> 
-     <function> imap_qprint</function>も参照下さい。
+     <function> imap_num_recent</function> および
+     <function> imap_status</function> も参照下さい。
     </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-binary"> 
+  <refentry id="function.imap-num-recent"> 
    <refnamediv> 
-    <refname> imap_binary</refname>
-     <refpurpose> 8ビット文字列をbase64文字列に変換する</refpurpose>
+    <refname> imap_num_recent</refname>
+    <refpurpose> 現在のメールボックスにある新規メッセージの数の取得
</refpurpose> 
    </refnamediv> 
-    <refsect1> 
+   <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> string <function>imap_binary</function></funcdef>
-      <paramdef> string <parameter>string</parameter></paramdef>
+      <funcdef> int <function>imap_num_recent</function></funcdef>
+      <paramdef> int <parameter>imap_stream</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
-    <para> 
-     (<ulink url="&url.rfc;rfc2045.html"> RFC2045</ulink>,Section 6.8に
-     基づき)8ビット文字列をbase64文字列に変換します。
-    </para> 
     <para> 
-     base64 文字列を返します。
+     現在のメールボックスにある新しいメッセージの数を返しますã€
‚
     </para> 
     <para> 
-     <function> imap_base64</function>も参照下さい。
+     <function> imap_num_msg</function> および
+     <function> imap_status</function> も参照下さい。
     </para> 
    </refsect1> 
   </refentry> 
- 
-  <refentry id="function.imap-scanmailbox"> 
+
+  <refentry id="function.imap-open"> 
    <refnamediv> 
-     <refname> imap_scanmailbox</refname>
+    <refname> imap_open</refname>
     <refpurpose> 
-     メールボックスのリストを読み、メールボックスのテキストにã
Šã„て
-     文字列を検索する
+     メールボックスへのIMAPストリームをオープンする
     </refpurpose> 
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> array <function>imap_scanmailbox</function></funcdef>
-      <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> string <parameter>content</parameter></paramdef>
+      <funcdef> int <function>imap_open</function></funcdef>
+      <paramdef> string <parameter>mailbox</parameter></paramdef>
+      <paramdef> string <parameter>username</parameter></paramdef>
+      <paramdef> string <parameter>password</parameter></paramdef>
+      <paramdef> int 
+       <parameter> 
+	<replaceable> <optional>flags</optional></replaceable>
+       </parameter> 
+      </paramdef> 
      </funcprototype> 
     </funcsynopsis> 
     <para> 
-     メールボックスのテキストに<parameter> content</parameter>があるメー
-     ルボックスの名前を有する配列を返します。この関数は
-     <function> imap_listmailbox</function>に似ていますが、メールボック
-     スのデータ中に文字列<parameter> content</parameter>が存在するかど
-     うかの確認も行います。
+     成功するとIMAPストリームを返し、失敗するとfalseを返します。ã
“の関
+     数は、POP3やNNTPサーバーへのストリームをオープンする際にも使
用可
+     能です。しかし、いくつかの関数および機能はIMAPサーバーではå
ˆ©ç”¨ã§
+     きません。
+    </para> 
+    <para> 
+     メールボックス名(mailbox)は、サーバー名の部分と使用するサーãƒ
ãƒ¼ã«
+     おけるメールボックスへのパスから構成されます。特別な名前IN
BOXは、
+     カレントのユーザの個人メールボックスを意味します。サーバãƒ
¼éƒ¨ã¯'{'
+     および'}'で括られ、サーバー名またはIPアドレス、('/'で始まる)ã
ƒ—ロ
+     トコル指定、そして':'から始まるオプションのポート指定子かã‚
‰æ§‹æˆã•
+     れます。サーバー部は、全てのmailboxパラメータで必須です。
+     ASCII空間で出力可能な文字以外の外国文字を含むメールボックス
名は
+     <function> imap_utf7_encode</function>でエンコードする必要がありま
+     す。
+    </para> 
+    <para> 
+     オプションは、ビットマスクであり、以下の組み合わせとなりã
¾ã™ã€‚
+     <itemizedlist> 
+      <listitem> 
+       <simpara> 
+	OP_READONLY - メールボックスを読みこみのみ可でオープン
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+	OP_ANONYMOUS - news に関して.newsrcの使用・更新をしない(NNTPのみ)
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+	OP_HALFOPEN - IMAPおよびNNTP名について、接続をオープンするがメールãƒ
œãƒƒã‚¯ã‚¹ã‚’オープンしない
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+	CL_EXPUNGE - メールボックスを閉じた際に、自動的にメールボックスã‚
’削除する
+       </simpara> 
+      </listitem> 
+     </itemizedlist> 
+    </para> 
+    <para> 
+     ローカルマシンのポート143で実行しているIMAPサーバーに接続
+     する際には、以下のようにします。
+     <informalexample> 
+      <programlisting role="php"> 
+$mbox = imap_open ("{localhost:143}INBOX","user_id","password");
+      </programlisting> 
+     </informalexample> 
+      ローカルマシンのポート110で実行しているPOP3サーバーに接続す
る際には、
+     以下のようにします。
+     <informalexample> 
+      <programlisting> 
+$mbox = imap_open ("{localhost/pop3:110}INBOX","user_id","password");
+      </programlisting> 
+     </informalexample> 
+     ローカルマシンのポート119で実行しているNNTPサーバーに接続すã
‚‹éš›ã«ã¯ã€
+     以下のようにします。
+     <informalexample> 
+      <programlisting> 
+$nntp = imap_open ("{localhost/nntp:119}comp.test","","");
+      </programlisting> 
+     </informalexample> 
+     リモートサーバーに接続するには、"localhost" を接続したいサーãƒ
ãƒ¼ã®
+     名前または IP アドレスに代えてください。
+    </para> 
+    <para> 
+     <example> 
+      <title> <function>imap_open</function>の例</title>
+      <programlisting> 
+$mbox = imap_open("{your.imap.host:143}","username","password");
+
+echo "&lt;p&gt;&lt;h1&gt;Mailboxes&lt;/h1&gt;\n";
+$folders = imap_listmailbox($mbox, "{your.imap.host:143}", "*");
+if($folders == false)
+  echo "Call failed&lt;br&gt;\n";
+else
+  while(list($key,$val) = each($folders))
+    echo $val."&lt;br&gt;\n";
+
+echo "&lt;p&gt;&lt;h1&gt;Headers in INBOX&lt;/h1&gt;\n";
+$headers = imap_headers($mbox);
+if($headers == false)
+  echo "Call failed&lt;br&gt;\n";
+else
+  while(list($key,$val) = each($headers))
+    echo $val."&lt;br&gt;\n";
+
+imap_close($mbox);
+      </programlisting> 
+     </example> 
     </para> 
    </refsect1> 
   </refentry> 
-  
-  <refentry id="function.imap-mailboxmsginfo"> 
+
+  <refentry id="function.imap-ping"> 
    <refnamediv> 
-    <refname> imap_mailboxmsginfo</refname>
-    <refpurpose> 現在のメールボックスに関する情報を得る</refpurpose>
+    <refname> imap_ping</refname>
+    <refpurpose> IMAP ストリームの有効性チェック</refpurpose>
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> array <function>imap_mailboxmsginfo</function></funcdef>
+      <funcdef> int <function>imap_ping</function></funcdef>
       <paramdef> int <parameter>imap_stream</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
     <para> 
-     現在のメールボックスに関する情報を返します。
-     失敗した場合にfalseを返します。
-    </para> 
-    <para>   
-     <function> imap_mailboxmsginfo</function> 関数は、
-     サーバーにおける現在のメールボックスのステータスを調べ、
-     次のプロパティを有するオブジェクトの情報を返します。
-     この関数は<function> imap_status</function>に似ていますが、
-     メールボックスの中の全てのメッセージのサイズを合計しますã€
‚
-     このため、実行時間は幾分余計にかかります。
+     ストリームがまだ有効であればtrueを、そうでなければfalseã‚’è¿”ã
—ます。
     </para> 
     <para> 
-     <table> 
-      <title> mailboxのプロパティ</title>
-      <tgroup cols="2"> 
-       <tbody> 
-         <row> 
-	 <entry> Date   </entry>
-	 <entry> 最終変更日</entry>
-	</row> 
-         <row> 
-	 <entry> Driver </entry>
-	 <entry> ドライバ</entry>
-	</row> 
-         <row> 
-	 <entry> Mailbox</entry>
-	 <entry> メールボックスの名前</entry>
-	</row> 
-	<row> 
-	 <entry> Nmsgs  </entry>
-	 <entry> メッセージ数</entry>
-	</row> 
-	<row> 
-	 <entry> Recent </entry>
-	 <entry> 最近のメッセージの数</entry>
-	</row> 
-         <row> 
-	 <entry> Unread </entry>
-	 <entry> 未読のメッセージの数</entry>
-	</row> 
-	<row> 
-	 <entry> Size   </entry>
-	 <entry> メールボックスのサイズ</entry>
-	</row> 
-       </tbody> 
-      </tgroup> 
-     </table> 
+     <function> imap_ping</function> 関数は、ストリームに ping を行い、
+     まだ有効であるかどうかをチェックします。これにより新しいãƒ
¡ãƒ¼ãƒ«ã®åˆ°ç€
+     を知る場合もあります。これは、有効時間のタイムアウトが設å®
š
+     してあるサーバに対して "接続を持続させる" ことに加え、定期ç
š„な
+     "新着メールのチェック" としてもよい方法です。
+     (PHPスクリプトはこれほどの長時間実行されることはほとんどなã
„ので、
+     この関数が実際に役に立つかどうかは定かではありません。)
     </para> 
-    <para> 
-     <example> 
-      <title> <function>imap_mailboxmsginfo</function> の例</title>
-      <programlisting role="php"> 
-&lt;?php
-
-$mbox = imap_open("{your.imap.host}INBOX","username", "password")
-      || die("can't connect: ".imap_last_error());
- 
-$check = imap_mailboxmsginfo($mbox);
- 
-if($check) {
-    print "Date: "    . $check-> Date    ."&lt;br>\n" ;
-    print "Driver: "  . $check-> Driver  ."&lt;br>\n" ;
-    print "Mailbox: " . $check-> Mailbox ."&lt;br>\n" ;
-    print "Messages: ". $check-> Nmsgs   ."&lt;br>\n" ;
-    print "Recent: "  . $check-> Recent  ."&lt;br>\n" ;
-    print "Unread: "  . $check-> Unread  ."&lt;br>\n" ;
-    print "Deleted: " . $check-> Deleted ."&lt;br>\n" ;
-    print "Size: "    . $check-> Size    ."&lt;br>\n" ;
-} else {
-    print "imap_check() failed: ".imap_last_error(). "&lt;br> \n";
-}
- 
-imap_close($mbox);
+   </refsect1> 
+  </refentry> 
 
-?&gt;
-      </programlisting> 
-     </example> 
+  <refentry id="function.imap-qprint"> 
+   <refnamediv> 
+    <refname> imap_qprint</refname>
+    <refpurpose> quoted-printable 文字列を 8 ビット文字列に変換する
+    </refpurpose> 
+   </refnamediv> 
+   <refsect1> 
+    <title> 説明</title>
+    <funcsynopsis> 
+     <funcprototype> 
+      <funcdef> string <function>imap_qprint</function></funcdef>
+      <paramdef> string <parameter>string</parameter></paramdef>
+     </funcprototype> 
+    </funcsynopsis> 
+    <para>   
+     (<ulink url="&url.rfc;rfc2045.html"> RFC2045</ulink>, section 6.7
+     に基づき)quoted-printable 文字列を 8 ビット文字列に変換します。
+    </para> 
+    <para> 
+     8ビット(バイナリ)文字列を返します。
+    </para> 
+    <para> 
+     <function> imap_8bit</function>も参照下さい。
     </para> 
    </refsect1> 
   </refentry> 
- 
-  <refentry id="function.imap-rfc822-write-address"> 
+
+  <refentry id="function.imap-renamemailbox"> 
    <refnamediv> 
-    <refname> imap_rfc822_write_address</refname>
-    <refpurpose> 
-     指定したメールボックス、ホスト、個人情報を適当にフォーマãƒ
ƒãƒˆã•ã‚Œ
-     た電子メールアドレスにして返す
-    </refpurpose> 
+    <refname> imap_renamemailbox</refname>
+    <refpurpose> メールボックスの名前を変更する</refpurpose>
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> string <function>imap_rfc822_write_address</function></funcdef>
-       <paramdef> string <parameter>mailbox</parameter></paramdef>
-      <paramdef> string <parameter>host</parameter></paramdef>
-      <paramdef> string <parameter>personal</parameter></paramdef>
+      <funcdef> int <function>imap_renamemailbox</function></funcdef>
+      <paramdef> int <parameter>imap_stream</parameter></paramdef>
+      <paramdef> string <parameter>old_mbox</parameter></paramdef>
+      <paramdef> string <parameter>new_mbox</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
+    <para>   
+     この関数は、古いメールボックスを新しいメールボックスにリãƒ
ãƒ¼ãƒ 
+     します。 (<parameter> mbox</parameter>名のフォーマットについては
+     <function> imap_open</function>を参照下さい)
+    </para> 
     <para> 
-     指定したメールボックス、ホスト、個人情報を
-     <ulink url="&url.rfc;rfc822.html"> RFC822</ulink>の定義に基づき
-     適当にフォーマットされた電子メールアドレスにして返しますã€
‚
+     成功するとtrue、失敗するとfalseを返します。
     </para> 
     <para> 
-     <example> 
-      <title> <function>imap_rfc822_write_address</function> の例</title>
-      <programlisting role="php"> 
-print imap_rfc822_write_address("hartmut","cvs.php.net","Hartmut Holzgraefe")."\n";      
-      </programlisting> 
-     </example> 
+     <parameter> mbox</parameter>のフォーマットについては、
+     <function> imap_createmailbox</function>,
+     <function> imap_deletemailbox</function>,
+     <function> imap_open</function>も参照下さい。
     </para> 
    </refsect1> 
   </refentry> 
-  
-  <refentry id="function.imap-rfc822-parse-adrlist"> 
+
+  <refentry id="function.imap-reopen"> 
    <refnamediv> 
-    <refname> imap_rfc822_parse_adrlist</refname>
-    <refpurpose> アドレス文字列を解釈します</refpurpose>
+    <refname> imap_reopen</refname>
+    <refpurpose> 新規メールボックスへのIMAP ストリームを再度オープンã
™ã‚‹
+    </refpurpose> 
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> string <function>imap_rfc822_parse_adrlist</function></funcdef>
-      <paramdef> string <parameter>address</parameter></paramdef>
-      <paramdef> string <parameter>default_host</parameter></paramdef>
+      <funcdef> int <function>imap_reopen</function></funcdef>
+      <paramdef> int <parameter>imap_stream</parameter></paramdef>
+      <paramdef> string <parameter>mailbox</parameter></paramdef>
+      <paramdef> string
+       <parameter> 
+	<replaceable> <optional>flags</optional></replaceable>
+       </parameter> 
+      </paramdef> 
      </funcprototype> 
     </funcsynopsis> 
     <para> 
-     この関数は、<ulink url="&url.rfc;rfc822.html"> RFC822</ulink>
-     の定義に基づきアドレス文字列を解釈し、各アドレス毎にオブã‚
¸ã‚§ã‚¯ãƒˆã®
-     配列を返します。4 つのオブジェクトは、以下のようになります
。
+     成功するとtrue、失敗するとfalseを返します。
+    </para> 
+    <para>   
+     この関数は、IMAPまたはNNTPサーバー上の新しいメールボックスに
対して
+     指定されたストリームを再オープンします。
     </para> 
     <para> 
+     オプションは、ビットマスクであり、以下の組み合わせとなりã
¾ã™ã€‚
      <itemizedlist> 
       <listitem> 
        <simpara> 
-        mailbox  - メールボックス名 (ユーザ名)
+ 	OP_READONLY - メールボックスを読みこみのみ可でオープン
        </simpara> 
       </listitem> 
       <listitem> 
        <simpara> 
-        host - ホスト名
+ 	OP_ANONYMOUS - news に関して .newsrc の使用・更新をしない (NNTPのみ)
        </simpara> 
       </listitem> 
       <listitem> 
        <simpara> 
-        personal - 個人名
+ 	OP_HALFOPEN - IMAP および NNTP 名について、接続をオープンするが
+	              メールボックスをオープンしない
        </simpara> 
       </listitem> 
       <listitem> 
        <simpara> 
-        adl - ドメインソースルートからのパス
+ 	CL_EXPUNGE - メールボックスを閉じた際に、自動的にメールボック
+ 	スを削除する (<function> imap_delete</function>および
+	<function> imap_expunge</function>も参照下さい )
        </simpara> 
       </listitem> 
      </itemizedlist> 
     </para> 
     <para> 
-     <example> 
-      <title> <function>imap_rfc822_parse_adrlist</function> の例</title>
-      <programlisting role="php"> 
-$address_string = "Hartmut Holzgraefe &lt;hartmut@[...].net> , postmaster@[...].net, root";
-$address_array  = imap_rfc822_parse_adrlist($address_string,"somedomain.net");
-if(! is_array($address_array)) die("somethings wrong\n");
- 
-reset($address_array);
-while(list($key,$val)=each($address_array)){
-  print "mailbox : ".$val-> mailbox."&lt;br>\n";
-  print "host    : ".$val-> host."&lt;br>\n";
-  print "personal: ".$val-> personal."&lt;br>\n";
-  print "adl     : ".$val-> adl."&lt;p>\n";
-} 
-      </programlisting> 
-     </example> 
+     成功時にtrue、エラー時にfalseを返します。
     </para> 
    </refsect1> 
   </refentry> 
- 
-  <refentry id="function.imap-setflag-full"> 
+
+  <refentry id="function.imap-rfc822-parse-adrlist"> 
    <refnamediv> 
-    <refname> imap_setflag_full</refname>
-    <refpurpose> メッセージにフラグをセットする</refpurpose>
+    <refname> imap_rfc822_parse_adrlist</refname>
+    <refpurpose> アドレス文字列を解釈します</refpurpose>
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> string <function>imap_setflag_full</function></funcdef>
-      <paramdef> int <parameter>stream</parameter></paramdef>
-      <paramdef> string <parameter>sequence</parameter></paramdef>
-      <paramdef> string <parameter>flag</parameter></paramdef>
-      <paramdef> string <parameter>options</parameter></paramdef>
+      <funcdef> string <function>imap_rfc822_parse_adrlist</function></funcdef>
+      <paramdef> string <parameter>address</parameter></paramdef>
+      <paramdef> string <parameter>default_host</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
-    <para> 
-     この関数は、指定したシーケンスのメッセージのフラグに指定ã
—たフラグを
-     セットし、保存します。
-    </para> 
     <para> 
-     設定可能なフラグは、(RFC2060で定義された) "\\Seen", "\\Answered",
-     "\\Flagged", "\\Deleted", "\\Draft", "\\Recent" です。
+     この関数は、<ulink url="&url.rfc;rfc822.html"> RFC822</ulink>
+     の定義に基づきアドレス文字列を解釈し、各アドレス毎にオブã‚
¸ã‚§ã‚¯ãƒˆã®
+     配列を返します。4 つのオブジェクトは、以下のようになります
。
     </para> 
     <para> 
-     オプションはビットマスクであり、以下の組み合わせとなりまã
™ã€‚
-     <informalexample> 
-      <literallayout> 
-       ST_UID          シーケンス引数はシーケンス番号の代わりに UID を
-       含みます
-      </literallayout> 
-     </informalexample> 
+     <itemizedlist> 
+      <listitem> 
+       <simpara> 
+        mailbox  - メールボックス名 (ユーザ名)
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+        host - ホスト名
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+        personal - 個人名
+       </simpara> 
+      </listitem> 
+      <listitem> 
+       <simpara> 
+        adl - ドメインソースルートからのパス
+       </simpara> 
+      </listitem> 
+     </itemizedlist> 
     </para> 
     <para> 
      <example> 
-      <title> <function>imap_setflag_full</function> の例</title>
-      <programlisting role="php"> 
-$mbox = imap_open ("{your.imap.host:143}","username","password")
-     || die("can't connect: ".imap_last_error());
- 
-$status = imap_setflag_full ($mbox,"2,5","\\Seen \\Flagged");
- 
-print gettype ($status)."\n";
-print $status."\n";
- 
-imap_close($mbox);
-      </programlisting> 
-     </example> 
-    </para> 
-   </refsect1> 
-  </refentry> 
- 
-  <refentry id="function.imap-clearflag-full"> 
-   <refnamediv> 
-    <refname> imap_clearflag_full</refname>
-    <refpurpose> メッセージのフラグをクリアする</refpurpose>
-   </refnamediv> 
-   <refsect1> 
-    <title> 説明</title>
-    <funcsynopsis> 
-     <funcprototype> 
-      <funcdef> string <function>imap_clearflag_full</function></funcdef>
-      <paramdef> int <parameter>stream</parameter></paramdef>
-      <paramdef> string <parameter>sequence</parameter></paramdef>
-      <paramdef> string <parameter>flag</parameter></paramdef>
-      <paramdef> string <parameter>options</parameter></paramdef>
-     </funcprototype> 
-    </funcsynopsis> 
-    <para> 
-     この関数は、指定したシーケンスのメッセージのフラグからにæŒ
‡å®šã—たフラグ
-     を削除します。設定可能なフラグは、(RFC2060で定義された) "\\Seen
",
-     "\\Answered", "\\Flagged", "\\Deleted", "\\Draft", "\\Recent" です。
-    </para> 
-    <para> 
-     オプションはビットマスクであり、以下の組み合わせとなりまã
™ã€‚
-     <informalexample> 
-      <literallayout> 
-       ST_UID          シーケンス引数はシーケンス番号の代わりに UID を
含みます
-      </literallayout> 
-     </informalexample> 
-    </para> 
-   </refsect1> 
-  </refentry> 
- 
-  <refentry id="function.imap-sort"> 
-   <refnamediv> 
-    <refname> imap_sort</refname>
-    <refpurpose> </refpurpose>
-   </refnamediv> 
-   <refsect1> 
-    <title> 説明</title>
-    <funcsynopsis> 
-     <funcprototype> 
-      <funcdef> array <function>imap_sort</function></funcdef>
-      <paramdef> int <parameter>stream</parameter></paramdef>
-      <paramdef> int <parameter>criteria</parameter></paramdef>
-      <paramdef> int <parameter>reverse</parameter></paramdef>
-      <paramdef> int <parameter>options</parameter></paramdef>
-     </funcprototype> 
-    </funcsynopsis> 
-    <para> 
-     指定したパラメータによりソートされたメッセージ番号の配列ã‚
’
-     返します。
-    </para> 
-    <para> 
-     逆順にソートする場合は、reverse を 1 にします。
-    </para> 
-    <para> 
-     criteria は、次のどれかとします。(一つのみ)
-     <informalexample> 
-      <literallayout> 
-SORTDATE        メッセージの日付
-SORTARRIVAL     到着日付
-SORTFROM        最初の From アドレスのメールボックス
-SORTSUBJECT     メッセージ Subject
-SORTTO          最初の To アドレスのメールボックス
-SORTCC          最初の cc アドレスのメールボックス
-SORTSIZE        メッセージのサイズ
-      </literallayout> 
-     </informalexample> 
-    </para> 
-     <para> 
-     フラグはビットマスクであり、次の組み合わせとjります。
-     <informalexample> 
-      <literallayout> 
-SE_UID          シーケンス番号の変わりに UID を返す
-SE_NOPREFETCH   検索したメッセージを事前取得しない
-      </literallayout> 
-     </informalexample> 
+      <title> <function>imap_rfc822_parse_adrlist</function> の例</title>
+      <programlisting role="php"> 
+$address_string = "Hartmut Holzgraefe &lt;hartmut@[...].net> , postmaster@[...].net, root";
+$address_array  = imap_rfc822_parse_adrlist($address_string,"somedomain.net");
+if(! is_array($address_array)) die("somethings wrong\n");
+ 
+reset($address_array);
+while(list($key,$val)=each($address_array)){
+  print "mailbox : ".$val-> mailbox."&lt;br>\n";
+  print "host    : ".$val-> host."&lt;br>\n";
+  print "personal: ".$val-> personal."&lt;br>\n";
+  print "adl     : ".$val-> adl."&lt;p>\n";
+} 
+      </programlisting> 
+     </example> 
     </para> 
    </refsect1> 
   </refentry> 
- 
-  <refentry id="function.imap-fetchheader"> 
+
+  <refentry id="function.imap-rfc822-parse-headers"> 
    <refnamediv> 
-    <refname> imap_fetchheader</refname>
-    <refpurpose> メッセージのヘッダを返す</refpurpose>
+    <refname> imap_rfc822_parse_headers</refname>
+    <refpurpose> 文字列からメールヘッダを解釈する</refpurpose>
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> string<function>imap_fetchheader</function></funcdef>
-      <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> int <parameter>msgno</parameter></paramdef>
-      <paramdef> int <parameter>flags</parameter></paramdef>
+      <funcdef> object <function>imap_rfc822_parse_headers</function></funcdef>
+      <paramdef> string <parameter>headers</parameter></paramdef>
+      <paramdef> string 
+       <parameter> 
+	<replaceable> <optional>defaulthost</optional></replaceable>
+       </parameter> 
+      </paramdef> 
      </funcprototype> 
     </funcsynopsis> 
-    <para> 
-     この関数は、指定したメッセージのヘッダーを完全でフィルタãƒ
¼ãƒªãƒ³ã‚°
-     されていない<ulink url="&url.rfc;rfc822.html"> RFC822</ulink>フォー
-     マットのテキスト文字列として取得し、テキスト文字列を返しã
¾ã™ã€‚
-    </para> 
     <para> 
-     オプションは次のようになります。
-     <informalexample> 
-      <literallayout> 
-FT_UID          msgno 引数は UID である 
-FT_INTERNAL     返される文字列を "internal" フォーマットとする。
-                ただし、CRLF 改行は例外とする。
-FT_PREFETCHTEXT RFC822.TEXT は同時に事前に取得する必要があります。
-       これは、メッセージテキスト全体を取得したい場合にIMAP
-       接続において別の RTT を回避します。
-       (例えば、"ローカルファイルに保存する"操作)
-      </literallayout> 
-     </informalexample> 
+     この関数は複数のヘッダ要素を有するオブジェクトを返しますã€
‚
+     この関数は<function> imap_header</function>に似ていますが、
+     フラグおよび他の要素はIMAPサーバーから取得されるところが異ã
ªã‚Šã¾ã™ã€‚
     </para> 
    </refsect1> 
   </refentry> 
- 
-  <refentry id="function.imap-uid"> 
+
+  <refentry id="function.imap-rfc822-write-address"> 
    <refnamediv> 
-    <refname> imap_uid</refname>
+    <refname> imap_rfc822_write_address</refname>
     <refpurpose> 
-     指定したメッセージシーケンス番号の UID を返す
+     指定したメールボックス、ホスト、個人情報を適当にフォーマãƒ
ƒãƒˆã•ã‚Œ
+     た電子メールアドレスにして返す
     </refpurpose> 
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> int <function>imap_uid</function></funcdef>
-      <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> int <parameter>msgno</parameter></paramdef>
+      <funcdef> string <function>imap_rfc822_write_address</function></funcdef>
+       <paramdef> string <parameter>mailbox</parameter></paramdef>
+      <paramdef> string <parameter>host</parameter></paramdef>
+      <paramdef> string <parameter>personal</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
     <para> 
-     この関数は、指定したメッセージシーケンス番号の UID を返しま
す。
-     メッセージ番号はメールボックスの内容を変更する度に変わるå
¯èƒ½æ€§ãŒ
-     ありますが、UIDはユニークなIDであり時間が経過しても変わりま
せん。
-     この関数は、<function> imap_msgno</function> の逆関数です。
+     指定したメールボックス、ホスト、個人情報を
+     <ulink url="&url.rfc;rfc822.html"> RFC822</ulink>の定義に基づき
+     適当にフォーマットされた電子メールアドレスにして返しますã€
‚
+    </para> 
+    <para> 
+     <example> 
+      <title> <function>imap_rfc822_write_address</function> の例</title>
+      <programlisting role="php"> 
+print imap_rfc822_write_address("hartmut","cvs.php.net","Hartmut Holzgraefe")."\n";      
+      </programlisting> 
+     </example> 
     </para> 
    </refsect1> 
-  </refentry> 
-  
-  <refentry id="function.imap-msgno"> 
+  </refentry>   
+
+  <refentry id="function.imap-scanmailbox"> 
    <refnamediv> 
-    <refname> imap_msgno</refname>
-    <refpurpose> 指定したUIDのメッセージ番号を返す</refpurpose>
+     <refname> imap_scanmailbox</refname>
+    <refpurpose> 
+     メールボックスのリストを読み、メールボックスのテキストにã
Šã„て
+     文字列を検索する
+    </refpurpose> 
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> int <function>imap_msgno</function></funcdef>
+      <funcdef> array <function>imap_scanmailbox</function></funcdef>
       <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> int <parameter>uid</parameter></paramdef>
+      <paramdef> string <parameter>content</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
     <para> 
-     この関数は、指定したUIDnメッセージ番号を返します。
-     これは、<function> imap_uid</function> の逆の動作となります。
+     メールボックスのテキストに<parameter> content</parameter>があるメー
+     ルボックスの名前を有する配列を返します。この関数は
+     <function> imap_listmailbox</function>に似ていますが、メールボック
+     スのデータ中に文字列<parameter> content</parameter>が存在するかど
+     うかの確認も行います。
     </para> 
    </refsect1> 
-  </refentry> 
- 
+  </refentry>    
+
   <refentry id="function.imap-search"> 
    <refnamediv> 
     <refname> imap_search</refname>
@@ -2318,535 +2417,449 @@
        </simpara> 
       </listitem> 
       <listitem> 
-       <simpara> 
-        UNKEYWORD "string" - キーワード "string" を有さないメッセージにマã
ƒƒãƒ
-       </simpara> 
-      </listitem> 
-      <listitem> 
-       <simpara> 
-        UNSEEN - 未読のメッセージにマッチ
-       </simpara> 
-      </listitem> 
-     </itemizedlist> 
-    </para> 
-    <para> 
-     例えば、Mom から送られた全ての未回答のメッセージにマッチすã
‚‹ã«ã¯ã€
-     "UNANSWERED FROM mom"を使用する必要があります。
-     検索は、大文字小文字が区別されずに行われます。
-     検索条件のリストは、UWクライアントのCソースコードからのもã
®ã§ã‚り、
-     不完全または不正確である可能性があります。
-     (RFC2060, section 6.4.4も参照下さい)
-    </para> 
-    <para> 
-     SE_UID が有効なフラグとして設定されている場合、
-     メッセージ番号の変わりに UID を有する配列が返されます。
-    </para> 
-   </refsect1> 
-  </refentry> 
-  
-  <refentry id="function.imap-last-error"> 
-   <refnamediv> 
-    <refname> imap_last_error</refname>
-    <refpurpose> 
-     ページリクエスト時に生じた直近の IMAP エラーを返す
-    </refpurpose> 
-   </refnamediv> 
-   <refsect1> 
-    <title> 説明</title>
-    <funcsynopsis> 
-     <funcprototype> 
-      <funcdef> string <function>imap_last_error</function></funcdef>
-      <paramdef> void </paramdef>
-     </funcprototype> 
-    </funcsynopsis> 
-    <para> 
-     この関数は、カレントページに生じた直近のIMAPエラーメッセーã
‚¸ã®
-     全文を返します。エラースタックは変更されません。
-     <function> imap_last_error</function> を続けてコールした際、
-     コール間に新規エラーが生じていない場合は、同じエラーが返ã
•ã‚Œã¾ã™ã€‚
-    </para> 
-   </refsect1> 
-  </refentry> 
-  
-  <refentry id="function.imap-errors"> 
-   <refnamediv> 
-    <refname> imap_errors</refname>
-    <refpurpose> 
-     ページのリクエストの間かエラースタックがリセットされて以æ
¥
-     生じた全てのIMAPエラーを返す
-    </refpurpose> 
-   </refnamediv> 
-   <refsect1> 
-    <title> 説明</title>
-    <funcsynopsis> 
-     <funcprototype> 
-      <funcdef> array <function>imap_errors</function></funcdef>
-      <paramdef> void </paramdef>
-     </funcprototype> 
-    </funcsynopsis> 
-    <para> 
-     この関数は、最後に <function> imap_errors</function> コールを
-     行ってからまたはそのページの処理を開始してから
-     発生した全ての IMAP エラーメッセージの配列を返します。
-     <function> imap_errors</function> がコールされた場合、エラースタックã
¯
-     処理後にクリアされます。
-    </para> 
-   </refsect1> 
-  </refentry> 
- 
-  <refentry id="function.imap-alerts"> 
-   <refnamediv> 
-    <refname> imap_alerts</refname>
-    <refpurpose> 
-     ページリクエストの間または最後にスタックがリセットされてä»
¥æ¥ç™ºç”Ÿã—た
-     全てのIMAP警告メッセージを返す
-    </refpurpose> 
-   </refnamediv> 
-   <refsect1> 
-    <title> 説明</title>
-    <funcsynopsis> 
-     <funcprototype> 
-      <funcdef> array <function>imap_alerts</function></funcdef>
-      <paramdef> void </paramdef>
-     </funcprototype> 
-    </funcsynopsis> 
-    <para> 
-     この関数は、直近に <function> imap_alerts</function> をコールして
-     以来、またはページ処理を開始して以来生成された å…¨ IMAP 警告ã
ƒ¡ãƒƒã‚»ãƒ¼
-     ジの配列を得ます。<function> imap_alerts</function> がコールされた
-     場合、カレントのスタックは、処理後にクリアされます。IMAP 規
約では、
-     これらのメッセージをユーザに渡すことが規定されています。
-    </para> 
-   </refsect1> 
-  </refentry> 
- 
-  <refentry id="function.imap-status"> 
-   <refnamediv> 
-    <refname> imap_status</refname>
-    <refpurpose> 
-     現在のメールボックス以外のメールボックスのステータス情報ã‚
’返す
-    </refpurpose> 
-   </refnamediv> 
-   <refsect1> 
-    <title> 説明</title>
-    <funcsynopsis> 
-     <funcprototype> 
-      <funcdef> object <function>imap_status</function></funcdef>
-      <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> string <parameter>mailbox</parameter></paramdef>
-      <paramdef> int <parameter>options</parameter></paramdef>
-     </funcprototype> 
-    </funcsynopsis> 
-    <para> 
-     この関数は、ステータス情報を有するオブジェクトを返しますã€
‚
-     有効なフラグは次のようになります。
-     <itemizedlist> 
-      <listitem> 
-       <simpara> 
-        SA_MESSAGES - status-> messages にメールボックスのメッセージ数を設å
®šã™ã‚‹
-       </simpara> 
-      </listitem> 
-      <listitem> 
-       <simpara> 
-        SA_RECENT - status-> recent にメールボックスの最近のメッセージ数ã‚
’設定する
-       </simpara> 
-      </listitem> 
-      <listitem> 
-       <simpara> 
-        SA_UNSEEN - status-> unseen にメールボックスの未読の(新規)メッセー
ジ数を
-	            設定する
-       </simpara> 
-      </listitem> 
-      <listitem> 
-       <simpara> 
-        SA_UIDNEXT - status-> uidnext にメールボックスの次のUIDを設定する
-       </simpara> 
-      </listitem> 
-      <listitem> 
        <simpara> 
-        SA_UIDVALIDITY - メールボックスのUIDがもはや有効ではない場合に
変化する
-	                 定数を status-> uidvalidity に設定する
+        UNKEYWORD "string" - キーワード "string" を有さないメッセージにマã
ƒƒãƒ
        </simpara> 
       </listitem> 
       <listitem> 
        <simpara> 
-        SA_ALL - 上記のものを全f設定する
+        UNSEEN - 未読のメッセージにマッチ
        </simpara> 
       </listitem> 
      </itemizedlist> 
     </para> 
     <para> 
-      status-> flags にも上記の各定数に対するビットマスクが
-      設定されます。
+     例えば、Mom から送られた全ての未回答のメッセージにマッチすã
‚‹ã«ã¯ã€
+     "UNANSWERED FROM mom"を使用する必要があります。
+     検索は、大文字小文字が区別されずに行われます。
+     検索条件のリストは、UWクライアントのCソースコードからのもã
®ã§ã‚り、
+     不完全または不正確である可能性があります。
+     (RFC2060, section 6.4.4も参照下さい)
     </para> 
     <para> 
-     <example> 
-      <title> <function>imap_status</function> の例</title>
-      <programlisting role="php"> 
-$mbox = imap_open("{your.imap.host}","username","password",OP_HALFOPEN)
-      || die("can't connect: ".imap_last_error());
- 
-$status = imap_status($mbox,"{your.imap.host}INBOX",SA_ALL);
-if($status) {
-  print("Messages:   ". $status-> messages   )."&lt;br>\n";
-  print("Recent:     ". $status-> recent     )."&lt;br>\n";
-  print("Unseen:     ". $status-> unseen     )."&lt;br>\n";
-  print("UIDnext:    ". $status-> uidnext    )."&lt;br>\n";
-  print("UIDvalidity:". $status-> uidvalidity)."&lt;br>\n"; 
-} else
-  print "imap_status failed: ".imap_lasterror()."\n";
- 
-imap_close($mbox);
-      </programlisting> 
-     </example> 
+     SE_UID が有効なフラグとして設定されている場合、
+     メッセージ番号の変わりに UID を有する配列が返されます。
     </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-utf7-decode"> 
+  <refentry id="function.imap-set-quota"> 
    <refnamediv> 
-    <refname> imap_utf7_decode</refname>
-    <refpurpose> 
-     修正版UTF-7 エンコードされた文字列をデコードする
-    </refpurpose> 
+    <refname> imap_set_quota</refname>
+    <refpurpose> 指定したメールボックスにクオータを設定する</refpurpose
> 
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> string <function>imap_utf7_decode</function></funcdef>
-      <paramdef> string <parameter>text</parameter></paramdef>
+      <funcdef> int <function>imap_set_quota</function></funcdef>
+      <paramdef> int <parameter>imap_stream</parameter></paramdef>
+      <paramdef> string <parameter>quota_root</parameter></paramdef>
+      <paramdef> int <parameter>quota_limit</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
     <para>   
-     修正版UTF-7の<parameter> text</parameter>を8ビットデータにデコード
-     します。
+     メールボックス単位でクオータ上限(最大容量)を設定します。こ
の関数
+     は、メール管理者のアカウントでオープンされている
+     <parameter> imap_stream</parameter> を必要とします。他のユーザでオー
+     プンされている場合は、この関数は動作しません。
     </para> 
     <para> 
-     デコードされた8ビットデータを返します。入力文字列が有効なä
¿®æ­£ç‰ˆ
-     UTF-7文字列でない場合はfalseを返します。修正UTF-7エンコーディãƒ
³ã‚°
-     は、<ulink url="&url.rfc;rfc2060.html"> RFC 2060</ulink>, section
-     5.1.3 で定義されています。
-     (元のUTF-7は<ulink url="&url.rfc;rfc1642.html"> RFC1642</ulink>で
-     定義されています)
+     この関数は、c-client2000ライブラリのユーザのみ使用可能です。
+    </para> 
+    <para> 
+    <parameter> imap_stream</parameter> は、
+     <function> imap_open</function>コール時に返されたストリームポイン
+     タです。このストリームはメール管理者としてオープンする必è¦
ãŒã‚ã‚Š
+     ます。そうでない場合は、この関数は動作しません。
+     <parameter> quota_root</parameter> は、クオータを設定するメールボッ
+     クスです。これは、メールボックスのIMAP標準フォーマット
+     'user.name' に基づき指定する必要があります。
+     <parameter> quota_limit</parameter> は、
+     <parameter> quota_root</parameter> の最大サイズ(KB単位)です。
+    </para> 
+    <para> 
+     成功時にtrue、エラー時にfalseを返します。
+    </para> 
+    <para> 
+     <example> 
+      <title> <function>imap_set_quota</function>の例</title>
+      <programlisting role="php"> 
+$mbox = imap_open ("{your.imap.host:143}", "mailadmin", "password");
+
+if(!imap_set_quota($mbox, "user.kalowsky", 3000)) {
+	print "Error in setting quota\n";
+	return;
+}
+
+imap_close($mbox);
+      </programlisting> 
+     </example> 
+    </para> 
+    <para> 
+     <function> imap_open</function>,
+     <function> imap_set_quota</function> も参照下さい。
     </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-utf7-encode"> 
+  <refentry id="function.imap-setflag-full"> 
    <refnamediv> 
-    <refname> imap_utf7_encode</refname>
-    <refpurpose> 
-     8ビットデータを修正版UTF-7テキストにに変換する
-    </refpurpose> 
+    <refname> imap_setflag_full</refname>
+    <refpurpose> メッセージにフラグをセットする</refpurpose>
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> string <function>imap_utf7_encode</function></funcdef>
-      <paramdef> string <parameter>data</parameter></paramdef>
+      <funcdef> string <function>imap_setflag_full</function></funcdef>
+      <paramdef> int <parameter>stream</parameter></paramdef>
+      <paramdef> string <parameter>sequence</parameter></paramdef>
+      <paramdef> string <parameter>flag</parameter></paramdef>
+      <paramdef> string <parameter>options</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
     <para> 
-     8ビットデータの<parameter> data</parameter>を修正版UTF-7テキスト
-     に変換します。修正版UTF-7エンコードは
-     <ulink url="&url.rfc;rfc2060.html"> RFC 2060</ulink>, section 5.1.3 
-     で定義されています。(オリジナルのUTF-7は<ulink
-     url="&url.rfc;rfc1642.html"> RFC1642</ulink>で定義されています)
+     この関数は、指定したシーケンスのメッセージのフラグに指定ã
—たフラグを
+     セットし、保存します。
     </para> 
     <para> 
-     修正版UTF-7のテキストを返します。
+     設定可能なフラグは、(RFC2060で定義された) "\\Seen", "\\Answered",
+     "\\Flagged", "\\Deleted", "\\Draft", "\\Recent" です。
+    </para> 
+    <para> 
+     オプションはビットマスクであり、以下の組み合わせとなりまã
™ã€‚
+     <informalexample> 
+      <literallayout> 
+       ST_UID          シーケンス引数はシーケンス番号の代わりに UID を
+       含みます
+      </literallayout> 
+     </informalexample> 
     </para> 
+    <para> 
+     <example> 
+      <title> <function>imap_setflag_full</function> の例</title>
+      <programlisting role="php"> 
+$mbox = imap_open ("{your.imap.host:143}","username","password")
+     || die("can't connect: ".imap_last_error());
+ 
+$status = imap_setflag_full ($mbox,"2,5","\\Seen \\Flagged");
+ 
+print gettype ($status)."\n";
+print $status."\n";
+ 
+imap_close($mbox);
+      </programlisting> 
+     </example> 
+    </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-utf8"> 
+  <refentry id="function.imap-sort"> 
    <refnamediv> 
-    <refname> imap_utf8</refname>
-    <refpurpose> 
-      テキストをUTF8に変換する
-    </refpurpose> 
+    <refname> imap_sort</refname>
+    <refpurpose> </refpurpose>
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> string <function>imap_utf8</function></funcdef>
-      <paramdef> string <parameter>text</parameter></paramdef>
+      <funcdef> array <function>imap_sort</function></funcdef>
+      <paramdef> int <parameter>stream</parameter></paramdef>
+      <paramdef> int <parameter>criteria</parameter></paramdef>
+      <paramdef> int <parameter>reverse</parameter></paramdef>
+      <paramdef> int <parameter>options</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
     <para> 
-     指定した<parameter> text</parameter>を
-     (<ulink url="&url.rfc;rfc2044.html"> RFC2044</ulink>で定義された)
-     UTF8に変換します。
+     指定したパラメータによりソートされたメッセージ番号の配列ã‚
’
+     返します。
+    </para> 
+    <para> 
+     逆順にソートする場合は、reverse を 1 にします。
+    </para> 
+    <para> 
+     criteria は、次のどれかとします。(一つのみ)
+     <informalexample> 
+      <literallayout> 
+SORTDATE        メッセージの日付
+SORTARRIVAL     到着日付
+SORTFROM        最初の From アドレスのメールボックス
+SORTSUBJECT     メッセージ Subject
+SORTTO          最初の To アドレスのメールボックス
+SORTCC          最初の cc アドレスのメールボックス
+SORTSIZE        メッセージのサイズ
+      </literallayout> 
+     </informalexample> 
+    </para> 
+     <para> 
+     フラグはビットマスクであり、次の組み合わせとjります。
+     <informalexample> 
+      <literallayout> 
+SE_UID          シーケンス番号の変わりに UID を返す
+SE_NOPREFETCH   検索したメッセージを事前取得しない
+      </literallayout> 
+     </informalexample> 
     </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-fetch-overview"> 
+  <refentry id="function.imap-status"> 
    <refnamediv> 
-    <refname> imap_fetch_overview</refname>
+    <refname> imap_status</refname>
     <refpurpose> 
-     指定したメッセージのヘッダ情報の概要を読む
+     現在のメールボックス以外のメールボックスのステータス情報ã‚
’返す
     </refpurpose> 
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> array <function>imap_fetch_overview</function></funcdef>
+      <funcdef> object <function>imap_status</function></funcdef>
       <paramdef> int <parameter>imap_stream</parameter></paramdef>
-      <paramdef> string <parameter>sequence</parameter></paramdef>
+      <paramdef> string <parameter>mailbox</parameter></paramdef>
+      <paramdef> int <parameter>options</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
     <para> 
-     この関数はメールヘッダを取得し、その内容の概要を返しますã€
‚
-     オブジェクトの配列を返します。
-     各ヘッダを次のように記述するオブジェクトの配列を返しますã€
‚
+     この関数は、ステータス情報を有するオブジェクトを返しますã€
‚
+     有効なフラグは次のようになります。
      <itemizedlist> 
       <listitem> 
-       <simpara> 
-        subject - メッセージの題名(subject)
-       </simpara> 
-      </listitem> 
-      <listitem> 
-       <simpara> 
-        from - 送信者
-       </simpara> 
-      </listitem> 
-      <listitem> 
-       <simpara> 
-        date - 送信日
-       </simpara> 
-      </listitem> 
-      <listitem> 
-       <simpara> 
-        message_id - メッセージID 
-       </simpara> 
-      </listitem> 
-      <listitem> 
-       <simpara> 
-        references - このメッセージIDへのリファレンス
-       </simpara> 
-      </listitem> 
-      <listitem> 
-       <simpara> 
-        size - サイズ(バイト数)
-       </simpara> 
-      </listitem> 
-      <listitem> 
-       <simpara> 
-        uid - メールボックスにおけるこのメッセージのUID
-       </simpara> 
-      </listitem> 
-      <listitem> 
-       <simpara> 
-        msgno - メールボックスにおけるこのメッセージのメッセージ番
号
-       </simpara> 
-      </listitem> 
-      <listitem> 
        <simpara> 
-        recent - このメッセージのrecentフラグの有無
+        SA_MESSAGES - status-> messages にメールボックスのメッセージ数を設å
®šã™ã‚‹
        </simpara> 
       </listitem> 
       <listitem> 
        <simpara> 
-        flagged -  このメッセージのフラグの有無
+        SA_RECENT - status-> recent にメールボックスの最近のメッセージ数ã‚
’設定する
        </simpara> 
       </listitem> 
       <listitem> 
        <simpara> 
-        answered -  このメッセージの返信済フラグの有無
+        SA_UNSEEN - status-> unseen にメールボックスの未読の(新規)メッセー
ジ数を
+	            設定する
        </simpara> 
       </listitem> 
       <listitem> 
        <simpara> 
-        deleted -  このメッセージの削除フラグの有無
+        SA_UIDNEXT - status-> uidnext にメールボックスの次のUIDを設定する
        </simpara> 
       </listitem> 
       <listitem> 
        <simpara> 
-        seen -  こ?áッセージの既読フラグの有無
+        SA_UIDVALIDITY - メールボックスのUIDがもはや有効ではない場合に
変化する
+	                 定数を status-> uidvalidity に設定する
        </simpara> 
       </listitem> 
       <listitem> 
        <simpara> 
-        draft -  このメッセージのドラフトフラグの有無
+        SA_ALL - 上記のものを全f設定する
        </simpara> 
       </listitem> 
      </itemizedlist> 
     </para> 
     <para> 
+      status-> flags にも上記の各定数に対するビットマスクが
+      設定されます。
+    </para> 
+    <para> 
      <example> 
-      <title> <function>imap_fetch_overview</function> の例</title>
+      <title> <function>imap_status</function> の例</title>
       <programlisting role="php"> 
-$mbox = imap_open ("{your.imap.host:143}","username","password")
-     || die("can't connect: ".imap_last_error());
- 
-$overview = imap_fetch_overview ($mbox,"2,4:6",0);
+$mbox = imap_open("{your.imap.host}","username","password",OP_HALFOPEN)
+      || die("can't connect: ".imap_last_error());
  
-if(is_array($overview)) {
-        reset($overview);
-        while( list($key,$val) = each($overview)) {
-                print     $val-> msgno
-                . " - " . $val-> date
-                . " - " . $val-> subject
-                . "\n";
-        }
-}
+$status = imap_status($mbox,"{your.imap.host}INBOX",SA_ALL);
+if($status) {
+  print("Messages:   ". $status-> messages   )."&lt;br>\n";
+  print("Recent:     ". $status-> recent     )."&lt;br>\n";
+  print("Unseen:     ". $status-> unseen     )."&lt;br>\n";
+  print("UIDnext:    ". $status-> uidnext    )."&lt;br>\n";
+  print("UIDvalidity:". $status-> uidvalidity)."&lt;br>\n"; 
+} else
+  print "imap_status failed: ".imap_lasterror()."\n";
  
-imap_close ($mbox);
+imap_close($mbox);
       </programlisting> 
      </example> 
     </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-mime-header-decode"> 
+  <refentry id="function.imap-subscribe"> 
    <refnamediv> 
-    <refname> imap_mime_header_decode</refname>
-    <refpurpose> MIMEヘッダーエレメントをデコードする</refpurpose>
+    <refname> imap_subscribe</refname>
+    <refpurpose> メールボックスの購読</refpurpose>
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> array <function>imap_header_decode</function></funcdef>
-      <paramdef> string <parameter>text</parameter></paramdef>
+      <funcdef> int <function>imap_subscribe</function></funcdef>
+      <paramdef> int <parameter>imap_stream</parameter></paramdef>
+      <paramdef> string <parameter>mbox</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
+    <para>   
+     新規メールボックスを購読します。
+    </para> 
     <para> 
-     関数<function> imap_mime_header_decode</function>は、非ASCIIテキス
-     トのMIMEメッセージヘッダエクステンションをデコードします。
-     (<ulink url="&url.rfc;rfc2047.html"> RFC2047</ulink>を参照下さい) 
-     デコードされた要素は、オブジェクトの配列で返されます。
-     ただし、各オブジェクトは二つのプロパティ"charset"と"text"を有ã
—ています。
-     要素がエンコードされていない場合、言い替えるとプレーンなUS
-ASCIIの場合、
-     この要素の"charset"プロパティは"default"に設定されます。
+     成功するとtrue、失敗するとfalseを返します。
     </para> 
+   </refsect1> 
+  </refentry> 
+
+  <refentry id="function.imap-uid"> 
+   <refnamediv> 
+    <refname> imap_uid</refname>
+    <refpurpose> 
+     指定したメッセージシーケンス番号の UID を返す
+    </refpurpose> 
+   </refnamediv> 
+   <refsect1> 
+    <title> 説明</title>
+    <funcsynopsis> 
+     <funcprototype> 
+      <funcdef> int <function>imap_uid</function></funcdef>
+      <paramdef> int <parameter>imap_stream</parameter></paramdef>
+      <paramdef> int <parameter>msgno</parameter></paramdef>
+     </funcprototype> 
+    </funcsynopsis> 
     <para> 
-     <example> 
-      <title> <function>imap_mime_header_decode</function>の例</title>
-      <programlisting role="php"> 
-$text="=?ISO-8859-1?Q?Keld_J=F8rn_Simonsen?= &lt;keld@[...].dk> ";
+     この関数は、指定したメッセージシーケンス番号の UID を返しま
す。
+     メッセージ番号はメールボックスの内容を変更する度に変わるå
¯èƒ½æ€§ãŒ
+     ありますが、UIDはユニークなIDであり時間が経過しても変わりま
せん。
+     この関数は、<function> imap_msgno</function> の逆関数です。
+    </para> 
+   </refsect1> 
+  </refentry>      
 
-$elements=imap_mime_header_decode($text);
-for($i=0;$i&lt;count($elements);$i++) {
-	echo "Charset: {$elements[$i]-> charset}\n";
-	echo "Text: {$elements[$i]-> text}\n\n";
-}
+  <refentry id="function.imap-undelete"> 
+   <refnamediv> 
+    <refname> imap_undelete</refname>
+    <refpurpose> 削除マークがついているメッセージのマークをはずす</r
efpurpose> 
+   </refnamediv> 
+   <refsect1> 
+    <title> 説明</title>
+    <funcsynopsis> 
+     <funcprototype> 
+      <funcdef> int <function>imap_undelete</function></funcdef>
+      <paramdef> int <parameter>imap_stream</parameter></paramdef>
+      <paramdef> int <parameter>msg_number</parameter></paramdef>
+     </funcprototype> 
+    </funcsynopsis> 
+    <para>   
+     この関数は、<function> imap_delete</function>または
+     <function> imap_mail_move</function>によりセットされた指定されたメッ
+     セージの削除フラグをはずします。
+    </para> 
+    <para> 
+     成功するとtrue、失敗するとfalseを返します。
+    </para> 
+   </refsect1> 
+  </refentry> 
 
-      </programlisting> 
-     </example> 
+  <refentry id="function.imap-unsubscribe"> 
+   <refnamediv> 
+    <refname> imap_unsubscribe</refname>
+    <refpurpose> メールボックスの購読をやめる</refpurpose>
+   </refnamediv> 
+   <refsect1> 
+    <title> 説明</title>
+    <funcsynopsis> 
+     <funcprototype> 
+      <funcdef> int <function>imap_unsubscribe</function></funcdef>
+      <paramdef> int <parameter>imap_stream</parameter></paramdef>
+      <paramdef> string <parameter>mbox</parameter></paramdef>
+     </funcprototype> 
+    </funcsynopsis> 
+    <para> 
+     指定されたメールボックスの購読を中止します。
     </para> 
     <para> 
-     上の例には二つの要素があります。最初の要素はISO-8859-1、
-     2番目の要素はプレーンなUS-ASCIIで事前にエンコードされていまã
™ã€‚
+     成功するとtrue、失敗するとfalseを返します。
+    </para> 
+   </refsect1> 
+  </refentry>    
+
+  <refentry id="function.imap-utf7-decode"> 
+   <refnamediv> 
+    <refname> imap_utf7_decode</refname>
+    <refpurpose> 
+     修正版UTF-7 エンコードされた文字列をデコードする
+    </refpurpose> 
+   </refnamediv> 
+   <refsect1> 
+    <title> 説明</title>
+    <funcsynopsis> 
+     <funcprototype> 
+      <funcdef> string <function>imap_utf7_decode</function></funcdef>
+      <paramdef> string <parameter>text</parameter></paramdef>
+     </funcprototype> 
+    </funcsynopsis> 
+    <para>   
+     修正版UTF-7の<parameter> text</parameter>を8ビットデータにデコード
+     します。
+    </para> 
+    <para> 
+     デコードされた8ビットデータを返します。入力文字列が有効なä
¿®æ­£ç‰ˆ
+     UTF-7文字列でない場合はfalseを返します。修正UTF-7エンコーディãƒ
³ã‚°
+     は、<ulink url="&url.rfc;rfc2060.html"> RFC 2060</ulink>, section
+     5.1.3 で定義されています。
+     (元のUTF-7は<ulink url="&url.rfc;rfc1642.html"> RFC1642</ulink>で
+     定義されています)
     </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-mail-compose"> 
+  <refentry id="function.imap-utf7-encode"> 
    <refnamediv> 
-    <refname> imap_mail_compose</refname>
+    <refname> imap_utf7_encode</refname>
     <refpurpose> 
-     指定したエンベロープおよびボディーセクションに基づきMIMEメã
ƒƒã‚»ãƒ¼
-     ジを作成
+     8ビットデータを修正版UTF-7テキストにに変換する
     </refpurpose> 
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> string <function>imap_mail_compose</function></funcdef>
-      <paramdef> array <parameter>envelope</parameter></paramdef>
-      <paramdef> array <parameter>body</parameter></paramdef>
+      <funcdef> string <function>imap_utf7_encode</function></funcdef>
+      <paramdef> string <parameter>data</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
     <para> 
+     8ビットデータの<parameter> data</parameter>を修正版UTF-7テキスト
+     に変換します。修正版UTF-7エンコードは
+     <ulink url="&url.rfc;rfc2060.html"> RFC 2060</ulink>, section 5.1.3 
+     で定義されています。(オリジナルのUTF-7は<ulink
+     url="&url.rfc;rfc1642.html"> RFC1642</ulink>で定義されています)
     </para> 
     <para> 
-     <example> 
-      <title> <function>imap_mail_compose</function> の例</title>
-      <programlisting role="php"> 
-&lt;?php
-
-$envelope["from"]="musone@afterfive.com";
-$envelope["to"]="musone@darkstar";
-$envelope["cc"]="musone@edgeglobal.com";
-
-$part1["type"]=TYPEMULTIPART;
-$part1["subtype"]="mixed";
-
-$filename="/tmp/imap.c.gz";
-$fp=fopen($filename,"r");
-$contents=fread($fp,filesize($filename));
-fclose($fp);
-
-$part2["type"]=TYPEAPPLICATION;
-$part2["encoding"]=ENCBINARY;
-$part2["subtype"]="octet-stream";
-$part2["description"]=basename($filename);
-$part2["contents.data"]=$contents;
-
-$part3["type"]=TYPETEXT;
-$part3["subtype"]="plain";
-$part3["description"]="description3";
-$part3["contents.data"]="contents.data3\n\n\n\t";
-
-$body[1]=$part1;
-$body[2]=$part2;
-$body[3]=$part3;
-
-echo nl2br(imap_mail_compose($envelope,$body));
-
-?&gt;
-      </programlisting> 
-     </example> 
+     修正版UTF-7のテキストを返します。
     </para> 
    </refsect1> 
   </refentry> 
 
-  <refentry id="function.imap-mail"> 
+  <refentry id="function.imap-utf8"> 
    <refnamediv> 
-    <refname> imap_mail</refname>
+    <refname> imap_utf8</refname>
     <refpurpose> 
-     e-mailメッセージを送信する
+      テキストをUTF8に変換する
     </refpurpose> 
    </refnamediv> 
    <refsect1> 
     <title> 説明</title>
     <funcsynopsis> 
      <funcprototype> 
-      <funcdef> string <function>imap_mail</function></funcdef>
-      <paramdef> string <parameter>to</parameter></paramdef>
-      <paramdef> string <parameter>subject</parameter></paramdef>
-      <paramdef> string <parameter>message</parameter></paramdef>
-      <paramdef> string 
-       <parameter> 
-	<replaceable> <optional>additional_headers</optional></replaceable>
-       </parameter> 
-      </paramdef> 
-      <paramdef> string 
-       <parameter> 
-	<replaceable> <optional>cc</optional></replaceable>
-       </parameter> 
-      </paramdef> 
-      <paramdef> string 
-       <parameter> 
-	<replaceable> <optional>bcc</optional></replaceable>
-       </parameter> 
-      </paramdef> 
-      <paramdef> string 
-       <parameter> 
-	<replaceable> <optional>rpath</optional></replaceable>
-       </parameter> 
-      </paramdef> 
+      <funcdef> string <function>imap_utf8</function></funcdef>
+      <paramdef> string <parameter>text</parameter></paramdef>
      </funcprototype> 
     </funcsynopsis> 
     <para> 
-     この関数は、現在、PHP 3でのみ利用可能です。
+     指定した<parameter> text</parameter>を
+     (<ulink url="&url.rfc;rfc2044.html"> RFC2044</ulink>で定義された)
+     UTF8に変換します。
     </para> 
    </refsect1> 
   </refentry> 
Index: phpdoc/ja/functions/strings.xml
diff -u phpdoc/ja/functions/strings.xml:1.31 phpdoc/ja/functions/strings.xml:1.32
--- phpdoc/ja/functions/strings.xml:1.31	Wed Mar 28 05:45:34 2001
+++ phpdoc/ja/functions/strings.xml	Thu Apr 12 08:30:00 2001
@@ -1947,8 +1947,52 @@
       </listitem> 
      </orderedlist> 
     </para> 
+    <para> 
+     PHP バージョン 4.0.6 でフォーマット文字列で引数の番号付け/交æ
›ãŒ
+     サポートされました。以下に例を示します。
+     <example> 
+      <title> 引数の交換</title>
+      <programlisting role="php"> 
+$format = "There are %d monkeys in the %s";
+printf($format,$num,$location);
+      </programlisting> 
+     </example> 
+     この出力は、"There are 5 monkeys in the tree" のようになります。
+     ここで、フォーマット文字列が別のファイルにある場合を考えã
¦ã¿ã¾ã—ょ
+     う。これは、出力を国際化したりする場合に行われる可能性がã
‚ります。
+     この場合、次の書き変えられます。
+     <example> 
+      <title> 引数の交換</title>
+      <programlisting role="php"> 
+$format = "The %s contains %d monkeys";
+printf($format,$num,$location);
+      </programlisting> 
+     </example> 
+     ここで、問題が発生します。フォーマット文字列における置換æŒ
‡ç¤ºå­ã®
+     順番は、コードにおける引数の順番と一致していません。コーãƒ
‰ã¯å¤‰æ›´
+     せず、置換指示子が参照するフォーマット文字列で指示を行うæ–
¹ãŒæœ›ã¾
+     しいと言えます。フォーマット文字列を次のように書き換えてã
¿ã¾ã—ょ
+     う。
+     <example> 
+      <title> 引数の交換</title>
+      <programlisting role="php"> 
+$format = "The %2\$s contains %1\$d monkeys";
+printf($format,$num,$location);
+      </programlisting> 
+     </example> 
+     加えて、これによりコードに引数を追加せずに置換指示子を複æ•
°å›žä½¿ç”¨
+     することも可能になります。例えば、次のようになります。
+     <example> 
+      <title> 引数の交換</title>
+      <programlisting role="php"> 
+$format = "The %2\$s contains %1\$d monkeys.  That's a nice %2\$s full of %1\$d monkeys.";
+printf($format,$num,$location);
+      </programlisting> 
+     </example> 
+    </para> 
     <simpara> 
-     <function> printf</function>, <function>number_format</function>
+     <function> printf</function>, <function>sscanf</function>,
+     <function> fscanf</function>, <function>number_format</function>
      も参照下さい。
     </simpara> 
    </refsect1> 
@@ -1963,7 +2007,7 @@
       </programlisting> 
      </example> 
      <example> 
-      <title> sprintf: 貨幣をフォーマットする例</title>
+      <title> sprintf: 通貨をフォーマットする例</title>
       <programlisting role="php"> 
 $money1 = 68.75;
 $money2 = 54.35;
Index: phpdoc/ja/language/control-structures.xml
diff -u phpdoc/ja/language/control-structures.xml:1.16 phpdoc/ja/language/control-structures
.xml:1.17
--- phpdoc/ja/language/control-structures.xml:1.16	Sun Mar 18 08:36:45 2001
+++ phpdoc/ja/language/control-structures.xml	Thu Apr 12 08:30:01 2001
@@ -450,21 +450,29 @@
     <note> 
      <para> 
       <literal> foreach</literal>は、指定した配列自体に対してではなく、
-      そのコピーに対して処理を行うことに注意して下さい。このたã
‚ã€each
-      文のように配列のポインタ位置が変更されることはありませんã
€‚
+      そのコピーに対して処理を行うことに注意して下さい。このたã
‚ã€
+      <function> each</function> 文のように配列のポインタ位置が変更され
+      ることはなく、返される配列要素への変更は、元の配列には反æ
˜ ã•ã‚Œã¾
+      せん。
      </para> 
     </note> 
    </para> 
+   <note> 
+    <para> 
+     <literal> foreach</literal> は、'@' によりエラーメッセージ出力を抑
+     制する機能をサポートしていません。
+    </para> 
+   </note> 
    <para> 
     既にご存知かと思いますが、以下の文は機能的に等価です。
     <informalexample> 
      <programlisting role="php"> 
-reset( $arr );
-while( list( , $value ) = each( $arr ) ) {
+reset ($arr);
+while (list(, $value) = each ($arr)) {
    echo "Value: $value&lt;br&gt;\n";
 }
  
-foreach( $arr as $value ) {
+foreach ($arr as $value) {
    echo "Value: $value&lt;br&gt;\n";
 }
      </programlisting> 
@@ -472,31 +480,32 @@
     以下の文も機能的に等価です。
     <informalexample> 
      <programlisting role="php"> 
-reset( $arr );
-while( list( $key, $value ) = each( $arr ) ) {
+reset ($arr);
+while (list($key, $value) = each ($arr)) {
    echo "Key: $key; Value: $value&lt;br&gt;\n";
 }
  
-foreach( $arr as $key =&gt; $value ) {
+foreach ($arr as $key =&gt; $value) {
    echo "Key: $key; Value: $value&lt;br&gt;\n";
 }
      </programlisting> 
     </informalexample> 
    </para> 
- 
    <para> 
     使用法を示すためにその他の例を示します。
     <informalexample> 
      <programlisting role="php"> 
 /* foreach の例 1: 値のみ */
-$a = array(1, 2, 3, 17);
+
+$a = array (1, 2, 3, 17);
  
-foreach($a as $v) {
+foreach ($a as $v) {
    print "Current value of \$a: $v.\n";
 }
  
 /* foreachの例2: 値 (説明用にキーを出力) */
-$a = array(1, 2, 3, 17);
+
+$a = array (1, 2, 3, 17);
 
 $i = 0; /* 説明用 */
 
@@ -505,6 +514,7 @@
 }
  
 /* foreachの例3: キーと値 */
+
 $a = array(
    "one" =&gt; 1,
    "two" =&gt; 2,
@@ -515,6 +525,25 @@
 foreach($a as $k =&gt; $v) {
    print "\$a[$k] =&gt; $v.\n";
 }
+
+/* foreach の例4: 多次元配列 */
+
+$a[0][0] = "a";
+$a[0][1] = "b";
+$a[1][0] = "y";
+$a[1][1] = "z";
+
+foreach($a as $v1) {
+    foreach ($v1 as $v2) {
+        print "$v2\n";
+    }
+}
+
+/* foreach の例5: 動的配列
+
+foreach(array(1, 2, 3, 4, 5) as $v) {
+    print "$v\n";
+}
      </programlisting> 
     </informalexample> 
    </para> 
@@ -522,18 +551,16 @@
 
   <sect1 id="control-structures.break"> 
    <title> <literal>break</literal></title>
-  
    <simpara> 
     <literal> break</literal>が現在実行中の
     <literal> for</literal>, <literal>while</literal>, 
-    <literal> switch</literal>構造の実行を終了します。
+    <literal> foreach</literal>, <literal>switch</literal>構造の実行を
+    終了します。
    </simpara> 
-
    <simpara> 
     <literal> break</literal>では、オプションの引数で
     ネストしたループ構造を抜ける数を指定することができます。
    </simpara> 
-
    <para> 
     <informalexample> 
      <programlisting role="php"> 

--hirokawa987089404--