 |
 |
Find a programming school near you
php-documentation-list | 2000092
Date: 09/29/00
- Next message: Sebastian Bergmann: "[PHP-DOC] cvs: phpdoc /de/language references.xml"
- Previous message: Jani Taskinen: "[PHP-DOC] cvs: phpdoc /en/functions var.xml"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
hirokawa Fri Sep 29 19:01:29 2000 EDT
Modified files:
/phpdoc/en/functions aspell.xml http.xml hw.xml ifx.xml imap.xml
info.xml mysql.xml
/phpdoc/ja/appendices phpdevel.xml
/phpdoc/ja/chapters intro.xml
/phpdoc/ja/features error-handling.xml file-upload.xml
/phpdoc/ja/functions aspell.xml cpdf.xml cybercash.xml datetime.xml
http.xml hw.xml ibase.xml ifx.xml image.xml
imap.xml info.xml math.xml mysql.xml
network.xml pdf.xml posix.xml recode.xml
strings.xml swf.xml var.xml yaz.xml
/phpdoc/ja/language control-structures.xml functions.xml
operators.xml variables.xml
Log:
update translations and some cosmetic changes and fixed some typos.
Index: phpdoc/en/functions/aspell.xml
diff -u phpdoc/en/functions/aspell.xml:1.6 phpdoc/en/functions/aspell.xml:1.7
--- phpdoc/en/functions/aspell.xml:1.6 Fri Sep 8 17:30:59 2000
+++ phpdoc/en/functions/aspell.xml Fri Sep 29 19:01:26 2000
@@ -88,7 +88,7 @@
<refentry id="function.aspell-check-raw">
<refnamediv>
- <refname>aspell_check-raw</refname>
+ <refname>aspell_check_raw</refname>
<refpurpose>
Check a word without changing its case or trying to trim it
</refpurpose>
Index: phpdoc/en/functions/http.xml
diff -u phpdoc/en/functions/http.xml:1.12 phpdoc/en/functions/http.xml:1.13
--- phpdoc/en/functions/http.xml:1.12 Tue Sep 19 16:16:33 2000
+++ phpdoc/en/functions/http.xml Fri Sep 29 19:01:26 2000
@@ -87,7 +87,7 @@
<refentry id="function.headers-sent">
<refnamediv>
- <refname>header_sent</refname>
+ <refname>headers_sent</refname>
<refpurpose>Returns true if headers have been sent</refpurpose>
</refnamediv>
<refsect1>
Index: phpdoc/en/functions/hw.xml
diff -u phpdoc/en/functions/hw.xml:1.7 phpdoc/en/functions/hw.xml:1.8
--- phpdoc/en/functions/hw.xml:1.7 Mon Sep 11 02:58:51 2000
+++ phpdoc/en/functions/hw.xml Fri Sep 29 19:01:26 2000
@@ -1864,7 +1864,7 @@
<refentry id="function.hw-getusername">
<refnamediv>
- <refname>hw_Username</refname>
+ <refname>hw_getusername</refname>
<refpurpose>name of currently logged in user</refpurpose>
</refnamediv>
<refsect1>
Index: phpdoc/en/functions/ifx.xml
diff -u phpdoc/en/functions/ifx.xml:1.8 phpdoc/en/functions/ifx.xml:1.9
--- phpdoc/en/functions/ifx.xml:1.8 Fri Aug 25 22:51:06 2000
+++ phpdoc/en/functions/ifx.xml Fri Sep 29 19:01:26 2000
@@ -1319,7 +1319,7 @@
<refentry id="function.ifxus-free-slob">
<refnamediv>
- <refname>ifx_free_slob</refname>
+ <refname>ifxus_free_slob</refname>
<refpurpose>Deletes the slob object</refpurpose>
</refnamediv>
<refsect1>
Index: phpdoc/en/functions/imap.xml
diff -u phpdoc/en/functions/imap.xml:1.26 phpdoc/en/functions/imap.xml:1.27
--- phpdoc/en/functions/imap.xml:1.26 Wed Sep 27 15:10:10 2000
+++ phpdoc/en/functions/imap.xml Fri Sep 29 19:01:26 2000
@@ -921,7 +921,7 @@
</para>
<para>
<example>
- <title><function>imap_getmailboxes</function> example</title>
+ <title><function>imap_listmailbox</function> example</title>
<programlisting role="php">
$mbox = imap_open("{your.imap.host}","username","password",OP_HALFOPEN)
|| die("can't connect: ".imap_last_error());
@@ -1251,7 +1251,7 @@
'}', consists of the servers name or ip address, a protocol
secification (beginning with '/') and an optional port specifier
beginnung with ':'. The server part is mandatory in all mailbox
- parameters. Mailbos names that contain international characters
+ parameters. Mailbox names that contain international characters
besides those in the printable ASCII space have to be encoded
with <function>imap_utf7_encode</function>.
</para>
Index: phpdoc/en/functions/info.xml
diff -u phpdoc/en/functions/info.xml:1.33 phpdoc/en/functions/info.xml:1.34
--- phpdoc/en/functions/info.xml:1.33 Fri Sep 15 09:09:43 2000
+++ phpdoc/en/functions/info.xml Fri Sep 29 19:01:26 2000
@@ -49,9 +49,9 @@
</refsect1>
</refentry>
- <refentry id="function.assert_options">
+ <refentry id="function.assert-options">
<refnamediv>
- <refname>assert-options</refname>
+ <refname>assert_options</refname>
<refpurpose>Set/get the various assert flags</refpurpose>
</refnamediv>
<refsect1>
Index: phpdoc/en/functions/mysql.xml
diff -u phpdoc/en/functions/mysql.xml:1.27 phpdoc/en/functions/mysql.xml:1.28
--- phpdoc/en/functions/mysql.xml:1.27 Thu Sep 28 12:27:37 2000
+++ phpdoc/en/functions/mysql.xml Fri Sep 29 19:01:26 2000
@@ -652,10 +652,10 @@
mysql_connect ($host, $user, $password);
$result = mysql_db_query ("database","select user_id, fullname from table");
while ($row = mysql_fetch_array ($result)) {
- echo "user_id: ".$row["user_id"]."<br>\n";
- echo "user_id: ".$row[0]."<br>\n";
- echo "fullname: ".$row["fullname"]."<br>\n";
- echo "fullname: ".$row[1]."<br>\n";
+ echo "user_id: ".$row["user_id"]."<br>\n";
+ echo "user_id: ".$row[0]."<br>\n";
+ echo "fullname: ".$row["fullname"]."<br>\n";
+ echo "fullname: ".$row[1]."<br>\n";
}
mysql_free_result ($result);
?>
Index: phpdoc/ja/appendices/phpdevel.xml
diff -u phpdoc/ja/appendices/phpdevel.xml:1.4 phpdoc/ja/appendices/phpdevel.xml:1.5
--- phpdoc/ja/appendices/phpdevel.xml:1.4 Sun Jun 25 07:02:32 2000
+++ phpdoc/ja/appendices/phpdevel.xml Fri Sep 29 19:01:26 2000
@@ -4,7 +4,7 @@
<simpara></simpara>
<sect1 id="phpdevel-addfunc">
- <title>PHP3 への関数の付加</title>
+ <title>PHP 3 への関数の付加</title>
<sect2 id="phpdevel-addfunc-prototype">
<title>関数プロトタイプ</title>
<para>
@@ -212,7 +212,7 @@
このため、消費したメモリーを解放する際には注意して下さい。
</simpara>
<simpara>
- "-DDEBUG" でコンパイルした場合、PHP3 は、指定したスクリプトの実行が
+ "-DDEBUG" でコンパイルした場合、PHP 3 は、指定したスクリプトの実行が
終了した際に、emalloc() および estrdup()
で確保したが efree() でまだ開放されていない全メモリーのリストを
表示します。
@@ -718,7 +718,7 @@
<sect2 id="phpdevel-addfunc-addcfg">
<title>実行時設定命令の追加</title>
<para>
- PHP3 の機能の多くは、実行時に設定を行うことが可能です。
+ PHP 3 の機能の多くは、実行時に設定を行うことが可能です。
これらの設定用命令は、php3.ini ファイルまたは、Apache モジュール版の
場合、Apache .conf ファイルに書かれています。
この Apache .conf ファイルの中にこれらを記載することの利点は、
Index: phpdoc/ja/chapters/intro.xml
diff -u phpdoc/ja/chapters/intro.xml:1.5 phpdoc/ja/chapters/intro.xml:1.6
--- phpdoc/ja/chapters/intro.xml:1.5 Sat Sep 9 22:15:10 2000
+++ phpdoc/ja/chapters/intro.xml Fri Sep 29 19:01:26 2000
@@ -135,11 +135,11 @@
より組織的に開発を行なう体制になりました。パーサは、Zeev Suraski と
Andi Gutmans により最初から書き直され、この新たなパーサは PHP バージョン 3
の基となりました。
- 多くのユーティリティコードが PHP/FI から PHP3 に移植され、
+ 多くのユーティリティコードが PHP/FI から PHP 3 に移植され、
その多くは完全に書き直されました。
</simpara>
<simpara>
- 今日(1999半ば)、PHP/FI と PHP3 の両方が
+ 今日(1999半ば)、PHP/FI と PHP 3 の両方が
C2 セキュリティ製品である StrongHold Web サーバーや RedHat Linux といった
商用製品と共に出荷され、
<ulink url="&url.netcraft;">NetCraft</ulink>により提供される値
Index: phpdoc/ja/features/error-handling.xml
diff -u phpdoc/ja/features/error-handling.xml:1.4 phpdoc/ja/features/error-handling.xml:1.5
--- phpdoc/ja/features/error-handling.xml:1.4 Sat Sep 9 22:15:10 2000
+++ phpdoc/ja/features/error-handling.xml Fri Sep 29 19:01:26 2000
@@ -128,7 +128,7 @@
</para>
<warning>
<para>
- PHP3からPHP4にコードまたはサーバーを更新する場合、これらの設定および
+ PHP 3からPHP 4にコードまたはサーバーを更新する場合、これらの設定および
<function>error_reporting</function>のコールを確認する必要がありま
す。新しいエラー型、特にE_COMPILE_ERRORの出力を無効にしたいと思う
という人もいると思われます。これを無効にすると空の文書が出力される
Index: phpdoc/ja/features/file-upload.xml
diff -u phpdoc/ja/features/file-upload.xml:1.6 phpdoc/ja/features/file-upload.xml:1.7
--- phpdoc/ja/features/file-upload.xml:1.6 Fri Sep 15 18:27:36 2000
+++ phpdoc/ja/features/file-upload.xml Fri Sep 29 19:01:26 2000
@@ -272,7 +272,7 @@
この場合、<computeroutput>$userfile_name[0]</computeroutput> は
値 <computeroutput>review.html</computeroutput>を有し、
<computeroutput>$userfile_name[1]</computeroutput> は
- value <computeroutput>xwp.out</computeroutput> を有することになります。
+ 値 <computeroutput>xwp.out</computeroutput> を有することになります。
同様に、<computeroutput>$userfile_size[0]</computeroutput> は、
<filename>review.html</filename> のファイルサイズ、といったように
なります。
Index: phpdoc/ja/functions/aspell.xml
diff -u phpdoc/ja/functions/aspell.xml:1.4 phpdoc/ja/functions/aspell.xml:1.5
--- phpdoc/ja/functions/aspell.xml:1.4 Sun Sep 3 08:22:33 2000
+++ phpdoc/ja/functions/aspell.xml Fri Sep 29 19:01:26 2000
@@ -88,7 +88,7 @@
<refentry id="function.aspell-check-raw">
<refnamediv>
- <refname>aspell_check-raw</refname>
+ <refname>aspell_check_raw</refname>
<refpurpose>
大文字小文字の変更や削除を行うことなく、単語のチェックを行います。
</refpurpose>
Index: phpdoc/ja/functions/cpdf.xml
diff -u phpdoc/ja/functions/cpdf.xml:1.10 phpdoc/ja/functions/cpdf.xml:1.11
--- phpdoc/ja/functions/cpdf.xml:1.10 Sat Sep 9 22:15:10 2000
+++ phpdoc/ja/functions/cpdf.xml Fri Sep 29 19:01:26 2000
@@ -42,7 +42,7 @@
</simpara>
<note>
<simpara>
- 関数 <function>cpdf_set_font</function> は、PHP3 でアジア用フォント
+ 関数 <function>cpdf_set_font</function> は、PHP 3 でアジア用フォント
をサポートするために変更されました。
パラメータ encoding は、整数ではなく文字列になりました。
</simpara>
@@ -1389,7 +1389,7 @@
描きます。
</para>
<para>
- 最後のオプションのパラメータ <parameter>mode</parameter> は単位長
+ 最後のオプションのパラータ <parameter>mode</parameter> は単位長
さを定義します。0 または指定しなかった場合、そのページに指定され
たデフォルトの単位が使用されます。デフォルトの単位が指定されてい
ない場合は、座標はポストスクリプトポイントで計られます。
Index: phpdoc/ja/functions/cybercash.xml
diff -u phpdoc/ja/functions/cybercash.xml:1.2 phpdoc/ja/functions/cybercash.xml:1.3
--- phpdoc/ja/functions/cybercash.xml:1.2 Sat Jun 24 00:38:44 2000
+++ phpdoc/ja/functions/cybercash.xml Fri Sep 29 19:01:26 2000
@@ -56,40 +56,44 @@
</refsect1>
</refentry>
-
<refentry id="function.cybercash-base64-encode">
<refnamediv>
<refname>cybercash_base64_encode</refname>
- <refpurpose></refpurpose>
+ <refpurpose>BASE64エンコードを行う</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
- <funcdef>string <function>cybercash_base64_encode</function></funcdef>
+ <funcdef>string
+ <function>cybercash_base64_encode</function>
+ </funcdef>
<paramdef>string <parameter>inbuff</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
+ BASE64エンコードを行い、結果を文字列として返します。
</para>
</refsect1>
</refentry>
-
<refentry id="function.cybercash-base64-decode">
<refnamediv>
<refname>cybercash_base64_decode</refname>
- <refpurpose></refpurpose>
+ <refpurpose>BASE64デコードを行う</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
- <funcdef>string <function>cybercash_base64_decode</function></funcdef>
+ <funcdef>string
+ <function>cybercash_base64_decode</function>
+ </funcdef>
<paramdef>string <parameter>inbuff</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
+ BASE64デコードを行い、結果を文字列として返します。
</para>
</refsect1>
</refentry>
Index: phpdoc/ja/functions/datetime.xml
diff -u phpdoc/ja/functions/datetime.xml:1.13 phpdoc/ja/functions/datetime.xml:1.14
--- phpdoc/ja/functions/datetime.xml:1.13 Fri Sep 15 18:27:36 2000
+++ phpdoc/ja/functions/datetime.xml Fri Sep 29 19:01:26 2000
@@ -34,9 +34,9 @@
</listitem>
<listitem>
<simpara>
- <parameter>day</parameter>が指定された月(<parameter>month</parameter>)
- の日数以内に収まること。うるう年(<parameter>year</parameter>)
- も考慮の対象となります。
+ <parameter>day</parameter>が指定された月
+ (<parameter>month</parameter>)の日数以内に収まること。うるう年
+ (<parameter>year</parameter>)も考慮の対象となります。
</simpara>
</listitem>
</itemizedlist>
@@ -82,7 +82,8 @@
</listitem>
<listitem>
<simpara>
- d - 日。2桁の数字 (先頭にゼロが付く場合も)。すなわち、"01"から"31"まで
+ d - 日。2桁の数字 (先頭にゼロが付く場合も)。すなわち、"01"から
+ "31"まで
</simpara>
</listitem>
<listitem>
@@ -204,19 +205,17 @@
フォーマット文字列中の認識されない文字は、そのまま表示されます。
<function>gmdate()</function>で使用した場合、"Z"フォーマットは常に"0"を
返します。
-
<example>
<title><function>date</function> の例</title>
<programlisting role="php">
-print (date("l dS of F Y h:i:s A"));
-print ("July 1, 2000 is on a " . date("l", mktime(0,0,0,7,1,2000)));
+print (date ("l dS of F Y h:i:s A"));
+print ("July 1, 2000 is on a " . date ("l", mktime(0,0,0,7,1,2000)));
</programlisting>
</example>
</para>
<para>
<function>date</function> と <function>mktime</function> の
両方を用いて未来または過去の日付を知ることができます。
-
<example>
<title>
<function>date</function>と<function>mktime</function>の例
@@ -411,8 +410,8 @@
</funcprototype>
</funcsynopsis>
<para>
- 渡されるパラメータが GMT 日付を表すことを除けば <function>mktime
- </function> と同じです。
+ 指定されるパラメータが GMT 日付を表すこと以外は
+ <function>mktime</function> と同じです。
</para>
</refsect1>
</refentry>
@@ -545,7 +544,9 @@
<refentry id="function.microtime">
<refnamediv>
<refname>microtime</refname>
- <refpurpose> 現在のUNIXタイムスタンプをマイクロ秒まで返す </refpurpose>
+ <refpurpose>
+ 現在のUNIXタイムスタンプをマイクロ秒まで返す
+ </refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
@@ -559,7 +560,7 @@
文字列 "msec sec" を返します。sec は現在時刻を Unix epoch
(1970年1月1日 00:00:00)からの通算秒としたもので、msec は
マイクロ秒の部分です。この関数は、システムコール gettimeofday() を
- サポートするオペレーティング・システム上でのみ使え?Y。
+ サポートするオペレーティング・システム上でのみ使用可能です。
</para>
<para>
<function>time</function>も参照下さい。
@@ -619,21 +620,24 @@
<function>mktime</function> は入力日付の有効性を確認しており、
範囲外の入力を自動的に修正して計算してくれるので便利です。
例えば、以下の各行はいずれも文字列 "Jan-01-1998"を出力します。
-
<example>
<title><function>mktime</function>の例</title>
<programlisting>
echo date ("M-d-Y", mktime (0,0,0,12,32,1997));
echo date ("M-d-Y", mktime (0,0,0,13,1,1997));
echo date ("M-d-Y", mktime (0,0,0,1,1,1998));
+echo date ("M-d-Y", mktime (0,0,0,1,1,98));
</programlisting>
</example>
+ <parameter>year</parameter> は2桁または4桁の値を指定可能で、
+ 0-69の間の値は2000-2069に、70-99は1970-1999にマップされます。
+ (今日最も一般的なtime_tが32ビットの符号付き整数であるシステムで、
+ <parameter>year</parameter>として有効な範囲は1902から2037の間です)
</para>
<para>
- 指定した月の最後の日は次の月の -1 番目の日ではなく、
- "0" 番目の日として表すことが可能です。
- 以下の例はともに文字列
- "The last day in Feb 2000 is: 29" を出力します。
+ 指定した月の最後の日は次の月の -1 番目の日ではなく、"0" 番目の日
+ として表すことが可能です。以下の例はともに文字列"The last day in
+ Feb 2000 is: 29" を出力します。
<example>
<title>次の月の最後の日</title>
<programlisting role="php">
@@ -646,7 +650,7 @@
</example>
</para>
<simpara>
- 年、月、日をゼロとした日付は、間違っていると見なされます。
+ year、month、dayをゼロとした日付は、不正と判定されます。
(さもなくば、30.11.1999と見なされますが、この動作は奇妙です。)
</simpara>
<para>
@@ -668,7 +672,11 @@
<funcprototype>
<funcdef>string <function>strftime</function></funcdef>
<paramdef>string <parameter>format</parameter></paramdef>
- <paramdef>int <parameter>timestamp</parameter></paramdef>
+ <paramdef>int
+ <parameter>
+ <optional>timestamp</optional>
+ </parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -724,7 +732,8 @@
</listitem>
<listitem>
<simpara>
- %e - 月単位の日付を10進数で表したもの。日付が1桁の場合は、前に空白を一つ付けます。(' 1'〜'31')
+ %e - 月単位の日付を10進数で表したもの。日付が1桁の場合は、前に
+ 空白を一つ付けます。(' 1'〜'31')
</simpara>
</listitem>
<listitem>
@@ -749,7 +758,7 @@
</listitem>
<listitem>
<simpara>
- %m - 月を10進数で表現 (1から12)
+ %m - 月を10進数で表現 (01から12)
</simpara>
</listitem>
<listitem>
@@ -869,10 +878,9 @@
この例は、各ロケールがシステムにインストールされている場合に動作します。
</para>
<para>
- <function>setlocale</function>、
- <function>mktime</function>、
- <ulink url="&spec.strftime;">Open Groupによる<function>strftime()</function>の定義
- </ulink>も参照下さい。
+ <function>setlocale</function>、<function>mktime</function>、
+ <ulink url="&spec.strftime;">Open Groupによる
+ <function>strftime</function>の定義</ulink>も参照下さい。
</para>
</refsect1>
</refentry>
@@ -919,9 +927,8 @@
</funcprototype>
</funcsynopsis>
<para>
- この関数は英文形式の日付を含む文字列が指定されることを
- 期待しており、その形式からUNIXタイムスタンプへの変換を
- 試みます。
+ この関数は英文形式の日付を含む文字列が指定されることを期待してお
+ り、その形式からUNIXタイムスタンプへの変換を試みます。
<example>
<title><function>strtotime</function>の例</title>
<programlisting role="php">
Index: phpdoc/ja/functions/http.xml
diff -u phpdoc/ja/functions/http.xml:1.9 phpdoc/ja/functions/http.xml:1.10
--- phpdoc/ja/functions/http.xml:1.9 Fri Sep 15 18:27:36 2000
+++ phpdoc/ja/functions/http.xml Fri Sep 29 19:01:27 2000
@@ -84,9 +84,9 @@
</refsect1>
</refentry>
- <refentry id="function.headers-sent">
+ <refentry id="function.headers-sent">
<refnamediv>
- <refname>header_sent</refname>
+ <refname>headers_sent</refname>
<refpurpose>ヘッダーが送信されている場合に true を返す</refpurpose>
</refnamediv>
<refsect1>
@@ -178,10 +178,10 @@
</itemizedlist>
</para>
<simpara>
- PHP3において同じスクリプトで<function>setcookie</function>を複数
+ PHP 3において同じスクリプトで<function>setcookie</function>を複数
回コールした場合、逆の順番で実行されます。他のクッキーを挿入する
前にあるクッキーを削除しようとする場合、削除する前に挿入を行う必
- 要があります。PHP4では、<function>setcookie</function>を複数回コー
+ 要があります。PHP 4では、<function>setcookie</function>を複数回コー
ルした場合でもコールした順番で実行されます。
</simpara>
<para>
@@ -201,7 +201,7 @@
<title><function>setcookie</function>による削除の例</title>
<programlisting role="php">
setcookie ("TestCookie");
-// 有効期限を1分前に設定する
+// 有効期限を1時間前に設定する
setcookie ("TestCookie", "", time() - 3600);
setcookie ("TestCookie", "", time() - 3600, "/~rasmus/", ".utoronto.ca", 1);
</programlisting>
Index: phpdoc/ja/functions/hw.xml
diff -u phpdoc/ja/functions/hw.xml:1.6 phpdoc/ja/functions/hw.xml:1.7
--- phpdoc/ja/functions/hw.xml:1.6 Fri Sep 15 18:27:36 2000
+++ phpdoc/ja/functions/hw.xml Fri Sep 29 19:01:27 2000
@@ -275,7 +275,7 @@
Apache の書換エンジンを使用した場合、若干の改善が見込まれます。
ユーザーの立場で見ると、URL
<systemitem role="url">http://your.hostname/name_of_object>
- がオブジ?トを返せば、より簡単となります。書き換えの規則は、か
+ がオブジ?Èを返せば、より簡単となります。書き換えの規則は、か
なり簡単です。
<informalexample>
<programlisting role="apache-conf">
@@ -1070,7 +1070,7 @@
構成されたリンクが得られます。
この動作は、Web アプリケーションには、便利です。
あるリンクが、名前 'internet_movie' を有するオブジェクトを指す
- 場合、HTML リンクは、<A HREF="/internet_movie"> とな?ます。
+ 場合、HTML リンクは、<A HREF="/internet_movie"> とな?ます
ドキュメンÈ階層におけるリンク元およびリンク先のオブジェクトの
実際の位置は無視されます。Web サーバーを設定し、URL を
例えば、 '/my_script.php3/internet_movie' に書き変える必要があります。
@@ -1136,7 +1136,7 @@
<refentry id="function.hw-getobjectbyqueryobj">
<refnamediv>
<refname>hw_GetObjectByQueryObj</refname>
- <refpurpose>オブジェクトを索する</refpurpose>
+ <refpurpose>オブジェクトを朧Ԣする</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
@@ -1524,7 +1524,7 @@
Hyperwavve オブジェクトとすることができます。
オブジェクトは、全ての有効な Hyperwave オブジェクトとすることが
可能です。
- パラメータに関する詳細な情報を説明するは、
+ パラメータに関する詳細な情報を説明するっo、
HG-CSP ドキュメントを参照下さい。</para>
<para>
注意: アンカーを挿入したい場合、属性 Position
@@ -1789,7 +1789,7 @@
現在、'Title', 'Description', 'Keyword' のみが適正に処理されます。
他の多重属性は、添字配列となります。この左側の部分は、2文字分の長
さとする必要があります。接頭辞のない他の多値属性は添字配列とっ?
- ます。オプションのパラメータに属性 'Title'が指定されない場合、'
+ ま。オプションのパラメータに属性 'Title'が指定されない場合、'
Description'と'Keyword'は、言語属性として処理され、属性
'Group'、'Parent'、'HtmlAttr'は接頭辞のない多値属性として処理され
ます。各属性の型を有する配列を指定することにより、この動作を変更
@@ -1869,7 +1869,7 @@
オブジェクト ID <parameter>objectID</parameter> を有する
Hyperwave ドキュメントを返します。
ドキュメントが、挿入?能なアンカーを有している場合、
- 既に挿されているかもしれません。
+ 既に挿奣Uれているかもしれません。
ドキュメントは、制御用接続をブロックしない特別なデータ接続により
伝達されます。</para>
<para>
@@ -1947,7 +1947,7 @@
<refentry id="function.hw-getusername">
<refnamediv>
- <refname>hw_Username</refname>
+ <refname>hw_getusername</refname>
<refpurpose>現在ログインしているユーザーの名前</refpurpose>
</refnamediv>
<refsect1>
@@ -1959,7 +1959,8 @@
</funcprototype>
</funcsynopsis>
<para>
- 接続のユーザー名を返します。</para>
+ 接続を行っているユーザー名を返します。
+ </para>
</refsect1>
</refentry>
Index: phpdoc/ja/functions/ibase.xml
diff -u phpdoc/ja/functions/ibase.xml:1.8 phpdoc/ja/functions/ibase.xml:1.9
--- phpdoc/ja/functions/ibase.xml:1.8 Fri Aug 18 23:13:32 2000
+++ phpdoc/ja/functions/ibase.xml Fri Sep 29 19:01:27 2000
@@ -91,18 +91,18 @@
</para>
<note>
<para>
- <parameter>buffers</parameter>はPHP4-RC2で追加されました。
+ <parameter>buffers</parameter>はPHP 4-RC2で追加されました。
</para>
</note>
<note>
<para>
- <parameter>dialect</parameter>はPHP4-RC2で追加されました。
+ <parameter>dialect</parameter>はPHP 4-RC2で追加されました。
このオプションは、InterBase 6以降でのみ使用可能です。
</para>
</note>
<note>
<para>
- <parameter>role</parameter>はPHP4-RC2で追加されました。
+ <parameter>role</parameter>はPHP 4-RC2で追加されました。
この機能は、InterBase 5以降でのみ使用可能です。
</para>
</note>
@@ -450,9 +450,9 @@
</note>
<note>
<para>
- PHP4.0では、PHP設定ディレクティブibase.timeformatがibase.timestampformatに
+ PHP 4.0では、PHP設定ディレクティブibase.timeformatがibase.timestampformatに
名前が変更され、ディレクティブibase.dateformatとibase.timeformatが
- 追加され、過去のバージョンとの互換性がない変更が行われています。
+ 追加され、過去のバージョンとの互性がない変更が行われています。
この変更は、ディレクティブの名前がそれ自体の機能により一致するように
行われたものです。
</para>
@@ -502,7 +502,7 @@
</para>
<note>
<para>
- <function>ibase_num_fields</function>は現在、PHP4では動作しません。
+ <function>ibase_num_fields</function>は現在、PHP 4では動作しません。
</para>
</note>
</refsect1>
Index: phpdoc/ja/functions/ifx.xml
diff -u phpdoc/ja/functions/ifx.xml:1.4 phpdoc/ja/functions/ifx.xml:1.5
--- phpdoc/ja/functions/ifx.xml:1.4 Sat Aug 26 18:43:06 2000
+++ phpdoc/ja/functions/ifx.xml Fri Sep 29 19:01:27 2000
@@ -365,7 +365,7 @@
select でないクエリーは、"直ちに実行"されます。
IFX_SCROLL および IFX_HOLD はシンボル定数なので
引用符で括る必要はありません。
- このパラメ―タを省略した場合、カーソルは通常のシーケンャルカーソル
+ このパラメ―タを省略した場合、カーソルは通常のシーケンãルカーソル
になります。
</para><para>
どちらのタイプのクエリーにおいても、(予測または実際の数として)
@@ -747,7 +747,7 @@
各結果カラムは、オフセット 0 から始まる配列オフセットに保存されます。
カラム名がキーとなります。
</para><para>
- <function>ifx_fetch_row</function> を続けてコールした場合、結果セットの
+ <function>ifx_fetch_row</function> を続けてコールした場合、結果セッの
次の行が返されるます。
行がもうない場合は、false が返されます。
</para>
@@ -1165,7 +1165,7 @@
</funcprototype>
</funcsynopsis>
<para>
- 指定た BLOB オブジェクト ID <parameter>bid</parameter>
+ 指定っ_ BLOB オブジェクト ID <parameter>bid</parameter>
に関する BLOB オブジェクトの内容を更新します。
<parameter>content</parameter> は、新規データの文字列です。
エラーの場合に FALSE、それ以外の場合に TRUE を返します。
@@ -1230,7 +1230,7 @@
</funcsynopsis>
<para>
全ての select クエリーに関するデフォルトのバイトモードを設定します。
- モード "0" は、BLOB ID を返し、モード "1" がテキストの内容を有する
+ モード "0" はBLOB ID を返し、モード "1" がテキストの内容を有する
varchar を返します。
</para>
</refsect1>
@@ -1283,7 +1283,7 @@
<refentry id="function.ifxus-free-slob">
<refnamediv>
- <refname>ifx_free_slob</refname>
+ <refname>ifxus_free_slob</refname>
<refpurpose>SLOB オブジェクトを削除する</refpurpose>
</refnamediv>
<refsect1>
Index: phpdoc/ja/functions/image.xml
diff -u phpdoc/ja/functions/image.xml:1.13 phpdoc/ja/functions/image.xml:1.14
--- phpdoc/ja/functions/image.xml:1.13 Fri Aug 18 23:13:32 2000
+++ phpdoc/ja/functions/image.xml Fri Sep 29 19:01:27 2000
@@ -1315,7 +1315,7 @@
角度が0度の場合、全ての方向に1ピクセル分多く必要であると予想することができます。
</para>
<para>
- この関o次の要素を有する配列を返します。
+ この関次の要素を有する配列を返します。
<informaltable>
<tgroup cols="2">
<tbody>
@@ -2072,7 +2072,7 @@
<para>
<note>
<simpara>
- この関数は、--enable-exifを使用してコンパイルしたPHP4でのみ利用
+ この関数は、--enable-exifを使用してコンパイルしたPHP 4でのみ利用
可能です。
</simpara>
<simpara>
Index: phpdoc/ja/functions/imap.xml
diff -u phpdoc/ja/functions/imap.xml:1.13 phpdoc/ja/functions/imap.xml:1.14
--- phpdoc/ja/functions/imap.xml:1.13 Mon Aug 7 21:28:30 2000
+++ phpdoc/ja/functions/imap.xml Fri Sep 29 19:01:27 2000
@@ -4,9 +4,9 @@
<partintro>
<simpara>
- これらの関数を動作させるには、<option role="configure">--with-imap</option>
- を付けて PHP をコンパイルする必要があります。
- この際に、C クライアントライブラリが必要となります。
+ これらの関数を動作させるには、<option
+ role="configure">--with-imap</option>を付けて PHP をコンパイルする
+ 必要があります。この際に、C クライアントライブラリが必要となります。
最新版を <ulink url="&url.imap;">&url.imap;</ulink>から取得し、
コンパイルして下さい。
その後、<filename>c-client/c-client.a</filename>を<filename>
@@ -17,17 +17,18 @@
他のディレクトリにコピーして下さい。
</simpara>
<simpara>
- IMAP関数がサポートするのは、その名前から連想されるようにIMAPプロトコルに
- 限定されているわけではないということに注意して下さい。
- 実際の処理を行うCクライアントライブラリは、<acronym>NNTP</acronym>、
- <acronym>POP3</acronym>、ローカルなメールボックスへのアクセスもサポート
- しています。
+ IMAP関数がサポートするのは、その名前から連想されるようにIMAPプロト
+ コルに限定されているわけではないということに注意して下さい。実際の
+ 処理を行うCクライアントライブラリは、<acronym>NNTP</acronym>、
+ <acronym>POP3</acronym>、ローカルなメールボックスへのアクセスもサ
+ ポートしています。
</simpara>
<para>
- この文書では、提供される関数に関する全ての話題の詳細について立ち入ることは
- できません。より詳細な情報については、Cクライアントライブラリのソースに付属する
- ドキュメント(<filename>docs/internal.txt</filename>)および以下のRFCドキュメント
- で提供されています。
+ この文書では、提供される関数に関する全ての話題の詳細について立ち入
+ ることはできません。より詳細な情報については、Cクライアントライブ
+ ラリのソースに付属するドキュメント
+ (<filename>docs/internal.txt</filename>)および以下のRFCドキュメン
+ トで提供されています。
<itemizedlist>
<listitem>
<simpara>
@@ -77,8 +78,9 @@
</listitem>
</itemizedlist>
詳しい概観については、David Woodによる本
- <ulink url="&url.email.book;">Programming Internet Email</ulink>
- でも得ることができます。
+ <ulink url="&url.email.book;">Programming Internet Email</ulink>
+ や Dianna Mullet と Kevin Mullet による<ulink
+ url="&url.imap.book;">Managing IMAP</ulink>でも得ることができます。
</para>
</partintro>
@@ -112,8 +114,8 @@
<parameter>flags</parameter> もそのメールボックスに書きこまれます。
</para>
<para>
- Cyrus IMAP サーバーと通信する際には、改行コードとして "\n" の替わりに
- "\r\n" と使用する必要があります。さもなくば、操作は失敗します。
+ Cyrus IMAP サーバーと通信する際には、改行コードとして "\n" の替わ
+ りに"\r\n" と使用する必要があります。さもなくば、操作は失敗します。
</para>
<para>
<example>
@@ -158,11 +160,10 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>imap_base64</function> 関数は、BASE64 でエンコードされた
- テキストをデコードします。
- (<ulink url="&url.rfc;rfc2045.html">RFC2045</ulink>
- , Section 6.8を参照下さい。)
- デコードされたメッセージは文字列として返されます。
+ <function>imap_base64</function> 関数は、BASE64 でエンコードされ
+ たテキストをデコードします。(<ulink
+ url="&url.rfc;rfc2045.html">RFC2045</ulink>, Section 6.8を参照下
+ さい。)デコードされたメッセージは文字列として返されます。
</para>
<para>
<function>imap_binary</function>も参照下さい。
@@ -188,28 +189,36 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>imap_body</function>は、現在のメールボックスにある
- <parameter>msg_number</parameter> 番目のメッセージの本文を返します。
- オプションの <parameter>flags</parameter> はビットマスクであり、
- 以下の要素の組み合わせとなってます。
- <itemizedlist>
- <listitem>
- <simpara>
- FT_UID - <parameter>msgno</parameter>はUIDです
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- FT_PEEK - 既に設定されていない場合、\Seen フラグを設定しない
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- FT_INTERNAL - 内部フォーマットで文字列を返す。CRLF には適用されない。
- </simpara>
- </listitem>
- </itemizedlist>
- </para>
+ <function>imap_body</function>は、現在のメールボックスにある
+ <parameter>msg_number</parameter> 番目のメッセージの本文を返します。
+ オプションの <parameter>flags</parameter> はビットマスクであり、
+ 以下の要素の組み合わせとなってます。
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ FT_UID - <parameter>msgno</parameter>はUIDです
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ FT_PEEK - 既に設定されていない場合、\Seen フラグを設定しない
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ FT_INTERNAL - 内部フォーマットで文字列を返す。CRLF には適用されない。
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ <function>imap_body</function> は、メッセージボディーと全く同じコ
+ ピーのみを返します。マルチパートMIMEエンコードされたメッセージの
+ 一部を展開するには、その構造を解析するために
+ <function>imap_fetch_structure</function>を使用し、単一のボディー
+ 要素のコピーを展開する際には、
+ <function>imap_fetch_body</function>を使用する必要があります。
+ </para>
</refsect1>
</refentry>
@@ -308,9 +317,9 @@
</funcsynopsis>
<para>
<function>imap_createmailbox</function>は<parameter>mbox</parameter>
- で指定された新しいメールボックスを作成します。
- この名前に国際化文字を含む場合には、<function>imap_utf7_encode</function>
- でエンコードする必要があります。
+ で指定された新しいメールボックスを作成します。この名前に国際化文
+ 字を含む場合には、<function>imap_utf7_encode</function>でエンコー
+ ドする必要があります。
</para>
<para>
成功するとtrue、失敗するとfalseを返します。
@@ -321,6 +330,56 @@
<function>imap_deletemailbox</function>,
<function>imap_open</function>も参照下さい。
</para>
+ <para>
+ <example>
+ <title><function>imap_createmailbox</function> の例</title>
+ <programlisting role="php">
+$mbox = imap_open ("{your.imap.host}","username","password",OP_HALFOPEN)
+ || die ("can't connect: ".imap_last_error());
+
+$name1 = "phpnewbox";
+$name2 = imap_utf7_encode ("phpnewböx");
+
+$newname = $name1;
+
+echo "Newname will be '$name1'<br>\n";
+
+# 新規のメールボックス "phptestbox" を inbox フォルダ内に作成し、作成
+# 後にそのステータスをチェックします。最後に初期状態に戻すためにそのメー
+# ルボックスを削除します。
+if( <email protected>($mbox,imap_utf7_encode("{your.imap.host}INBOX.$newname"))) {
+ $status = <email protected>($mbox,"{your.imap.host}INBOX.$newname",SA_ALL);
+ if($status) {
+ print("your new mailbox '$name1' has the following status:<br>\n");
+ print("Messages: ". $status->messages )."<br>\n";
+ print("Recent: ". $status->recent )."<br>\n";
+ print("Unseen: ". $status->unseen )."<br>\n";
+ print("UIDnext: ". $status->uidnext )."<br>\n";
+ print("UIDvalidity:". $status->uidvalidity)."<br>\n";
+
+ if(imap_renamemailbox($mbox,"{your.imap.host}INBOX.$newname","{your.imap.host}INBOX.$name2")) {
+ echo "renamed new mailbox from '$name1' to '$name2'<br>\n";
+ $newname=$name2;
+ } else {
+ print "imap_renamemailbox on new mailbox failed: ".imap_last_error()."<br>\n";
+ }
+ } else {
+ print "imap_status on new mailbox failed: ".imap_last_error()."<br>\n";
+ }
+ if( <email protected>($mbox,"{your.imap.host}INBOX.$newname")) {
+ print "new mailbox removed to restore initial state<br>\n";
+ } else {
+ print "imap_deletemailbox on new mailbox failed: ".implode("<br>\n",imap_errors())."<br>\n";
+ }
+
+} else {
+ print "could not create new mailbox: ".implode("<br>\n",imap_errors())."<br>\n";
+}
+
+imap_close($mbox);
+ </programlisting>
+ </example>
+ </para>
</refsect1>
</refentry>
@@ -347,16 +406,16 @@
trueを返します。
</para>
<para>
- <function>imap_delete</function> 関数は、<parameter>msg_number</parameter>
- が指す削除する予定のメッセージをマークします。
- オブションのパラメータ<parameter>flags</parameter>で指定可能な
- オプションは<parameter>FT_UID</parameter>のみです。
+ <function>imap_delete</function> 関数は、
+ <parameter>msg_number</parameter>が指す削除する予定のメッセージを
+ マークします。オブションのパラメータ<parameter>flags</parameter>
+ で指定可能なオプションは<parameter>FT_UID</parameter>のみです。
このオプションは、引数<parameter>msg_number</parameter>を
<parameter>UID</parameter>として処理することを関数に指定します。
- 削除マークを付けられたメッセージは、<function>imap_expunge</function>
- がコールされるか<function>imap_close</function>にCL_EXPUNGE
- を付けてコールされるかのどちらかが行われるまでメールボックス
- に残ったままになります。
+ 削除マークを付けられたメッセージは、
+ <function>imap_expunge</function>がコールされるか
+ <function>imap_close</function>にCL_EXPUNGEを付けてコールされるか
+ のどちらかが行われるまでメールボックスに残ったままになります。
</para>
<para>
<example>
@@ -395,26 +454,28 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>imap_deletemailbox</function> は指定されたメールボックスを
- 削除します。
+ <function>imap_deletemailbox</function> は指定されたメールボック
+ スを削除します。(<parameter>mbox</parameter>名の形式については
+ <function>imap_open</function>を参照下さい)
</para>
<para>
成功するとtrue、失敗するとfalseを返します。
</para>
<para>
- <parameter>mbox</parameter>のフォーマットについては、
- <function>imap_createmailbox</function>,
- <function>imap_renamemailbox</function>,
+ <function>imap_createmailbox</function>、
+ <function>imap_renamemailbox</function>、
+ <parameter>mbox</parameter>のフォーマットについては
<function>imap_open</function>も参照下さい。
</para>
</refsect1>
</refentry>
-
<refentry id="function.imap-expunge">
<refnamediv>
<refname>imap_expunge</refname>
- <refpurpose>削除用にマークされたすべてのメッセージを削除する</refpurpose>
+ <refpurpose>
+ 削除用にマークされたすべてのメッセージを削除する
+ </refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
@@ -425,10 +486,10 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>imap_expunge</function> は、<function>imap_delete</function>,
- <function>imap_mail_move</function>,
- <function>imap_setflag_full</function>
- で削除用マークを設定されたすべてのメッセージを削除します。
+ <function>imap_expunge</function> は、
+ <function>imap_delete</function>,<function>imap_mail_move</function>,
+ <function>imap_setflag_full</function>で削除用マークを設定された
+ すべてのメッセージを削除します。
</para>
<para>
trueを返します。
@@ -509,14 +570,13 @@
</funcsynopsis>
<para>
この関数は、指定したメッセージに関するすべての構造化された情報を
- 取り出します。
- オプションのパラメータ <parameter>flags</parameter> に指定可能なのは
- <parameter>FT_UID</parameter>のみで、これは、
- 引数 <parameter>msg_number</parameter> を<parameter>UID</parameter> として
- 処理することを関数に指定するためのものです。
- 返されるオブジェクトは、MIMEの添付の各要素に類似のオブジェクトとして
- エンベロープ、内部の日付、サイズ、フラグ、本体を含んでいます。
- 返されるオブジェクトの構造は次のようになります。
+ 取り出します。オプションのパラメータ <parameter>flags</parameter>
+ に指定可能なのは<parameter>FT_UID</parameter>のみで、これは、引数
+ <parameter>msg_number</parameter> を<parameter>UID</parameter> と
+ して処理することを関数に指定するためのものです。返されるオブジェ
+ クトは、MIMEの添付の各要素に類似のオブジェクトとしてエンベロープ、
+ 内部の日付、サイズ、フラグ、本体を含んでいます。返されるオブジェ
+ クトの構造は次のようになります。
</para>
<para>
<table>
@@ -622,7 +682,7 @@
</note>
<para>
<table>
- <title>Primary body type</title>
+ <title>最初のボディーの型</title>
<tgroup cols="2">
<tbody>
<row><entry>0</entry><entry>text</entry></row>
@@ -655,16 +715,16 @@
</refsect1>
</refentry>
- <refentry id="function.imap-header">
+ <refentry id="function.imap-headerinfo">
<refnamediv>
- <refname>imap_header</refname>
+ <refname>imap_headerinfo</refname>
<refpurpose>メッセージヘッダを読み込む</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
- <funcdef>object <function>imap_header</function></funcdef>
+ <funcdef>object <function>imap_headerinfo</function></funcdef>
<paramdef>int <parameter>imap_stream</parameter></paramdef>
<paramdef>int <parameter>msg_number</parameter></paramdef>
<paramdef>int
@@ -683,7 +743,7 @@
</para>
<para>
<informalexample>
- <literallayout>
+ <literallayout>
remail,date,Date,subject,Subject,in_reply_to,message_id,newsgroups,
followup_to,references
@@ -749,12 +809,40 @@
fetchfrom (<parameter>fromlength</parameter> 文字に適合するようフォーマットされた from 行)
fetchsubject (<parameter>subjectlength</parameter> 文字に適合するようフォーマットされた subject 行)
- </literallayout>
+ </literallayout>
</informalexample>
</para>
</refsect1>
</refentry>
+ <refentry id="function.imap-header">
+ <refnamediv>
+ <refname>imap_header</refname>
+ <refpurpose>メッセージのヘッダを読む</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcdef>object <function>imap_header</function></funcdef>
+ <paramdef>int <parameter>imap_stream</parameter></paramdef>
+ <paramdef>int <parameter>msg_number</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>fromlength</optional></parameter>
+ </paramdef>
+ <paramdef>int
+ <parameter><optional>subjectlength</optional></parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter><optional>defaulthost</optional></parameter>
+ </paramdef>
+ </funcsynopsis>
+ <para>
+ この関数は、<function>imap_headerinfo</function>へのエイリアスで
+ あり、全く同様に動作します。
+ </para>
+ </refsect1>
+ </refentry>
+
<refentry id="function.imap-rfc822-parse-headers">
<refnamediv>
<refname>imap_rfc822_parse_headers</refname>
@@ -821,6 +909,25 @@
<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)."<br>\n";
+} else
+ print "imap_listmailbox failed: ".imap_last_error()."\n";
+
+imap_close($mbox);
+ </programlisting>
+ </example>
+ </para>
</refsect1>
</refentry>
@@ -885,16 +992,42 @@
</para>
<para>
<parameter>pattern</parameter> の中で使用できる特別な文字として
- '*' および '%' があります。
- '*' は、全てのメールボックスを意味します。
- <parameter>pattern</parameter> に '*' を指定した場合、
- メールボックス階層全体のリストが得られます。
- '%' は現在のレベルのみを意味します。'%' を <parameter>pattern</parameter>
- に指定した場合、トップレベルのメールボックスのみが返されます。
- UW_IMAPD を使用した場合、'~/mail/%' は ~/mail ディレクトリの全ての
- メールボックスを返しますが、そのディレクトリのサブフォルダーにある
- メールボックスは返しません。
+ '*' および '%' があります。'*' は、全てのメールボックスを意味しま
+ す。<parameter>pattern</parameter> に '*' を指定した場合、メール
+ ボックス階層全体のリストが得られます。'%' は現在のレベルのみを意
+ 味します。'%' を <parameter>pattern</parameter>に指定した場合、トッ
+ プレベルのメールボックスのみが返されます。UW_IMAPD を使用した場
+ 合、'~/mail/%' は ~/mail ディレクトリの全てのメールボックスを返し
+ ますが、そのディレクトリのサブフォルダーにあるメールボックスは返
+ しません。
+ </para>
+ <para>
+ <example>
+ <title><function>imap_getmailboxes</function> の例</title>
+ <programlisting role="php">
+$mbox = imap_open("{your.imap.host}","username","password",OP_HALFOPEN)
+ || die("can't connect: ".imap_last_error());
+
+$list = imap_getmailboxes($mbox,"{your.imap.host}","*");
+if(is_array($list)) {
+ reset($list);
+ while (list($key, $val) = each($list))
+ {
+ print "($key) ";
+ print imap_utf7_decode($val->name).",";
+ print "'".$val->delimiter."',";
+ print $val->attributes."<br>\n";
+ }
+} else
+ print "imap_getmailboxes failed: ".imap_last_error()."\n";
+
+imap_close($mbox);
+ </programlisting>
+ </example>
</para>
+ <para>
+ <function>imap_getsubscribed</function>も参照下さい。
+ </para>
</refsect1>
</refentry>
@@ -944,7 +1077,6 @@
</refsect1>
</refentry>
-
<refentry id="function.imap-mail-copy">
<refnamediv>
<refname>imap_mail_copy</refname>
@@ -970,11 +1102,10 @@
成功するとtrue、失敗するとfalseを返します。
</para>
<para>
- <parameter>msglist</parameter> で指定されたメッセージを、指定みた
- メー?Üックスにコピーします。
- <parameter>msglist</parameter> は、
- (<ulink url="&url.rfc;rfc2060.html">RFC2060</ulink>に記述されたように)
- ただのメッセージ番号ではなく、範囲を示します。
+ <parameter>msglist</parameter> で指定されたメッセージを、指定した
+ メールボックスにコピーします。<parameter>msglist</parameter> は、
+ (<ulink url="&url.rfc;rfc2060.html">RFC2060</ulink>に記述されたよ
+ うに)ただのメッセージ番号ではなく、範囲を示します。
</para>
<para>
flags はビットマスクであり、以下の組み合わせです。
@@ -997,7 +1128,9 @@
<refentry id="function.imap-mail-move">
<refnamediv>
<refname>imap_mail_move</refname>
- <refpurpose>指定されたメッセージをメールボックスに移動する </refpurpose>
+ <refpurpose>
+ 指定されたメッセージをメールボックスに移動する
+ </refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
@@ -1022,7 +1155,8 @@
メッセージの範囲を指定します。
</para>
<para>
- flagsはビットマスクであり、指定できるオプションは1つだけですり <itemizedlist>
+ flagsはビットマスクであり、指定できるオプションは1つだけです。
+ <itemizedlist>
<listitem>
<simpara>
CP_UID - シーケンス番号にUIDを含む
@@ -1039,7 +1173,9 @@
<refentry id="function.imap-num-msg">
<refnamediv>
<refname>imap_num_msg</refname>
- <refpurpose>現在のメールボックスのメッセージ数を取得する</refpurpose>
+ <refpurpose>
+ 現在のメールボックスのメッセージ数を取得する
+ </refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
@@ -1078,7 +1214,9 @@
<refentry id="function.imap-open">
<refnamediv>
<refname>imap_open</refname>
- <refpurpose>メールボックスへの IMAP ストリームのオープン</refpurpose>
+ <refpurpose>
+ メールボックスへのIMAPストリームをオープンする
+ </refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
@@ -1094,62 +1232,73 @@
</funcprototype>
</funcsynopsis>
<para>
- 成功するとIMAPストリームを返し、失敗するとfalseを返します。
- この関数は、POP3やNNTPサーバーへのストリームをオープンする際にも使用可能です。
- ローカルマシンのポート143で実行しているIMAPサーバーに接続する際には、
- 以下のようにします。
+ 成功するとIMAPストリームを返し、失敗するとfalseを返します。この関
+ 数は、POP3やNNTPサーバーへのストリームをオープンする際にも使用可
+ 能です。しかし、いくつかの関数および機能はIMAPサーバーでは利用で
+ きません。
+ </para>
+ <para>
+ メールボックス名(mailbox)は、サーバー名の部分と使用するサーバーに
+ おけるメールボックスへのパスから構成されます。特別な名前INBOXは、
+ カレントのユーザの個人メールボックスを意味します。サーバー部は'{'
+ および'}'で括られ、サーバー名または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");
+$mbox = imap_open ("{localhost:143}INBOX","user_id","password");
</programlisting>
</informalexample>
-
- ローカルマシンのポート110で実行しているPOP3サーバーに接続する際には、
+ ローカルマシンのポート110で実行しているPOP3サーバーに接続する際には、
以下のようにします。
<informalexample>
<programlisting>
-$mbox = imap_open("{localhost/pop3:110}INBOX","user_id","password");
+$mbox = imap_open ("{localhost/pop3:110}INBOX","user_id","password");
</programlisting>
</informalexample>
-
ローカルマシンのポート119で実行しているNNTPサーバーに接続する際には、
以下のようにします。
-
<informalexample>
<programlisting>
-$nntp = imap_open("{localhost/nntp:119}comp.test","","");
+$nntp = imap_open ("{localhost/nntp:119}comp.test","","");
</programlisting>
</informalexample>
-
リモートサーバーに接続するには、"localhost" を接続したいサーバーの
名前または IP アドレスに代えてください。
</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>
<example>
<title><function>imap_open</function>の例</title>
<programlisting>
@@ -1284,9 +1433,9 @@
</listitem>
<listitem>
<simpara>
- CL_EXPUNGE - メールボックスを閉じた際に、自動的にメールボックスを削除する
- (<function>imap_delete</function>および
- <function>imap_expunge</function>も参照下さい )
+ CL_EXPUNGE - メールボックスを閉じた際に、自動的にメールボック
+ スを削除する (<function>imap_delete</function>および
+ <function>imap_expunge</function>も参照下さい )
</simpara>
</listitem>
</itemizedlist>
@@ -1297,7 +1446,6 @@
</refsect1>
</refentry>
-
<refentry id="function.imap-subscribe">
<refnamediv>
<refname>imap_subscribe</refname>
@@ -1336,8 +1484,9 @@
</funcprototype>
</funcsynopsis>
<para>
- この関数は、<function>imap_delete</function>または<function>imap_mail_move
- </function>によりセットされた指定されたメッセージの削除フラグをはずします。
+ この関数は、<function>imap_delete</function>または
+ <function>imap_mail_move</function>によりセットされた指定されたメッ
+ セージの削除フラグをはずします。
</para>
<para>
成功するとtrue、失敗するとfalseを返します。
@@ -1360,9 +1509,11 @@
</funcprototype>
</funcsynopsis>
<para>
- 指定されたメールボックスの購読を中止します。</para>
+ 指定されたメールボックスの購読を中止します。
+ </para>
<para>
- 成功すると TRUE、失敗すると FALSE を返します。</para>
+ 成功するとtrue、失敗するとfalseを返します。
+ </para>
</refsect1>
</refentry>
@@ -1381,8 +1532,8 @@
</funcprototype>
</funcsynopsis>
<para>
- (<ulink url="&url.rfc;rfc2045.html">RFC2045</ulink>, section 6.7 に基づき)
- quoted-printable 文字列を 8 ビット文字列に変換します。
+ (<ulink url="&url.rfc;rfc2045.html">RFC2045</ulink>, section 6.7
+ に基づき)quoted-printable 文字列を 8 ビット文字列に変換します。
</para>
<para>
8ビット(バイナリ)文字列を返します。
@@ -1401,7 +1552,7 @@
</refpurpose>
</refnamediv>
<refsect1>
- <title>明</title>
+ <title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>imap_8bit</function></funcdef>
@@ -1409,8 +1560,8 @@
</funcprototype>
</funcsynopsis>
<para>
- (<ulink url="&url.rfc;rfc2045.html">RFC2045</ulink>, section 6.7に基づき)
- 8bit 文字列をquoted-printable文字列に変換します。
+ (<ulink url="&url.rfc;rfc2045.html">RFC2045</ulink>, section 6.7
+ に基づき)8bit 文字列をquoted-printable文字列に変換します。
</para>
<para>
quoted-printable文字列を返します。
@@ -1421,368 +1572,491 @@
</refsect1>
</refentry>
- <refentry id="function.imap-binary">
- <refnamediv>
- <refname>imap_binary</refname>
+ <refentry id="function.imap-binary">
+ <refnamediv>
+ <refname>imap_binary</refname>
<refpurpose>8ビット文字列をbase64文字列に変換する</refpurpose>
- </refnamediv>
+ </refnamediv>
<refsect1>
- <title>説明</title>
- <funcsynopsis>
+ <title>説明</title>
+ <funcsynopsis>
<funcprototype>
- <funcdef>string <function>imap_binary</function></funcdef>
- <paramdef>string <parameter>string</parameter></paramdef>
+ <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>
+ </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-scanmailbox">
- <refnamediv>
+ <refentry id="function.imap-scanmailbox">
+ <refnamediv>
<refname>imap_scanmailbox</refname>
- <refpurpose>メールボックスのリストを読み、メールボックスのテキストにおいて
- 文字列を検索する</refpurpose>
- </refnamediv>
- <refsect1>
- <title>説明</title>
- <funcsynopsis>
+ <refpurpose>
+ メールボックスのリストを読み、メールボックスのテキストにおいて
+ 文字列を検索する
+ </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>array <function>imap_scanmailbox</function></funcdef>
+ <paramdef>int <parameter>imap_stream</parameter></paramdef>
+ <paramdef>string <parameter>content</parameter></paramdef>
</funcprototype>
- </funcsynopsis>
- <para>
- メールボックスのテキストに<parameter>content</parameter>がある
- メールボックスの名前を有する配列を返します。
- この関数は<function>imap_listmailbox</function>に似ていますが、
- ]の動作以外にメールボックスのデータ中に文字列
- <parameter>content</parameter>が存在するかどうかを確認します。
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.imap-mailboxmsginfo">
- <refnamediv>
- <refname>imap_mailboxmsginfo</refname>
- <refpurpose>現在のメールボックスに関する情報を得る</refpurpose>
- </refnamediv>
- <refsect1>
- <title>説明</title>
- <funcsynopsis>
+ </funcsynopsis>
+ <para>
+ メールボックスのテキストに<parameter>content</parameter>があるメー
+ ルボックスの名前を有する配列を返します。この関数は
+ <function>imap_listmailbox</function>に似ていますが、メールボック
+ スのデータ中に文字列<parameter>content</parameter>が存在するかど
+ うかの確認も行います。
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.imap-mailboxmsginfo">
+ <refnamediv>
+ <refname>imap_mailboxmsginfo</refname>
+ <refpurpose>現在のメールボックスに関する情報を得る</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
<funcprototype>
- <funcdef>array <function>imap_mailboxmsginfo</function></funcdef>
- <paramdef>int <parameter>imap_stream</parameter></paramdef>
+ <funcdef>array <function>imap_mailboxmsginfo</function></funcdef>
+ <paramdef>int <parameter>imap_stream</parameter></paramdef>
</funcprototype>
- </funcsynopsis>
- <para>
- 現在のメールボックスに関する情報を返します。
- 失敗した場合にfalseを返します。
- </para>
- <para>
- <function>imap_mailboxmsginfo</function> 関数は、
- サーバーにおける現在のメールボックスのステータスを調べ、
- 次のプロパティを有するオブジェクトの情報を返します。
- この関数は<function>imap_status</function>に似ていますが、
- メールボックスの中の全てのメッセージのサイズを合計します。
- このため、実行時間は幾分余計にかかります。
- </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>
- </para>
- </refsect1>
- </refentry>
-
-
- <refentry id="function.imap-rfc822-write-address">
- <refnamediv>
- <refname>imap_rfc822_write_address</refname>
- <refpurpose>指定したメールボックス、ホスト、個人情報を適当にフォーマットされた電子メールアドレスにして返す</refpurpose>
- </refnamediv>
- <refsect1>
- <title>説明</title>
- <funcsynopsis>
+ </funcsynopsis>
+ <para>
+ 現在のメールボックスに関する情報を返します。
+ 失敗した場合にfalseを返します。
+ </para>
+ <para>
+ <function>imap_mailboxmsginfo</function> 関数は、
+ サーバーにおける現在のメールボックスのステータスを調べ、
+ 次のプロパティを有するオブジェクトの情報を返します。
+ この関数は<function>imap_status</function>に似ていますが、
+ メールボックスの中の全てのメッセージのサイズを合計します。
+ このため、実行時間は幾分余計にかかります。
+ </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>
+ </para>
+ <para>
+ <example>
+ <title><function>imap_mailboxmsginfo</function> の例</title>
+ <programlisting role="php">
+<?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 ."<br>\n" ;
+ print "Driver: " . $check->Driver ."<br>\n" ;
+ print "Mailbox: " . $check->Mailbox ."<br>\n" ;
+ print "Messages: ". $check->Nmsgs ."<br>\n" ;
+ print "Recent: " . $check->Recent ."<br>\n" ;
+ print "Unread: " . $check->Unread ."<br>\n" ;
+ print "Deleted: " . $check->Deleted ."<br>\n" ;
+ print "Size: " . $check->Size ."<br>\n" ;
+} else {
+ print "imap_check() failed: ".imap_lasterror(). "<br>\n";
+}
+
+imap_close($mbox);
+
+?>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.imap-rfc822-write-address">
+ <refnamediv>
+ <refname>imap_rfc822_write_address</refname>
+ <refpurpose>
+ 指定したメールボックス、ホスト、個人情報を適当にフォーマットされ
+ た電子メールアドレスにして返す
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
<funcprototype>
- <funcdef>string <function>imap_rfc822_write_address</function></funcdef>
+ <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>
+ <paramdef>string <parameter>host</parameter></paramdef>
+ <paramdef>string <parameter>personal</parameter></paramdef>
</funcprototype>
- </funcsynopsis>
- <para>
- 指定したメールボックス、ホスト、個人情報を
- <ulink url="&url.rfc;rfc822.html">RFC822</ulink>の定義に基づき
- 適当にフォーマットされた電子メールアドレスにして返します。
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.imap-rfc822-parse-adrlist">
- <refnamediv>
- <refname>imap_rfc822_parse_adrlist</refname>
- <refpurpose>アドレス文字列を解釈します</refpurpose>
- </refnamediv>
- <refsect1>
- <title>説明</title>
- <funcsynopsis>
+ </funcsynopsis>
+ <para>
+ 指定したメールボックス、ホスト、個人情報を
+ <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-rfc822-parse-adrlist">
+ <refnamediv>
+ <refname>imap_rfc822_parse_adrlist</refname>
+ <refpurpose>アドレス文字列を解釈します</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>string <function>imap_rfc822_parse_adrlist</function></funcdef>
+ <paramdef>string <parameter>address</parameter></paramdef>
+ <paramdef>string <parameter>default_host</parameter></paramdef>
</funcprototype>
- </funcsynopsis>
- <para>
- この関数は、<ulink url="&url.rfc;rfc822.html">RFC822</ulink>
- の定義に基づきアドレス文字列を解釈し、各アドレス毎にオブジェクトの
- 配列を返します。4 つのオブジェクトは、以下のようになります。
- </para>
- <para>
- <informalexample>
- <literallayout>
- mailbox - メールボックス名 (ユーザー名)
- host - ホスト名
- personal - 個人名
- adl - ドメインソースへのルート
- </literallayout>
- </informalexample></para>
- </refsect1>
- </refentry>
-
- <refentry id="function.imap-setflag-full">
- <refnamediv>
- <refname>imap_setflag_full</refname>
- <refpurpose>メッセージにフラグをセットする</refpurpose>
- </refnamediv>
- <refsect1>
- <title>説明</title>
- <funcsynopsis>
+ </funcsynopsis>
+ <para>
+ この関数は、<ulink url="&url.rfc;rfc822.html">RFC822</ulink>
+ の定義に基づきアドレス文字列を解釈し、各アドレス毎にオブジェクトの
+ 配列を返します。4 つのオブジェクトは、以下のようになります。
+ </para>
+ <para>
+ <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_rfc822_parse_adrlist</function> の例</title>
+ <programlisting role="php">
+$address_string = "Hartmut Holzgraefe <hartmut <email protected>>, postmaster <email protected>, 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."<br>\n";
+ print "host : ".$val->host."<br>\n";
+ print "personal: ".$val->personal."<br>\n";
+ print "adl : ".$val->adl."<p>\n";
+}
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.imap-setflag-full">
+ <refnamediv>
+ <refname>imap_setflag_full</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_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>
- この関数は、指定したシーケンスのメッセージのフラグに指定したフラグを
- セットし、保存します。
- The flags which you can unset are "\\Seen", "\\Answered",
- "\\Flagged", "\\Deleted", "\\Draft", and "\\Recent" ( as defined
- by RFC2060)
- </para>
- <para>
- オプションはビットマスクであり、以下の組み合わせとなります。
- <informalexample>
- <literallayout>
- ST_UID シーケンス引数はシーケンス番号の代わりに UID を含みます
- </literallayout>
- </informalexample></para>
- </refsect1>
- </refentry>
-
- <refentry id="function.imap-clearflag-full">
- <refnamediv>
- <refname>imap_clearflag_full</refname>
- <refpurpose>メッセージのフラグをクリアする</refpurpose>
- </refnamediv>
- <refsect1>
- <title>説明</title>
- <funcsynopsis>
+ </funcsynopsis>
+ <para>
+ この関数は、指定したシーケンスのメッセージのフラグに指定したフラグを
+ セットし、保存します。
+ </para>
+ <para>
+ 設定可能なフラグは、(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-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>
+ <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>
+ </funcsynopsis>
+ <para>
この関数は、指定したシーケンスのメッセージのフラグからに指定したフラグ
- を削除します。</para>
- <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>
+ <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>
+ <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>
+ </funcsynopsis>
+ <para>
指定したパラメータによりソートされたメッセージ番号の配列を
- 返します。</para>
- <para>
- 逆順にソートする場合は、reverse を 1 にします。</para>
- <para>
+ 返します。
+ </para>
+ <para>
+ 逆順にソートする場合は、reverse を 1 にします。
+ </para>
+ <para>
criteria は、次のどれかとします。(一つのみ)
<informalexample>
- <literallayout>
- SORTDATE メッセージの日付
- SORTARRIVAL 到着日付
- SORTFROM 最初の From アドレスのメールボックス
- SORTSUBJECT メッセージ Subject
- SORTTO 最初の To アドレスのメールボックス
- SORTCC 最初の cc アドレスのメールボックス
- SORTSIZE メッセージのサイズ
- </literallayout>
- </informalexample></para>
+ <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-fetchheader">
- <refnamediv>
- <refname>imap_fetchheader</refname>
- <refpurpose>メッセージのヘッダを返す</refpurpose>
- </refnamediv>
- <refsect1>
- <title>説明</title>
- <funcsynopsis>
+ <literallayout>
+SE_UID シーケンス番号の変わりに UID を返す
+SE_NOPREFETCH 検索したメッセージを事前取得しない
+ </literallayout>
+ </informalexample>
+ </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>
+ <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>
+ </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-uid">
- <refnamediv>
- <refname>imap_uid</refname>
- <refpurpose>指定したメッセージシーケンス番号の UID を返す</refpurpose>
- </refnamediv>
- <refsect1>
- <title>説明</title>
- <funcsynopsis>
+ <literallayout>
+FT_UID msgno 引数は UID である
+FT_INTERNAL 返される文字列を "internal" フォーマットとする。
+ ただし、CRLF 改行は例外とする。
+FT_PREFETCHTEXT RFC822.TEXT は同時に事前に取得する必要があります。
+ これは、メッセージテキスト全体を取得したい場合にIMAP
+ 接続において別の RTT を回避します。
+ (例えば、"ローカルファイルに保存する"操作)
+ </literallayout>
+ </informalexample>
+ </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>
+ <funcdef>int <function>imap_uid</function></funcdef>
+ <paramdef>int <parameter>imap_stream</parameter></paramdef>
+ <paramdef>int <parameter>msgno</parameter></paramdef>
</funcprototype>
- </funcsynopsis>
- <para>
- この関数は、指定したメッセージシーケンス番号の UID を返します。
- メッセージ番号はメールボックスの内容を変更する度に変わる可能性が
- ありますが、UIDはユニークなIDであり時間が経過しても変わりません。
- この関数は、<function>imap_msgno</function> の逆関数です。
- </para>
- </refsect1>
- </refentry>
-
-
- <refentry id="function.imap-msgno">
- <refnamediv>
- <refname>imap_msgno</refname>
- <refpurpose>指定したUIDのメッセージ番号を返す</refpurpose>
- </refnamediv>
- <refsect1>
- <title>説明</title>
- <funcsynopsis>
+ </funcsynopsis>
+ <para>
+ この関数は、指定したメッセージシーケンス番号の UID を返します。
+ メッセージ番号はメールボックスの内容を変更する度に変わる可能性が
+ ありますが、UIDはユニークなIDであり時間が経過しても変わりません。
+ この関数は、<function>imap_msgno</function> の逆関数です。
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.imap-msgno">
+ <refnamediv>
+ <refname>imap_msgno</refname>
+ <refpurpose>指定したUIDのメッセージ番号を返す</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
<funcprototype>
- <funcdef>int <function>imap_msgno</function></funcdef>
- <paramdef>int <parameter>imap_stream</parameter></paramdef>
- <paramdef>int <parameter>uid</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>
- この関数は、指定したUIDのメッセージ番号を返します。
- これは、<function>imap_uid</function> の逆の動作となります。</para>
- </refsect1>
- </refentry>
-
- <refentry id="function.imap-search">
- <refnamediv>
- <refname>imap_search</refname>
- <refpurpose>
- 指定した検索条件にマッチするメッセージを配列として返す
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>説明</title>
- <funcsynopsis>
+ </funcsynopsis>
+ <para>
+ この関数は、指定したUIDメッセージ番号を返します。
+ これは、<function>imap_uid</function> の逆の動作となります。
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.imap-search">
+ <refnamediv>
+ <refname>imap_search</refname>
+ <refpurpose>
+ 指定した検索条件にマッチするメッセージを配列として返す
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
<funcprototype>
- <funcdef>array <function>imap_search</function></funcdef>
- <paramdef>int <parameter>imap_stream</parameter></paramdef>
- <paramdef>string <parameter>criteria</parameter></paramdef>
- <paramdef>int <parameter>flags</parameter></paramdef>
+ <funcdef>array <function>imap_search</function></funcdef>
+ <paramdef>int <parameter>imap_stream</parameter></paramdef>
+ <paramdef>string <parameter>criteria</parameter></paramdef>
+ <paramdef>int <parameter>flags</parameter></paramdef>
</funcprototype>
- </funcsynopsis>
- <para>
- この関数は、指定した imap ストリームの現在オープンしているメール
- ボックスにおいて検索を行います。
- <parameter>criteria</parameter> は、空白で区切られた文字列で、
- 以下のキーワードが使用可能です。
- 複数語のキーワード(例 FROM "joe smith")は全て引用符で括る必要があります。
+ </funcsynopsis>
+ <para>
+ この関数は、指定した imap ストリームの現在オープンしているメール
+ ボックスにおいて検索を行います。<parameter>criteria</parameter>
+ は、空白で区切られた文字列で、以下のキーワードが使用可能です。複
+ 数語のキーワード(例 FROM "joe smith")は全て引用符で括る必要があり
+ ます。
<itemizedlist>
<listitem>
<simpara>
@@ -1821,7 +2095,7 @@
</listitem>
<listitem>
<simpara>
- FLAGGED - \\FLAGGED フラグが設定されているメッセージにマッチ
+ FLAGGED - \\FLAGGED フラグが設定されっDるメッセージにマッチ
(重要または緊急を表すものとして使用されることがあります)
</simpara>
</listitem>
@@ -1906,118 +2180,116 @@
</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>
+ </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>
+ <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>
+ </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>
+ <funcdef>array <function>imap_errors</function></funcdef>
+ <paramdef>void </paramdef>
</funcprototype>
- </funcsynopsis>
- <para>
+ </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>
+ <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>
+ <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>
+ </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>
+ <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>
+ </funcsynopsis>
+ <para>
この関数は、ステータス情報を有するオブジェクトを返します。
有効なフラグは次のようになります。
<itemizedlist>
@@ -2050,7 +2322,7 @@
</listitem>
<listitem>
<simpara>
- SA_ALL - 上記のものを全て設定する
+ SA_ALL - 上記のものを全f設定する
</simpara>
</listitem>
</itemizedlist>
@@ -2059,6 +2331,27 @@
status->flags にも上記の各定数に対するビットマスクが
設定されます。
</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 )."<br>\n";
+ print("Recent: ". $status->recent )."<br>\n";
+ print("Unseen: ". $status->unseen )."<br>\n";
+ print("UIDnext: ". $status->uidnext )."<br>\n";
+ print("UIDvalidity:". $status->uidvalidity)."<br>\n";
+} else
+ print "imap_status failed: ".imap_lasterror()."\n";
+
+imap_close($mbox);
+ </programlisting>
+ </example>
+ </para>
</refsect1>
</refentry>
@@ -2078,16 +2371,16 @@
</funcprototype>
</funcsynopsis>
<para>
- 修正版UTF-7の<parameter>text</parameter>を8ビットデータにデコードします。
+ 修正版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
- で定義されています。
+ デコードされた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>
@@ -2111,8 +2404,8 @@
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>で定義されています)
+ で定義されています。(オリジナルのUTF-7は<ulink
+ url="&url.rfc;rfc1642.html">RFC1642</ulink>で定義されています)
</para>
<para>
修正版UTF-7のテキストを返します。
@@ -2226,7 +2519,7 @@
</listitem>
<listitem>
<simpara>
- seen - このメッセージの既読フラグの有無
+ seen - こメッセージの既読フラグの有無
</simpara>
</listitem>
<listitem>
@@ -2236,6 +2529,29 @@
</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>
@@ -2253,8 +2569,8 @@
</funcprototype>
</funcsynopsis>
<para>
- 関数<function>imap_mime_header_decode</function>は、ASCIIテキストでない
- MIMEメッセージヘッダ拡張をデコードします。
+ 関数<function>imap_mime_header_decode</function>は、非ASCIIテキス
+ トのMIMEメッセージヘッダエクステンションをデコードします。
(<ulink url="&url.rfc;rfc2047.html">RFC2047</ulink>を参照下さい)
デコードされた要素は、オブジェクトの配列で返されます。
ただし、各オブジェクトは二つのプロパティ"charset"と"text"を有しています。
@@ -2277,7 +2593,7 @@
</example>
</para>
<para>
- 上の例には二つの要素を有しています。最初の要素はISO-8859-1に、
+ 上の例には二つの要素があります。最初の要素はISO-8859-1、
2番目の要素はプレーンなUS-ASCIIで事前にエンコードされています。
</para>
</refsect1>
@@ -2287,7 +2603,8 @@
<refnamediv>
<refname>imap_mail_compose</refname>
<refpurpose>
- 指定したエンベロープおよびボディーセクションに基づきMIMEメッセージを作成
+ 指定したエンベロープおよびボディーセクションに基づきMIMEメッセー
+ ジを作成
</refpurpose>
</refnamediv>
<refsect1>
@@ -2301,6 +2618,45 @@
</funcsynopsis>
<para>
</para>
+ <para>
+ <example>
+ <title><function>imap_mail_compose</function> の例</title>
+ <programlisting role="php">
+<?php
+
+$envelope["from"]="musone <email protected>";
+$envelope["to"]="musone <email protected>";
+$envelope["cc"]="musone <email protected>";
+
+$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));
+
+?>
+ </programlisting>
+ </example>
+ </para>
</refsect1>
</refentry>
@@ -2319,14 +2675,22 @@
<paramdef>string <parameter>to</parameter></paramdef>
<paramdef>string <parameter>subject</parameter></paramdef>
<paramdef>string <parameter>message</parameter></paramdef>
- <paramdef>string <parameter><optional>additional_headers</optional></parameter></paramdef>
- <paramdef>string <parameter><optional>cc</optional></parameter></paramdef>
- <paramdef>string <parameter><optional>bcc</optional></parameter></paramdef>
- <paramdef>string <parameter><optional>rpath</optional></parameter></paramdef>
+ <paramdef>string
+ <parameter><optional>additional_headers</optional></parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter><optional>cc</optional></parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter><optional>bcc</optional></parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter><optional>rpath</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
<para>
- この関数は、現在、PHP3でのみ利用可能です。
+ この関数は、現在、PHP 3でのみ利用可能です。
</para>
</refsect1>
</refentry>
Index: phpdoc/ja/functions/info.xml
diff -u phpdoc/ja/functions/info.xml:1.16 phpdoc/ja/functions/info.xml:1.17
--- phpdoc/ja/functions/info.xml:1.16 Fri Sep 15 18:27:36 2000
+++ phpdoc/ja/functions/info.xml Fri Sep 29 19:01:27 2000
@@ -50,9 +50,9 @@
</refsect1>
</refentry>
- <refentry id="function.assert_options">
+ <refentry id="function.assert-options">
<refnamediv>
- <refname>assert-options</refname>
+ <refname>assert_options</refname>
<refpurpose>様々な assert フラグを設定/取得する</refpurpose>
</refnamediv>
<refsect1>
@@ -774,7 +774,7 @@
<para>
<note>
<para>
- この機能は、PHP4 Beta 4で追加されました。
+ この機能は、PHP 4 Beta 4で追加されました。
</para>
</note>
</para>
@@ -955,7 +955,7 @@
<para>
<note>
<para>
- この機能は、PHP4 ベータ4で追加されました。
+ この機能は、PHP 4 ベータ4で追加されました。
</para>
</note>
</para>
@@ -1068,7 +1068,7 @@
</funcprototype>
</funcsynopsis>
<para>
- この関数は、<function>require_once</function>によりスクリプトにロー
+ この関数は、<function>require_once</function>によりスクリプにロー
ドされた全てのファイルの名前を連想配列として返します。
<function>require_once</function>で使用した際と同様に拡張子
".php"を除いたファイル名が配列の添字となります。
Index: phpdoc/ja/functions/math.xml
diff -u phpdoc/ja/functions/math.xml:1.10 phpdoc/ja/functions/math.xml:1.11
--- phpdoc/ja/functions/math.xml:1.10 Sun Sep 10 03:14:42 2000
+++ phpdoc/ja/functions/math.xml Fri Sep 29 19:01:27 2000
@@ -115,9 +115,9 @@
</tbody>
</tgroup>
</table>
- PHP4RC1までのバージョンのPHPでは、M_PIのみが使用可能です。他の全
+ PHP 4RC1までのバージョンのPHPでは、M_PIのみが使用可能です。他の全
ての定数は、PHP 4.0 で使用可能となりました。[4.0.2] とラベルのつい
- た定数はPHP4のCVSコードでのみ使用可能です。
+ た定数はPHP 4のCVSコードでのみ使用可能です。
</para>
</sect2>
@@ -644,7 +644,7 @@
<para>
数値の 1 つ以上が倍精度実数の場合は、全ての数値が倍精度実数として
扱われ、倍精度実数で返されます。
- 数値に倍精度実数が全く無い場合、全ては整数として扱われ、
+ 数値に倍精度実数が全く無い場合、全ては整数として扱れ、
整数を返します。
</para>
</refsect1>
Index: phpdoc/ja/functions/mysql.xml
diff -u phpdoc/ja/functions/mysql.xml:1.11 phpdoc/ja/functions/mysql.xml:1.12
--- phpdoc/ja/functions/mysql.xml:1.11 Fri Sep 15 18:27:36 2000
+++ phpdoc/ja/functions/mysql.xml Fri Sep 29 19:01:27 2000
@@ -571,7 +571,7 @@
<refnamediv>
<refname>mysql_fetch_array</refname>
<refpurpose>
- 連想配列として結果の行を取得する
+ 連想配列、添字配列、またはその両方として結果の行を取得する
</refpurpose>
</refnamediv>
<refsect1>
@@ -588,8 +588,8 @@
</funcprototype>
</funcsynopsis>
<para>
- 取得した行に対応する配列を返します。最後の行までいった場合は、falseを
- 返します。
+ 取得した行に対応する配列を返します。最後の行までいった場合は、
+ falseを返します。
</para>
<para>
<function>mysql_fetch_array</function>は、
@@ -622,15 +622,78 @@
</para>
<para>
より詳細な情報については、
- <function>mysql_fetch_row</function>も参照下さい。
+ <function>mysql_fetch_row</function>、
+ <function>mysql_fetch_assoc</function>も参照下さい。
</para>
<example>
<title><function>mysql_fetch_array</function></title>
<programlisting role="php">
<?php
mysql_connect ($host, $user, $password);
-$result = mysql_db_query ("database","select * from table");
+$result = mysql_db_query ("database","select user_id, fullname from table");
while ($row = mysql_fetch_array ($result)) {
+ echo "user_id: ".$row["user_id"]."<br>\n";
+ echo "user_id: ".$row[0]."<br>\n";
+ echo "fullname: ".$row["fullname"]."<br>\n";
+ echo "fullname: ".$row[1]."<br>\n";
+}
+mysql_free_result ($result);
+?>
+ </programlisting>
+ </example>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mysql-fetch-assoc">
+ <refnamediv>
+ <refname>mysql_fetch_assoc</refname>
+ <refpurpose>
+ 連想配列として結果の行を取得する
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>mysql_fetch_assoc</function></funcdef>
+ <paramdef>int <parameter>result</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ 取得した行に対応する連想配列を返します。行がもうない場合には、
+ falseを返します。
+ </para>
+ <para>
+ <function>mysql_fetch_assoc</function> は、
+ <function>mysql_fetch_array</function> のオプションの2番目のパラ
+ メータにMYSQL_ASSOCを指定してコールした場合と等価です。この関数は、
+ 連想配列のみを返します。これは、
+ <function>mysql_fetch_array</function>の元の動作と同じです。連想
+ 配列と同時に数値添字が必要な場合は、
+ <function>mysql_fetch_array</function>を使用して下さい。
+ </para>
+ <para>
+ 結果の複数のカラムが同じフィールド名を有している場合、最後のカラ
+ ムが優先されます。同じ名前を有する他のカラムにアクセスするには、
+ <function>mysql_fetch_array</function>を使用し、同時に数値添字も
+ 返す必要があります。
+ </para>
+ <para>
+ <function>mysql_fetch_assoc</function>の使用に関して、著しい付加
+ 価値があるにもかかわらず<function>mysql_fetch_row</function>より
+ も著しく遅くはないという点を特筆すべき点として強調しておきます。
+ </para>
+ <para>
+ より詳細な情報については、<function>mysql_fetch_row</function> お
+ よび <function>mysql_fetch_array</function>を参照下さい。
+ </para>
+ <example>
+ <title><function>mysql_fetch_assoc</function></title>
+ <programlisting role="php">
+<?php
+mysql_connect ($host, $user, $password);
+$result = mysql_db_query ("database","select * from table");
+while ($row = mysql_fetch_assoc ($result)) {
echo $row["user_id"];
echo $row["fullname"];
}
@@ -737,7 +800,7 @@
</itemizedlist>
</para>
<example>
- <title><function>Mysql_fetch_field</function></title>
+ <title><function>mysql_fetch_field</function></title>
<programlisting role="php">
<?php
mysql_connect ($host, $user, $password)
@@ -955,7 +1018,7 @@
</funcprototype>
</funcsynopsis>
<para>
- 指定したフィールドオフセットに移動します。こ֢数をコールした後、
+ 指定したフィールドオフセットに移動します。こざ¦հをコールした後、
<function>mysql_fetch_field</function>をフィールドオフセットを
付けずにコールした場合、このフィールドが返されます。
</para>
@@ -1201,7 +1264,7 @@
</funcsynopsis>
<para>
<function>mysql_list_dbs</function>は、カレントのmysqlデーモンから
- 利用可能なデータベースを格納した結果ポインタを返します。
+ 利用可能なデータベーィ?格納した結果ポインタを返します。
この結果ポインタを使用して内容を調べる際には、
<function>mysql_tablename</function>関数を使用して下さい。
</para>
@@ -1493,7 +1556,7 @@
<function>mysql_query</function>は失敗し、FALSEが返されます。
</para>
<para>
- クエリーが成功したと仮定すると(DELETE, INSERT, REPLACE, UPDATE文について)
+ クエリーが成功したと定すると(DELETE, INSERT, REPLACE, UPDATE文について)
作用を受けた行の数を得るために<function>mysql_affected_rows</function>
をコールすることができます。
SELECT文については、
@@ -1623,8 +1686,8 @@
</funcsynopsis>
<para>
<function>mysql_tablename</function>は、
- <function>mysql_list_tables</function>関数より返された
- 結果ポインタおよび整数インデックスを引数とし、テーブルの名前を返します。
+ <function>mysql_list_tables</function>関数より返された結果ポイン
+ タおよび整数インデックスを引数とし、テーブルの名前を返します。
結果ポインタにおけるテーブルの数を定義するために
<function>mysql_num_rows</function>関数を使用することができます。
<example>
Index: phpdoc/ja/functions/network.xml
diff -u phpdoc/ja/functions/network.xml:1.13 phpdoc/ja/functions/network.xml:1.14
--- phpdoc/ja/functions/network.xml:1.13 Sat Sep 9 22:15:11 2000
+++ phpdoc/ja/functions/network.xml Fri Sep 29 19:01:27 2000
@@ -722,7 +722,62 @@
</refsect1>
</refentry>
- <refentry id="function.set-socket-blocking">
+ <refentry id="function.socket-get-status">
+ <refnamediv>
+ <refname>socket_get_status</refname>
+ <refpurpose>
+ 既存のソケットリソースに関する情報を返す
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>socket_get_status</function></funcdef>
+ <paramdef>resource
+ <parameter>socket_get_status</parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ 既存のソケットリソースに関する情報を返します。現在、結果の配列に
+ は4つのエントリが返されます。
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <parameter>timed_out</parameter> (bool) - データに関するソケッ
+ トタイムアウト
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>blocked</parameter> (bool) - ソケットはブロックされる
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>eof</parameter> (bool) - EOF イベントを示す
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <parameter>unread_bytes</parameter> (int) - ソケットバッファの
+ 残りのバイト数
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <function>accept_connect</function>,
+ <function>bind</function>,
+ <function>connect</function>,
+ <function>listen</function>,
+ <function>strerror</function>も参照下さい。
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.set-socket-blocking">
<refnamediv>
<refname>socket_set_blocking</refname>
<refpurpose>ソケットにおけるブロック非ブロックモードの設定</refpurpose>
Index: phpdoc/ja/functions/pdf.xml
diff -u phpdoc/ja/functions/pdf.xml:1.12 phpdoc/ja/functions/pdf.xml:1.13
--- phpdoc/ja/functions/pdf.xml:1.12 Sat Sep 9 22:15:11 2000
+++ phpdoc/ja/functions/pdf.xml Fri Sep 29 19:01:27 2000
@@ -45,7 +45,7 @@
— からであるため、特にPDFLIB APIにおいて多くの変更が行われ
ています。これらの変更の多くは、PHPによりなんとか対応されてきまし
たが、いくつかの変更については、PHP APIの変更が必要でした。PDFLIB
- 3.x のAPIは安定しているようなので、PHP4では、このバージョン以降が
+ 3.x のAPIは安定しているようなので、PHP 4では、このバージョン以降が
pdfサポートについて必要としています。結果的に多くの関数が消えたり、
他の関数により置換されたりしています。PDFLIB 0.6のサポートは、完
全に諦められています。次の表には、PHP 4.0.2で廃止され、新しいバー
@@ -256,7 +256,7 @@
<simpara>
PDFLIBのバージョン 2.20 では、APIの更なる変更が行われ、中国語と日
本語のフォントがサポートされました。残念なことに、これにより、
- (PHP3ではなく)PHP4のpdfモジュールにいくつかの変更が生じています。
+ (PHP 3ではなく)PHP 4のpdfモジュールにいくつかの変更が生じています。
PDFLIB 2.20 を使用している場合には、pdfドキュメントのメモリ内での
生成を処理する際に注意が必要です。
<function>pdf_set_font</function>のパラメータencodingは、文字列に
@@ -270,9 +270,9 @@
関しては、使用するバージョンのPDFLIBのリリースノートを参照下さい。
</simpara>
<simpara>
- 2000/3/9以降のバージョンのPHP4では、3.0より前のバージョンのPDFLIB
- をサポートしていません。他方、PHP3では 2.01より新しいバージョンで
- 使用されているこはできません。(訳注：パッチをあてればPHP3でも
+ 2000/3/9以降のバージョンのPHP 4では、3.0より前のバージョンのPDFLIB
+ をサポートしていません。他方、PHP 3では 2.01より新しいバージョンで
+ 使用されているこはできません。(訳注：パッチをあてればPHP 3でも
PDFLIB3を使用可能です。)
</simpara>
</sect1>
@@ -724,7 +724,7 @@
類およびフォントサイズ、エンコード法を設定します。pdflib 0.6 を使
用している場合、フォントパス (デフォルトは ./fonts ) にあるフォン
トについてAdobe Font Metrics (afm ファイル) を用意する必要があり
- ます。PHP3またはバージョン2.20より以前のpdflibを使用している場合
+ ます。PHP 3またはバージョン2.20より以前のpdflibを使用している場合
は、4番目のパラメータ<parameter>encoding</parameter> は次のような
値を取ります:0 = builtin, 1 = pdfdoc, 2 = macroman, 3 =
macexpert, 4 = winansi。4より大きいか0未満のエンコードは、デフォ
@@ -2091,7 +2091,7 @@
4 はページを表示する際に1行ずつスクロールする,
</member>
<member>
- 5 はページを描画する際に古いページを消去する
+ 5 はページを描画する際に古ページを消去する
</member>
<member>
6 は画面の一つの隅から他の隅に移動するように消すといった効果を用いる
Index: phpdoc/ja/functions/posix.xml
diff -u phpdoc/ja/functions/posix.xml:1.3 phpdoc/ja/functions/posix.xml:1.4
--- phpdoc/ja/functions/posix.xml:1.3 Sat Jun 24 00:38:44 2000
+++ phpdoc/ja/functions/posix.xml Fri Sep 29 19:01:27 2000
@@ -7,7 +7,7 @@
このモジュールは、IEEE 10003.1 (POSIX.1) 標準ドキュメントで
定義された関数へのインターフェースを有しています。
これらの関数は、他の手段からは利用できません。
- POSIX.1 としては例えばかなり以前から PHP3 の一部として
+ POSIX.1 としては例えばかなり以前から PHP 3 の一部として
open(), read(),write() and close() 関数が定義されていました。
いくつかのよりシステム依存の関数は、以前は利用できませんでしたが、
このモジュールではこれらの関数に対する簡単なアクセス手段を提供すること
@@ -341,12 +341,14 @@
</funcprototype>
</funcsynopsis>
<para>
- プロセス<parameter>pid</parameter>のプロセスグループIDを
- 返します。</para>
+ プロセス<parameter>pid</parameter>のプロセスグループIDを
+ 返します。
+ </para>
<para>
この関数は POSIX関数ではなく、BSD および System V のシステムで
共通な関数です。使用するシステムがこの関数をシステムレベルで
- サポートしない場合、PHPは常にFALSEを返します。</para>
+ サポートしない場合、PHPは常にFALSEを返します。
+ </para>
</refsect1>
</refentry>
Index: phpdoc/ja/functions/recode.xml
diff -u phpdoc/ja/functions/recode.xml:1.3 phpdoc/ja/functions/recode.xml:1.4
--- phpdoc/ja/functions/recode.xml:1.3 Sat Jun 24 00:38:44 2000
+++ phpdoc/ja/functions/recode.xml Fri Sep 29 19:01:27 2000
@@ -4,11 +4,11 @@
<partintro>
<para>
- このモジュールは、GNU recodeライブラリ バージョン 3.5 への
- インターフェースを有しています。本モジュールで定義された関数を
- 使用するには、
- --with-recode オプションを指定してPHPインタプリタをコンパイルする必要があります。
- これを行うには、GNU Recode 3.5 以降をシステムにインストールしておく必要があります。
+ このモジュールは、GNU recodeライブラリ バージョン 3.5 へのインター
+ フェースを有しています。本モジュールで定義された関数を使用するに
+ は、--with-recode オプションを指定してPHPインタプリタをコンパイル
+ する必要があります。これを行うには、GNU Recode 3.5 以降をシステム
+ にインストールしておく必要があります。
</para>
<para>
GNU Recode ライブラリは、様々にコード化された文字や表面的なエンコード法を
@@ -64,7 +64,7 @@
<note>
<simpara>
この関数は<function>recode_string</function>のエイリアスです。
- この関数はPHP4で追加されました。
+ この関数はPHP 4で追加されました。
</simpara>
</note>
</refsect1>
Index: phpdoc/ja/functions/strings.xml
diff -u phpdoc/ja/functions/strings.xml:1.18 phpdoc/ja/functions/strings.xml:1.19
--- phpdoc/ja/functions/strings.xml:1.18 Fri Sep 15 18:27:36 2000
+++ phpdoc/ja/functions/strings.xml Fri Sep 29 19:01:27 2000
@@ -903,10 +903,26 @@
<paramdef>string <parameter>str1</parameter></paramdef>
<paramdef>string <parameter>str2</parameter></paramdef>
</funcprototype>
+ <funcprototype>
+ <funcdef>int <function>levenshtein</function></funcdef>
+ <paramdef>string <parameter>str1</parameter></paramdef>
+ <paramdef>string <parameter>str2</parameter></paramdef>
+ <paramdef>int <parameter>cost_ins</parameter></paramdef>
+ <paramdef>int <parameter>cost_rep</parameter></paramdef>
+ <paramdef>int <parameter>cost_del</parameter></paramdef>
+ </funcprototype>
+ <funcprototype>
+ <funcdef>int <function>levenshtein</function></funcdef>
+ <paramdef>string <parameter>str1</parameter></paramdef>
+ <paramdef>string <parameter>str2</parameter></paramdef>
+ <paramdef>function <parameter>cost</parameter></paramdef>
+ </funcprototype>
</funcsynopsis>
<para>
- この関数は、引数で指定した二つの文字列のLevenshtein距離
- を返します。引数文字列の一つが255文字の制限より長い場合に-1を返します。
+ この関数は、引数で指定した二つの文字列のLevenshtein距離を返します。
+ 引数文字列の一つが255文字の制限より長い場合に-1を返します。
+ (255は名前や辞書比較に関して十分な長さであり、PHPでの通常の比較に
+ 関しては問題となる制約ではありません)
</para>
<para>
Levenshtein距離は <parameter>str1</parameter> を
@@ -919,6 +935,72 @@
まだかなりの計算量です)
</para>
<para>
+ 上記の最も簡単な形式では、この関数はパラメータとして引数を二つだ
+ けとり、<parameter>str1</parameter>から
+ <parameter>str2</parameter>に変換する際に必要な挿入、置換、削除演
+ 算の数のみを計算します。
+ </para>
+ <para>
+ 2番目の形式では、挿入、置換、削除演算のコストを定義する3番目のパ
+ ラメータが追加されます。この形式は1番目の形式より一般的で汎用性が
+ 高いですが、効率的ではありません。
+ </para>
+ <para>
+ 3番目の形式(これは未実装です)は、最も一般的で汎用的ですが、最も遅
+ い形式でもあります。この形式では各演算毎にコストを定義するために
+ ユーザ定義関数をコールします。
+ </para>
+ <para>
+ ユーザ定義関数は、次のような引数を指定してコールされます。
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ 適用する演算: 'I'、'R'、'D'
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 文字列1の文字の実体
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 文字列2の文字の実体
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 文字列1での位置
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 文字列2での位置
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 文字列1での残りの文字
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 文字列2での残りの文字
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ ユーザ定義関数は、この特定の演算に関するコストを表す正の整数を返
+ す必要があります。しかし、指定された引数のいくつかだけを使用して
+ コストを計算することも可能です。
+ </para>
+ <para>
+ ユーザ定義関数を使用する形式では、挿入、置換、削除のコストを定義
+ する際に特定の記号(文字)またはこれらの記号を含む句の相関や差異を
+ 考慮する手法をとることが可能となります。しかし、この代償として他
+ の二つの形式では動作するCPUレジスタの使用に関する最適化の実行は行
+ われず、キャッシュも動作しなくなります。
+ </para>
+ <para>
<function>soundex</function>、<function>similar_text</function>、
<function>metaphone</function>も参照下さい。
</para>
@@ -1867,7 +1949,7 @@
<para>
この関数は、人間が行うような手法でアルファベットまたは数字の文字
列の順序を比較するアルゴリズムを実装します。この手法は、"自然順"
- と言われます。このアルゴリズムと(<function>strcmp</function>を使
+ 言われます。このアルゴリズムと(<function>strcmp</function>を使
用した)通常のコンピュータ文字列ソートの間の違いの例を次に示します。
<informalexample>
<programlisting role="php">
@@ -2129,7 +2211,7 @@
<refnamediv>
<refname>strrchr</refname>
<refpurpose>
- 文字列中に文字が最後に現れる場所をつける
+ 文字列中に文字が最後に現れる場所を苣dける
</refpurpose>
</refnamediv>
<refsect1>
@@ -2319,7 +2401,7 @@
</funcsynopsis>
<para>
<parameter>haystack</parameter>の中で<parameter>needle</parameter>が
- 最初に現れる場所から、文字列の終わりまでを返します。
+ 最初に現れる場所ら、文字列の終わりまでを返します。
</para>
<para>
<parameter>needle</parameter> が見つからない場合はfalseを返しま
@@ -2752,7 +2834,7 @@
$var = 'ABCDEFGH:/MNRPQR/';
echo "Original: $var<hr>\n";
-/* 以下の2つの例は、全ての $var で 'bob' で置換します。 */
+/* 以下の2つの例は、全ての $var で 'bob' で置します。 */
echo substr_replace ($var, 'bob', 0) . "<br>\n";
echo substr_replace ($var, 'bob', 0, strlen ($var)) . "<br>\n";
Index: phpdoc/ja/functions/swf.xml
diff -u phpdoc/ja/functions/swf.xml:1.5 phpdoc/ja/functions/swf.xml:1.6
--- phpdoc/ja/functions/swf.xml:1.5 Sat Sep 9 22:15:11 2000
+++ phpdoc/ja/functions/swf.xml Fri Sep 29 19:01:27 2000
@@ -77,7 +77,7 @@
</para>
<note>
<para>
- SWFサポートはPHP4 RC2で追加されました。
+ SWFサポートはPHP 4 RC2で追加されました。
</para>
</note>
</partintro>
@@ -1776,7 +1776,7 @@
最初のパラメータ<parameter>states</parameter>はボタンが有する状態を定義し、
定数BSHitTest,BSDown,BSOver,BSUpのどれかまたは全てとすることが可能です。
2番目のパラメータ<parameter>shapeid</parameter>はボタンの形状であり、
- 通常はボタンの形状のオブジェクトIDです。カレントのフレームにおける
+ 通常はボタンの形状のオブジェクトIDす。カレントのフレームにおける
パラメータ<parameter>depth</parameter>はボタンの位置です。
<example>
<title>
Index: phpdoc/ja/functions/var.xml
diff -u phpdoc/ja/functions/var.xml:1.18 phpdoc/ja/functions/var.xml:1.19
--- phpdoc/ja/functions/var.xml:1.18 Sat Sep 9 22:15:11 2000
+++ phpdoc/ja/functions/var.xml Fri Sep 29 19:01:27 2000
@@ -523,7 +523,7 @@
</funcprototype>
</funcsynopsis>
<para>
- <parameter>var</parameter>が文字列であればtrue、
+ <parameter>var</parameter>が文字列であ?ptrue、
そうでなければfalseを返します。
</para>
<para>
@@ -703,6 +703,12 @@
<funcprototype>
<funcdef>int <function>unset</function></funcdef>
<paramdef>mixed <parameter>var</parameter></paramdef>
+ <paramdef>mixed
+ <parameter><optional>var</optional></parameter>
+ </paramdef>
+ <paramdef>
+ <parameter><optional>...</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -712,10 +718,111 @@
<example>
<title><function>unset</function>の例</title>
<programlisting role="php">
+// 変数を一つ破棄する
unset ($foo);
+
+// 配列の要素の一つを破棄する
unset ($bar['quux']);
+
+// 複数の変数を破棄する
+unset ($foo1, $foo2, $foo3);
</programlisting>
</example>
+ </para>
+ <para>
+ 関数<function>unset</function>の内部動作は、破棄しようとする変数
+ の型に依存します。
+ </para>
+ <para>
+ あるグローバル変数が関数の中で<function>unset</function>された場
+ 合、ローカル変数のみが破棄されます。呼出側の環境にある変数は、
+ <function>unset</function>がコールされる前と同じ値を保持します。
+ <informalexample>
+ <programlisting role="php">
+function destroy_foo() {
+ global $foo;
+ unset($foo);
+}
+
+$foo = 'bar';
+destroy_foo();
+echo $foo;
+ </programlisting>
+ </informalexample>
+ 上記の例の出力は次のようになります。
+ <informalexample>
+ <programlisting>
+bar
+ </programlisting>
+ </informalexample>
+ </para>
+ <para>
+ 参照渡しされた変数が関数内で<function>unset</function>された場合
+ に、ローカル変数のみが破棄されます。呼出側の環境でその変数は、
+ <function>unset</function>がコールされる前と同じ値を保持します。
+ <informalexample>
+ <programlisting role="php">
+function foo(&$bar) {
+ unset($bar);
+ $bar = "blah";
+}
+
+$bar = 'something';
+echo "$bar\n";
+
+foo($bar);
+echo "$bar\n";
+ </programlisting>
+ </informalexample>
+ The above example would output:
+ <informalexample>
+ <programlisting>
+something
+something
+ </programlisting>
+ </informalexample>
+ </para>
+ <para>
+ 静的変数が関数の内部で<function>unset</function>された場合、
+ <function>unset</function> は静的変数自体ではなく静的変数へのリファ
+ レンスを破棄します。
+ <informalexample>
+ <programlisting role="php">
+function foo() {
+ static $a;
+ $a++;
+ echo "$a\n";
+
+ unset($a);
+}
+
+foo();
+foo();
+foo();
+ </programlisting>
+ </informalexample>
+ 上記の例の出力は次のようになります。
+ <informalexample>
+ <programlisting>
+1
+2
+3
+ </programlisting>
+ </informalexample>
+ </para>
+ <para>
+ グローバル変数を関数内で<function>unset</function>したい場合、
+ 配列<parameter>$GLOBALS</parameter>を使用し、次のようにして下さい。
+ <informalexample>
+ <programlisting role="php">
+function foo() {
+ unset($GLOBALS['bar']);
+}
+
+$bar = "something";
+foo();
+ </programlisting>
+ </informalexample>
</para>
<para>
<function>isset</function>、<function>empty</function>も参照下さい。
Index: phpdoc/ja/functions/yaz.xml
diff -u phpdoc/ja/functions/yaz.xml:1.1 phpdoc/ja/functions/yaz.xml:1.2
--- phpdoc/ja/functions/yaz.xml:1.1 Mon Aug 7 20:30:19 2000
+++ phpdoc/ja/functions/yaz.xml Fri Sep 29 19:01:27 2000
@@ -1,31 +1,43 @@
<reference id="ref.yaz">
- <title>YAZ</title>
+ <title>YAZ 関数</title>
<titleabbrev>YAZ</titleabbrev>
-
+
<partintro>
- <simpara>
- <function>yaz</function> 関数は、YAZ APIをサポートします。このプロ
- ジェクトのホームページは、<ulink url="&url.yaz;">&url.yaz;</ulink>
- です。phpyazモジュールに関する情報は、<ulink
- url="&url.yaz-phpyaz;">&url.yaz-phpyaz;</ulink>にあります。
- </simpara>
- <simpara>
- PHP/YAZ は、YAZのC APIに非常に良く似ていますが、柔軟姓では劣ってい
- ます。この目的は、基本的なクライアント機能を容易に構築することにあ
- ります。このAPIは、持続的な状態遷移のない接続をサポートしており、
- これらは、PHPで利用可能な種々のSQL APIで提供されるものに似ています。
- このことは、セッションには状態遷移がないが、ユーザー間で共有される
- こと、つまり、接続と多くの場合INITステップを保存することを意味して
- います。
- </simpara>
- <simpara>
- PHP/YAZモジュールと共にPHPをコンパイルする前にYAZツールキットが必
- 要です。YAZを構築し、インストールして下さい。PHPを好きなモジュール
- と共に構築し、その際にオプション --with-yazを追加して下さい。この
- 手順は概ね次のようになります。
- </simpara>
- <informalexample>
- <programlisting>
+ <sect1 id="yaz.intro">
+ <title>導入</title>
+ <para>
+ この拡張モジュールは、情報取得用のZ39.50プロトコルを実装する
+ <productname>YAZ</productname>ツールキットへのPHPインターフェース
+ を提供するものです。この拡張モジュールにより、Z39.50ターゲット(サー
+ バー)を並列に検索するZ39.50オリジン(クライアント)を容易に実装する
+ ことが可能になります。
+ </para>
+ <para>
+ <productname>YAZ</productname> は、<ulink
+ url="&url.yaz;">&url.yaz;</ulink>で取得可能です。この拡張モジュー
+ ルに関する新しい情報、スクリプトの例等を
+ <ulink url="&url.yaz-phpyaz;">&url.yaz-phpyaz;</ulink>にて
+ 参照可能です。
+ </para>
+ <para>
+ このモジュールはZ39.50 の複雑さを隠蔽するため、使用法がかなり容
+ 易になります。PHPで利用可能な様々なSQL APIにより提供されているも
+ のに非常によく似たステートレスな持続的接続がサポートされています。
+ これにより、セッションはステートレスですが、ユーザ間で共有され、
+ これにより多くの場合に接続および初期化手順が保存されます。
+ </para>
+ </sect1>
+
+ <sect1 id="yaz.install">
+ <title>インストール</title>
+ <para>
+ YAZをコンパイルし、インストールして下さい。PHPをオプション--
+ with-yazを付けて他の任意のモジュールとコンパイルして下さい。この
+ 手順の概要を以下に示します。
+ </para>
+ <para>
+ <informalexample>
+ <programlisting>
gunzip -c yaz-1.6.tar.gz|tar xf -
gunzip -c php-4.0.X.tar.gz|tar xf -
cd yaz-1.6
@@ -36,21 +48,27 @@
./configure --with-yaz=/usr/bin
make
make install
- </programlisting>
- </informalexample>
- <simpara>
- PHP/YAZ はターゲット(Z-Associations)との接続を保持し続けます。
- 正の整数で特定の接続のIDを表します。
- </simpara>
- <simpara>
- 以下のスクリプトは、APIのパラレルサーチ機能のデモです。
- このスクリプトは起動された際に(引数が指定されない場合は)クエリフォー
- ムを表示し、引数(termおよび一つ以上のhost)がある場合には、配列host
- にあるターゲットを検索します。
- </simpara>
- <example>
- <title><function>YAZ</function></title>
- <programlisting role="php">
+ </programlisting>
+ </informalexample>
+ </para>
+ </sect1>
+
+ <sect1 id="yaz.example">
+ <title>Example</title>
+ <para>
+ PHP/YAZ はターゲット(Z-Associations)との接続を保持し続けます。
+ 正の整数で特定の接続のIDを表します。
+ </para>
+ <para>
+ 以下のスクリプトは、APIのパラレルサーチ機能のデモです。
+ このスクリプトは起動された際に(引数が指定されない場合は)クエリフォー
+ ムを表示し、引数(termおよび一つ以上のhost)がある場合には、配列host
+ にあるターゲットを検索します。
+ </para>
+ <para>
+ <example>
+ <title><function>YAZ</function></title>
+ <programlisting role="php">
$num_hosts = count ($host);
if (empty($term) || count($host) == 0) {
echo '<form method="get">
@@ -70,7 +88,7 @@
';
} else {
echo 'You searced for ' . htmlspecialchars($term) . '<br>';
- for ($i = 0; $i > $num_hosts; $i++) {
+ for ($i = 0; $i < $num_hosts; $i++) {
$id[] = yaz_connect($host[$i]);
yaz_syntax($id[$i],"sutrs");
yaz_search($id[$i],"rpn",$term);
@@ -96,8 +114,10 @@
echo '</dl>';
}
}
- </programlisting>
- </example>
+ </programlisting>
+ </example>
+ </para>
+ </sect1>
</partintro>
<refentry id="function.yaz-addinfo">
@@ -318,11 +338,102 @@
<para>
<function>yaz_search</function> は、指定したidを有するターゲット
で検索を行う準備をします。type は、クエリの型を表します。現在、
- "rpn" のみがサポートされており、この場合、3番目の引数はYAZで使用
- される接頭辞付き表記のクエりとなります。
- <function>yaz_connect</function> と同じく、この関数は、非ブロック
- モードで動作し、後で <function>yaz_wait</function> がコールされた
- 際に実行される検索の準備をするだけです。
+ "rpn" のみがサポートされており、この場合、3番目の引数はType-1クエ
+ リ(RPN)を指定します。<function>yaz_connect</function> と同じく、
+ この関数は、非ブロックモードで動作し、後で
+ <function>yaz_wait</function> がコールされた際に実行される検索の
+ 準備をするだけです。
+ </para>
+ </refsect1>
+ <refsect1>
+ <title>RPNクエリ</title>
+ <para>
+ RPNクエリは、Z39.50規格により定義されたType-1 クエリのテキスト表
+ 現です。しかし、YAZにより使用されるテキスト表現では、演算子がオペ
+ ランドの前にある前置表記が使用されます。クエリ文字列はトークンの
+ 並びであり、このトークンでは2重引用符で括られない限り空白文字は無
+ 視されます。トークンは、アットマーク(<literal>@</literal>)で始ま
+ り、演算子とみなされるか、そうでない場合は検索項目として処理され
+ ます。
+ </para>
+ <table>
+ <title>RPN 演算子</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>構文</entry>
+ <entry>説明</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal> <email protected> query1 query2</literal></entry>
+ <entry>
+ query1 および query2の積集合
+ </entry>
+ </row>
+ <row>
+ <entry><literal> <email protected> query1 query2</literal></entry>
+ <entry>
+ query1 および query2の和集合
+ </entry>
+ </row>
+ <row>
+ <entry><literal> <email protected> query1 query2</literal></entry>
+ <entry>
+ query1 であり、query2でない
+ </entry>
+ </row>
+ <row>
+ <entry><literal> <email protected> name</literal></entry>
+ <entry>
+ 結果セットへのリファレンス
+ </entry>
+ </row>
+ <row>
+ <entry><literal> <email protected> set query</literal></entry>
+ <entry>
+ クエリの属性セットを指定します。この構造が使用できるの
+ は全てのクエリの始めに一回だけです。
+ </entry>
+ </row>
+ <row>
+ <entry><literal> <email protected> set type=value query</literal></entry>
+ <entry>
+ クエリに属性を適用します。型と値は属性型と属性値をそれぞれ指
+ 定する整数です。この組みが指定された場合、属性の組を指定しま
+ す。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <para>
+ 以下は、有効なクエリ構造を説明するものです。
+ <informalexample>
+ <screen>computer</screen>
+ </informalexample>
+ "computer" がある文書にマッチします。属性は指定されてません。
+ </para>
+ <para>
+ <informalexample>
+ <screen>"donald knuth"</screen>
+ </informalexample>
+ "donald knuth" がある文書にマッチします。
+ </para>
+ <para>
+ <informalexample>
+ <screen> <email protected> 1=4 art</screen>
+ </informalexample>
+ 属性型は1 (Bib-1 使用)で、属性値は 4(タイトル)です。これにより、
+ "art"がタイトルにある文書にマッチします。
+ </para>
+ <para>
+ <informalexample>
+ <screen> <email protected> gils <email protected> <email protected> 1=4 art <email protected> 1=1003 "donald knuth"</screen>
+ </informalexample>
+ このクエリは全体にGILS属性セットを使用します。このクエリはtitleに
+ "art"があり、authorに"donald knuth"がある文書にマッチします。
</para>
</refsect1>
</refentry>
@@ -331,7 +442,7 @@
<refnamediv>
<refname>yaz_syntax</refname>
<refpurpose>
- 取得時のレコード構文を指定する
+ 取得時のレコード構文に関してオブジェクトID(OID)を指定する
</refpurpose>
</refnamediv>
<refsect1>
@@ -344,8 +455,10 @@
</funcprototype>
</funcsynopsis>
<para>
- この関数は<function>yaz_search</function> と共に使用され、取得
- 時のレコード構文を指定します。
+ syntaxには、(<literal>1.2.840.10003.5.10</literal>のような)ドット
+ 表記または既知のレコード構文の一つ(sutrs, usmarc, grs1, xml, 等)
+ を指定します。この関数は<function>yaz_search</function> と共に使
+ 用され、取得時のレコード構文を指定します。
</para>
</refsect1>
</refentry>
Index: phpdoc/ja/language/control-structures.xml
diff -u phpdoc/ja/language/control-structures.xml:1.10 phpdoc/ja/language/control-structures.xml:1.11
--- phpdoc/ja/language/control-structures.xml:1.10 Fri Sep 15 18:27:37 2000
+++ phpdoc/ja/language/control-structures.xml Fri Sep 29 19:01:27 2000
@@ -400,10 +400,10 @@
</para>
<para>
他の言語には、配列やハッシュを連続的に処理するために
- <literal>foreach</literal>文があります。PHP3にはこうした
- 構文はありません。PHP4はこれをサポートしています。
+ <literal>foreach</literal>文があります。PHP 3にはこうした
+ 構文はありません。PHP 4はこれをサポートしています。
(<link linkend="control-structures.foreach">foreach</link>を参照下さい)
- PHP3 では、同様の効果を得るために<link linkend="control-structures.while">
+ PHP 3 では、同様の効果を得るために<link linkend="control-structures.while">
while</link>文を<function>list</function>および<function>each</function>
と組み合わせて使用します。
例については、これらの関数に関するドキュメントを参照下さい。
@@ -414,7 +414,7 @@
<sect1 id="control-structures.foreach">
<title><literal>foreach</literal></title>
<para>
- (PHP3ではなく)PHP4には、Perlや他の言語とよく似た
+ (PHP 3ではなく)PHP 4には、Perlや他の言語とよく似た
<literal>foreach</literal>構文があります。これにより
配列要素に関する反復処理が容易になります。この構造には、
2種類の構文があります。2番目の構文はあまり知られていませんが、
@@ -850,11 +850,11 @@
</informalexample>
</para>
<simpara>
- PHP3では、<function>require</function>されたファイルのグローバルス
+ PHP 3では、<function>require</function>されたファイルのグローバルス
コープでのみ<function>require</function>されたファイル内で
<literal>return</literal>文を実行することが可能です。
ブロック内(括弧{}の中を意味します)では使用することはできません。
- しかし、PHP4では、この機能は廃止されました。この機能が必要な場合、
+ しかし、PHP 4では、この機能は廃止されました。この機能が必要な場合、
<function>include</function>を参照下さい。
</simpara>
<simpara>
@@ -930,20 +930,20 @@
</informalexample>
</para>
<simpara>
- PHP3およびPHP4では共に<function>include</function>されたファイル内で
+ PHP 3およびPHP 4では共に<function>include</function>されたファイル内で
ファイルの実行処理を終了し呼出側のスクリプトに戻るために
<literal>return</literal>文を実行することが可能です。
- しかし、動作にはいくつかの違いがあります。まず、PHP3では
+ しかし、動作にはいくつかの違いがあります。まず、PHP 3では
関数ブロック以外のブロック内で<literal>return</literal>を
- 使用することはできません。PHP3では、<literal>return</literal>
+ 使用することはできません。PHP 3では、<literal>return</literal>
が適用っMるのは関数であり、ファイル全体には適用できません。
- しかし、PHP4ではこの制限はありません。また、PHP4では
+ しかし、PHP 4ではこの制限はありません。また、PHP 4では
<function>include</function>されたファイルから値を返すことが可能です。
通常の関数と同様に<function>include</function>コールの値を
- 取得できます。これは、PHP3ではパース時にエラーとなります。
+ 取得できます。これは、PHP 3ではパース時にエラーとなります。
</simpara>
<example>
- <title>PHP3とPHP4における<function>include</function></title>
+ <title>PHP 3とPHP 4における<function>include</function></title>
<para>
メインファイルと同じディレクトリに(<filename>test.inc</filename>
という名前の)以下のファイルが存在すると仮定します。
@@ -968,10 +968,10 @@
</programlisting>
</para>
<para>
- <filename>main.html</filename>がPHP3でコールされた場合、
- 2行目でパースエラーとなります。つまり、PHP3では
+ <filename>main.html</filename>がPHP 3でコールされた場合、
+ 2行目でパースエラーとなります。つまり、PHP 3では
<function>include</function>の値を取得できないのです。
- しかし、PHP4では、以下のような結果となります。
+ しかし、PHP 4では、以下のような結果となります。
<screen>
Before the return
File returned: '27'
@@ -988,12 +988,12 @@
</programlisting>
</para>
<para>
- PHP4では、出力は次のようになります。
+ PHP 4では、出力は次のようになります。
<screen>
Before the return
Back in main.html
</screen>
- しかし、PHP3では出力は以下となります。
+ しかし、PHP 3では出力は以下となります。
<screen>
Before the return
27Back in main.html
@@ -1011,7 +1011,7 @@
</screen>
</para>
<para>
- スプリアス'27'はPHP3がファイルから<literal>return</literal>により
+ スプリアス'27'はPHP 3がファイルから<literal>return</literal>により
値を返すことをサポートしていないことによるものです。
</para>
</example>
Index: phpdoc/ja/language/functions.xml
diff -u phpdoc/ja/language/functions.xml:1.3 phpdoc/ja/language/functions.xml:1.4
--- phpdoc/ja/language/functions.xml:1.3 Fri Aug 18 23:13:33 2000
+++ phpdoc/ja/language/functions.xml Fri Sep 29 19:01:27 2000
@@ -1,112 +1,109 @@
- <chapter id="functions">
- <title>関数</title>
-
- <sect1 id="functions.user-defined">
- <title>ユーザー定義関数</title>
+ <chapter id="functions">
+ <title>関数</title>
+
+ <sect1 id="functions.user-defined">
+ <title>ユーザー定義関数</title>
- <para>
+ <para>
関数は次のような構文で定義されます。
- <informalexample>
- <programlisting role="php">
+ <informalexample>
+ <programlisting role="php">
function foo ($arg_1, $arg_2, ..., $arg_n) {
echo "関数の例\n";
return $retval;
}
- </programlisting>
- </informalexample>
- </para>
+ </programlisting>
+ </informalexample>
+ </para>
- <simpara>
+ <simpara>
関数の中では、他の関数や <link linkend="keyword.class">クラス</link> 定義
を含む PHP のあらゆる有効なコードを使用することができます。
- </simpara>
- <simpara>
- PHP3 では、関数は参照される前に定義されている必要がありました。
- PHP4ではそのような制限はありません。
- </simpara>
+ </simpara>
<simpara>
- PHP は関数のオーバーロードをサポートしていません。
- また、宣言された関数の定義を取り消したり再定義することも
- できません。
+ PHP 3 では、関数は参照される前に定義されている必要がありました。
+ PHP 4ではそのような制限はありません。
</simpara>
-
<simpara>
- PHP3 では、引数のデフォルト値
- (詳細は、<link linkend="functions.arguments.default">引数のデフォルト値
- </link>を参照下さい)はサポートしていますが、
- 関数の引数を可変とすることはできません。
- PHP4 は両方ともサポートしています。
- 詳細は、
- <link linkend="functions.variable-arg-list">可変長引数リスト</link>
- および <function>func_num_args</function>,
- <function>func_get_arg</function>,
- <function>func_get_args</function> に関する関数リファレンスを
- 参照下さい。
- </simpara>
+ PHP は関数のオーバーロードをサポートしていません。
+ また、宣言された関数の定義を取り消したり再定義することも
+ できません。
+ </simpara>
+ <simpara>
+ PHP 3 では、引数のデフォルト値(詳細は、<link
+ linkend="functions.arguments.default">引数のデフォルト値</link>を
+ 参照下さい)はサポートしていますが、関数の引数を可変とすることはで
+ きません。PHP 4 は両方ともサポートしています。詳細は、
+ <link linkend="functions.variable-arg-list">可変長引数リスト</link>
+ および <function>func_num_args</function>,
+ <function>func_get_arg</function>,
+ <function>func_get_args</function> に関する関数リファレンスを
+ 参照下さい。
+ </simpara>
- </sect1>
+ </sect1>
- <sect1 id="functions.arguments">
- <title>関数の引数</title>
+ <sect1 id="functions.arguments">
+ <title>関数の引数</title>
- <simpara>
+ <simpara>
引数のリストにより関数へ情報を渡すことができます。
- このリストは、カンマで区切られた変数や定数のリストです。</simpara>
-
- <para>
+ このリストは、カンマで区切られた変数や定数のリストです。
+ </simpara>
+ <para>
PHP は、値渡し(デフォルト)、
<link linkend="functions.arguments.by-reference">参照渡し</link>、
<link linkend="functions.arguments.default">デフォルト引数値</link>
- をサポートしています。可変長引数リストは、PHP4以降でのみサポート
- されています。
- 詳細は、
- <link linkend="functions.variable-arg-list">可変長引数リスト</link>
- および <function>func_num_args</function>,
- <function>func_get_arg</function>,
- <function>func_get_args</function> に関する関数リファレンスを
- 参照下さい。PHP3でも関数に引数の配列を渡すことにより
- 同様の効果を得ることができます。
+ をサポートしています。可変長引数リストは、PHP 4以降でのみサポート
+ されています。詳細は、
+ <link linkend="functions.variable-arg-list">可変長引数リスト</link>
+ および <function>func_num_args</function>,
+ <function>func_get_arg</function>,
+ <function>func_get_args</function> に関する関数リファレンスを
+ 参照下さい。PHP 3でも関数に引数の配列を渡すことにより
+ 同様の効果を得ることができます。
- <informalexample>
- <programlisting role="php">
+ <informalexample>
+ <programlisting role="php">
function takes_array($input) {
echo "$input[0] + $input[1] = ", $input[0]+$input[1];
}
- </programlisting>
- </informalexample>
- </para>
-
- <sect2 id="functions.arguments.by-reference">
- <title>参照渡し</title>
+ </programlisting>
+ </informalexample>
+ </para>
+
+ <sect2 id="functions.arguments.by-reference">
+ <title>参照渡し</title>
- <simpara>
- デフォルトで、関数の引数は値で渡されます。(このため、関数の内部で引数の値を
- 変更しても関数の外側では値は変化しません。)
- 関数がその引数を修正できるようにするには、その引数を参照渡しと
- する必要があります。
- </simpara>
- <para>
+ <simpara>
+ デフォルトで、関数の引数は値で渡されます。(このため、関数の内部で
+ 引数の値を変更しても関数の外側では値は変化しません。)関数がその引
+ 数を修正できるようにするには、その引数を参照渡しとする必要があり
+ ます。
+ </simpara>
+ <para>
関数の引数を常に参照渡しとしたい場合には、関数定義において
アンパサンド(&) を引数名の前に付加することができます。
-
- <informalexample>
- <programlisting role="php">
+
+ <informalexample>
+ <programlisting role="php">
function add_some_extra(&$string) {
$string .= 'and something extra.';
}
$str = 'This is a string, ';
add_some_extra($str);
echo $str; // 'This is a string, and something extra.' を出力します
- </programlisting>
- </informalexample></para>
+ </programlisting>
+ </informalexample>
+ </para>
- <para>
+ <para>
変数へある変数を参照渡しとしたいが、デフォルトでは参照渡しではない
場合、関数コール時に引数名の前にアンパサンドを付加することができます。
-
- <informalexample>
- <programlisting role="php">
+
+ <informalexample>
+ <programlisting role="php">
function foo ($bar) {
$bar .= ' and something extra.';
}
@@ -115,59 +112,48 @@
echo $str; // 'This is a string, ' を出力します。
foo (&$str);
echo $str; // 'This is a string, and something extra.' を出力します。
- </programlisting>
- </informalexample>
- </para>
-
- </sect2>
-
- <sect2 id="functions.arguments.default">
- <title>デフォルト引数値</title>
+ </programlisting>
+ </informalexample>
+ </para>
+
+ </sect2>
- <para>
+ <sect2 id="functions.arguments.default">
+ <title>デフォルト引数値</title>
+
+ <para>
関数は、スカラー引数に関して次のように C++ スタイルのデフォルト値を
定義することができます。
-
- <informalexample>
- <programlisting role="php">
+
+ <informalexample>
+ <programlisting role="php">
function makecoffee ($type = "cappucino") {
return "一杯の $type を作ります\n";
}
echo makecoffee ();
echo makecoffee ("espresso");
- </programlisting>
- </informalexample>
- </para>
-
- <para>
- 上のコードにより、次のような出力が行われます。
+ </programlisting>
+ </informalexample>
+ </para>
+
+ <para>
+ 上のコードにより、次のような出力が行われます。
- <screen>
+ <screen>
一杯の cappucino を作ります
一杯の espresso を作ります
- </screen>
- </para>
-
- <simpara>
+ </screen>
+ </para>
+
+ <simpara>
デフォルト値は、定数式である必要があり、
(例えば、)変数やクラスのメンバーであってはなりません。
- </simpara>
-
- <para>
- PHP 4.0 においては、デフォルト引数に <literal>unset</literal> を
- 指定することも可能です。これは、値が指定されない場合、
- その引数が全く設定されないことを意味します。</para>
-
- <para>
- PHP 4.0 においては、デフォルト引数に <literal>unset</literal> を
- 指定することも可能です。これは、値が指定されない場合、
- その引数が全く設定されないことを意味します。</para>
-
- <para>
- デフォルト引数を使用する場合、全てのデフォルト値は、
- デフォルト値としない引数の右側にある必要があります。
- そうしないと、期待通りの動作は得られないでしょう。
- 次の短いコードを見てみましょう。
+ </simpara>
+ <para>
+ 引数のデフォルト値を使用する際には、デフォルト値を有する引数はデ
+ フォルト値がない引数の右側に全てある必要があることに注意して下さ
+ い。そうでない場合、意図したような動作が行われません。次の簡単な
+ コードを見てみましょう。
<informalexample>
<programlisting role="php">
@@ -176,61 +162,62 @@
}
echo makeyogurt ("raspberry"); // 期待通りには動作しません
- </programlisting>
- </informalexample>
- </para>
-
- <para>
+ </programlisting>
+ </informalexample>
+ </para>
+
+ <para>
上記の例の出力は次のようになります。
- <screen>
+ <screen>
Warning: Missing argument 2 in call to makeyogurt() in
/usr/local/etc/httpd/htdocs/php3test/functest.html on line 41
Making a bowl of raspberry .
- </screen></para>
+ </screen>
+ </para>
- <para>
+ <para>
ここで、上の例を次のコードと比べてみましょう。
-
- <informalexample>
- <programlisting role="php">
+
+ <informalexample>
+ <programlisting role="php">
function makeyogurt ($flavour, $type = "acidophilus") {
return "Making a bowl of $type $flavour.\n";
}
echo makeyogurt ("raspberry"); // 期待通りに動作します
- </programlisting>
- </informalexample>
- </para>
-
- <para>
- この例の出力は、次のようになります。
+ </programlisting>
+ </informalexample>
+ </para>
+
+ <para>
+ この例の出力は、次のようになります。
- <screen>
+ <screen>
Making a bowl of acidophilus raspberry.
</screen>
- </para>
- </sect2>
-
- <sect2 id="functions.variable-arg-list">
- <title>可変長引数リスト</title>
-
- <simpara>
- PHP4 は、可変長引数をユーザー定義関数でサポートしています。
- 可変長引数の使用法は非常に簡単で、
- <function>func_num_args</function>,
- <function>func_get_arg</function>,
- <function>func_get_args</function> 関数を使用します。
- </simpara>
-
- <simpara>
- 可変長引数に関して特別な構文は必要としません。
- 引数リストは従来と同様に関数定義で明示的に指定することができ、
- 動作も従来と変わりません。
- </simpara>
-
+ </para>
</sect2>
+ <sect2 id="functions.variable-arg-list">
+ <title>可変長引数リスト</title>
+
+ <simpara>
+ PHP 4 は、可変長引数をユーザー定義関数でサポートしています。
+ 可変長引数の使用法は非常に簡単で、
+ <function>func_num_args</function>,
+ <function>func_get_arg</function>,
+ <function>func_get_args</function> 関数を使用します。
+ </simpara>
+
+ <simpara>
+ 可変長引数に関して特別な構文は必要としません。
+ 引数リストは従来と同様に関数定義で明示的に指定することができ、
+ 動作も従来と変わりません。
+ </simpara>
+
+ </sect2>
+
</sect1>
<sect1 id="functions.returning-values">
@@ -239,7 +226,7 @@
<para>
オプションの return 文により値を返すことができます。
リストやオブジェクトを含むあらゆる型を返すことができます。
-
+
<informalexample>
<programlisting role="php">
function square ($num) {
@@ -275,7 +262,7 @@
</programlisting>
</informalexample>
</para>
-
+
</sect1>
<sect1 id="functions.old-syntax">
@@ -287,7 +274,7 @@
PHP/FI2 と同じ構文を用いている関数を定義することを可能にします。
</simpara>
<simpara>
- この機能は推奨されない機能であり、PHP/FI2->PHP3 コンバーターのみで
+ この機能は推奨されない機能であり、PHP/FI 2->PHP 3 コンバーターのみで
使用されるべきです。
</simpara>
<warning>
@@ -298,7 +285,7 @@
<function>array_walk</function>,
<function>register_shutdown_function</function> のような
関数においてこの関数を使用することができないことを意味します。
- (通常の PHP3 形式で)ラッパー関数を書くことによりこの制約を
+ (通常の PHP 3 形式で)ラッパー関数を書くことによりこの制約を
取り除き、<literal>old_function</literal> をコールすることができます。
</para>
</warning>
Index: phpdoc/ja/language/operators.xml
diff -u phpdoc/ja/language/operators.xml:1.6 phpdoc/ja/language/operators.xml:1.7
--- phpdoc/ja/language/operators.xml:1.6 Sun Sep 10 00:34:35 2000
+++ phpdoc/ja/language/operators.xml Fri Sep 29 19:01:27 2000
@@ -91,8 +91,8 @@
片方の変数に対する変更はもう片方に影響を与えないということに注意し
て下さい。この動作により、密なループの内側で大きな配列のようなもの
をコピーする必要がある場合には問題を生じる可能性があります。
- PHP4 では、<computeroutput>$var = &$othervar;</computeroutput>
- 構文により参照による代入をサポートしていますが、PHP3 ではサポート
+ PHP 4 では、<computeroutput>$var = &$othervar;</computeroutput>
+ 構文により参照による代入をサポートしていますが、PHP 3 ではサポート
しません。'参照による代入'は、両方の変数が同じデータを指し、コピー
を行わないことを意味します。参照に関する詳細については、
<link linkend="language.references">リファレンスの説明</link>も
@@ -190,7 +190,7 @@
<row>
<entry>$a === $b</entry>
<entry>等しい</entry>
- <entry>$a が $b に等しく同じ型でである場合に true。(PHP4のみ)
+ <entry>$a が $b に等しく同じ型でである場合に true。(PHP 4のみ)
</entry>
</row>
<row>
@@ -202,7 +202,7 @@
<entry>$a !== $b</entry>
<entry>等しくない</entry>
<entry>
- $a が $b と等しくないか、同じ型でない場合に true。(PHP4のみ)
+ $a が $b と等しくないか、同じ型でない場合に true。(PHP 4のみ)
</entry>
</row>
<row>
Index: phpdoc/ja/language/variables.xml
diff -u phpdoc/ja/language/variables.xml:1.6 phpdoc/ja/language/variables.xml:1.7
--- phpdoc/ja/language/variables.xml:1.6 Fri Sep 15 18:27:37 2000
+++ phpdoc/ja/language/variables.xml Fri Sep 29 19:01:28 2000
@@ -39,7 +39,7 @@
</para>
<para>
- PHP3では、変数はその常に値により代入されていました。
+ PHP 3では、変数は常にその値により代入されていました。
これは、つまり、ある変数にある式を代入する際、元の式の
値全体がコピーされる側の変数にコピーされるということです。
これは、例えば、ある変数の値を他の変数に代入した後で、
@@ -48,7 +48,7 @@
<link linkend="language.expressions">式</link> を参照下さい。
</para>
<para>
- PHP4 は変数に値の代入を行う別の方法を提供します。それは、
+ PHP 4 は変数に値の代入を行う別の方法を提供します。それは、
<emphasis>参照による代入</emphasis> です。
この場合、新規の変数は元の変数を参照するだけです。
(言いかえると、元の変数の"エイリアスを作る"または元の変数を"指す")
@@ -111,7 +111,7 @@
<simpara>
これらの要因はあるものの、<ulink
url="&url.apache;">Apache</ulink> 1.3.6のデフォルトインストールを
- 行い、PHP3をモジュールとしてデフォルトインストールを行った状態で
+ 行い、PHP 3をモジュールとしてデフォルトインストールを行った状態で
定義済みの変数のリストを以下に示します。
</simpara>
<simpara>
@@ -136,13 +136,14 @@
作成されるものです。他のWebサーバーを実行している場合には、
同じ変数が提供される保証はありません。いくつかの変数が
省略されたり、このリストにない別の変数が提供されている
- 可能性があります。
- このリストにある変数の多くは、 <ulink url="&url.cgispec;">CGI 1.1 の規約</ulink>に
- 記述されており、他のWebサーバーでも利用可能であると期待することができます。
+ 可能性があります。このリストにある変数の多くは、 <ulink
+ url="&url.cgispec;">CGI 1.1の規約</ulink>に記述されており、他の
+ Webサーバーでも利用可能であると期待することができます。
</simpara>
<simpara>
- 数は少ないですが、これらの変数のいくつかはPHPをコマンドラインで実行している時のみ
- 利用可能(または意味がある)であるということに注意して下さい。
+ 数は少ないですが、これらの変数のいくつかはPHPをコマンドラインで実
+ 行している時のみ利用可能(または意味がある)であるということに注意
+ して下さい。
</simpara>
<para>
@@ -201,7 +202,7 @@
<term>QUERY_STRING</term>
<listitem>
<simpara>
- クエリー文字列。または、ページがアクセスされたパス。
+ クエリー文字列。または、ページがアクセスされたパス。
</simpara>
</listitem>
</varlistentry>
@@ -231,7 +232,7 @@
<listitem>
<simpara>
現在のリクエストにおける<literal>Accept-Charset:</literal>ヘッダーの内容。
- ただし、該当するヘッダーがある場合のみ定義されます。例えば、
+ ただし、該当するヘッダーがある場合のみ定義されます。例えば、
'iso-8859-1,*,utf-8'。
</simpara>
</listitem>
@@ -242,7 +243,7 @@
<listitem>
<simpara>
現在のリクエストにおける<literal>Accept-Encoding:</literal>ヘッダーの内容。
- ただし、該当するヘッダーがある場合のみ定義されます。例えば、'gzip'。
+ ただし、該当するヘッダーがある場合のみ定義されます。例えば、'gzip'。
</simpara>
</listitem>
</varlistentry>
@@ -252,7 +253,7 @@
<listitem>
<simpara>
現在のリクエストにおける<literal>Accept-Language:</literal>ヘッダーの内容。
- ただし、該当するヘッダーがある場合のみ定義されます。例えば、'en'。
+ ただし、該当するヘッダーがある場合のみ定義されます。例えば、'en'。
</simpara>
</listitem>
</varlistentry>
@@ -262,7 +263,7 @@
<listitem>
<simpara>
現在のリクエストにおける<literal>Connection:</literal>ヘッダーの内容。
- ただし、該当するヘッダーがある場合のみ定義されます。例えば、'Keep-Alive'。
+ ただし、該当するヘッダーがある場合のみ定義されます。例えば、'Keep-Alive'。
</simpara>
</listitem>
</varlistentry>
@@ -272,7 +273,7 @@
<listitem>
<simpara>
現在のリクエストにおける<literal>Host:</literal>ヘッダーの内容。
- ただし、該当するヘッダーがある場合のみ定義されます。
+ ただし、該当するヘッダーがある場合のみ定義されます。
</simpara>
</listitem>
</varlistentry>
@@ -281,9 +282,9 @@
<term>HTTP_REFERER</term>
<listitem>
<simpara>
- ブラウザから現在のページを参照する際のページアドレス。
- この変数は、ユーザーのブラウザにより設定されます。全てのブラウザが
- この変数を設定するわけではありません。
+ ブラウザから現在のページを参照する際のページアドレス。
+ この変数は、ユーザーのブラウザにより設定されます。全てのブラウザが
+ この変数を設定するわけではありません。
</simpara>
</listitem>
</varlistentry>
@@ -729,7 +730,7 @@
<simpara>
ここまでで、二つの変数が定義され、PHP シンボルツリーに定義されてい
ます。これらは、"hello" を値とする<varname>$a</varname>と "world"
- を値とする<varname>$hello</varname>です。そこで、次の命令、
+ を値とする<varname>$hello</varname>です。そこで、次の命令
</simpara>
<informalexample>
<programlisting role="php">
@@ -877,7 +878,7 @@
クッキーは、パスまたはドメインが異ならない限り、
以前のクッキーをブラウザ上の同じ名前の変数に置き換えることに
注意してください。
- さて、買い篭(Shopping Cart) プログラムの場合、カウンタを保持し、
+ さて、買い牧ϭ(Shopping Cart) プログラムの場合、カウンタを保持し、
受け渡したいと思うかもしれません。
これは、次のようになります。
</simpara>
- Next message: Sebastian Bergmann: "[PHP-DOC] cvs: phpdoc /de/language references.xml"
- Previous message: Jani Taskinen: "[PHP-DOC] cvs: phpdoc /en/functions var.xml"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
