cvs: phpdoc /ja/functions i18n.xml satellite.xml sem.xml sesam.xml session.xml shmop.xml snmp.xml sockets.xml solid.xml strings.xml swf.xml sybase.xml
uodbc.xml url.xml var.xml

From: Date: Sun, 27 Jan 2002 12:01:57 +0000
Subject: cvs: phpdoc /ja/functions i18n.xml satellite.xml sem.xml sesam.xml session.xml shmop.xml snmp.xml sockets.xml solid.xml strings.xml swf.xml sybase.xml
uodbc.xml url.xml var.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969341652@lists.php.net to get a copy of this message
hirokawa Sun Jan 27 07:01:57 2002 EDT Removed files: /phpdoc/ja/functions i18n.xml solid.xml Modified files: /phpdoc/ja/functions satellite.xml sem.xml sesam.xml session.xml shmop.xml snmp.xml sockets.xml strings.xml swf.xml sybase.xml uodbc.xml url.xml var.xml Log: update translation.

Index: phpdoc/ja/functions/satellite.xml diff -u phpdoc/ja/functions/satellite.xml:1.7 phpdoc/ja/functions/satellite.xml:1.8 --- phpdoc/ja/functions/satellite.xml:1.7 Wed Dec 12 15:53:37 2001 +++ phpdoc/ja/functions/satellite.xml Sun Jan 27 07:01:55 2002 @@ -1,4 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.8 $ --> <reference id="ref.satellite"> <title>Satellite CORBA クライアント拡張</title> <titleabbrev>Satellite</titleabbrev> @@ -25,6 +26,7 @@ <paramdef>string <parameter>ior</parameter></paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> このクラスによりCORBAオブジェクトへのアクセスが可能になります。パ ラメータ<parameter>ior</parameter>は、リモートオブジェクトを指定 @@ -34,13 +36,15 @@ <para> <example> <title>IDL ファイルのサンプル</title> - <programlisting role="php"> + <programlisting role="idl"> +<![CDATA[ interface MyInterface { void SetInfo (string info); string GetInfo(); attribute int value; } +]]> </programlisting> </example> </para> @@ -48,7 +52,8 @@ <example> <title>MyInterfaceにアクセスするためのPHPコード</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $obj = new OrbitObject ($ior); $obj->SetInfo ("A 2GooD object"); @@ -59,6 +64,7 @@ echo $obj->value; ?> +]]> </programlisting> </example> </para> @@ -78,6 +84,7 @@ <paramdef>string <parameter>id</parameter></paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> このクラスは、パラメータ<parameter>id</parameter>で指定した連番を 表します。<parameter>id</parameter> は、連番の名前(例: "MyEnum") @@ -86,10 +93,12 @@ <para> <example> <title>IDLファイルのサンプル</title> - <programlisting> + <programlisting role="idl"> +<![CDATA[ enum MyEnum { a,b,c,d,e }; +]]> </programlisting> </example> </para> @@ -97,13 +106,15 @@ <example> <title>MyEnumにアクセスするためのPHPコード</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $enum = new OrbitEnum ("MyEnum"); echo $enum->a; /* 0を出力 */ echo $enum->c; /* 2を出力 */ echo $enum->e; /* 4を出力 */ ?> +]]> </programlisting> </example> </para> @@ -123,6 +134,7 @@ <paramdef>string <parameter>id</parameter></paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> このクラスは、パラメータ<parameter>id</parameter>で指定した構造体 を表します。<parameter>id</parameter> は、構造体の名前(例: @@ -132,7 +144,8 @@ <para> <example> <title>IDLファイルのサンプル</title> - <programlisting> + <programlisting role="idl"> +<![CDATA[ struct MyStruct { short shortvalue; string stringvalue; @@ -142,6 +155,7 @@ void SetValues (MyStruct values); MyStruct GetValues(); } +]]> </programlisting> </example> </para> @@ -149,7 +163,8 @@ <example> <title>MyStructをアクセスするPHPコード</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $obj = new OrbitObject ($ior); $initial_values = new OrbitStruct ("IDL:MyStruct:1.0"); @@ -163,6 +178,7 @@ echo $values->shortvalue; echo $values->stringvalue; ?> +]]> </programlisting> </example> </para> @@ -192,8 +208,9 @@ <para> <example> <title>IDLファイルのサンプル</title> - <programlisting> -/* ++?????++ Out of Cheese エラー。 最初から再度実行。 */ + <programlisting role="idl"> +<![CDATA[ +/* ++?????++ Out of Cheese Error. Redo From Start. */ exception OutOfCheeseError { int parameter; } @@ -201,6 +218,7 @@ interface AnotherInterface { void AskWhy() raises (OutOfCheeseError); } +]]> </programlisting> </example> </para> @@ -208,7 +226,8 @@ <example> <title>CORBA例外を処理するPHPコード</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $obj = new OrbitObject ($ior); $obj->AskWhy(); @@ -220,6 +239,7 @@ } } ?> +]]> </programlisting> </example> </para> @@ -239,6 +259,7 @@ <paramdef></paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> レポジトリID文字列を返します。(例:"IDL:MyException:1.0")例として は、<function>satellite_caught_exception</function>の使用例を参照 @@ -264,10 +285,75 @@ <paramdef></paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> 例外構造体を返します。例については、 <function>satellite_caught_exception</function>の使用例を参照下さ い。 + </para> + </refsect1> + </refentry> + + <refentry id='function.satellite-object-to-string'> + <refnamediv> + <refname>satellite_object_to_string</refname> + <refpurpose> + オブジェクトを文字列表現に変換する + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>satellite_object_to_string</function></funcdef> + <paramdef>object <parameter>obj</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.satellite-load-idl'> + <refnamediv> + <refname>satellite_load_idl</refname> + <refpurpose> + IDLファイルがロード済みでない場合、タイプマネージャにロードを指示 + する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>satellite_load_idl</function></funcdef> + <paramdef>string <parameter>file</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.satellite-get-repository-id'> + <refnamediv> + <refname>satellite_get_repository_id</refname> + <refpurpose> + NOT IMPLEMENTED + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>satellite_get_repository_id</function></funcdef> + <paramdef>object <parameter>obj</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; </para> </refsect1> </refentry> Index: phpdoc/ja/functions/sem.xml diff -u phpdoc/ja/functions/sem.xml:1.8 phpdoc/ja/functions/sem.xml:1.9 --- phpdoc/ja/functions/sem.xml:1.8 Wed Dec 12 15:53:38 2001 +++ phpdoc/ja/functions/sem.xml Sun Jan 27 07:01:55 2002 @@ -1,8 +1,9 @@ <?xml version="1.0" encoding="utf-8"?> - +<!-- $Revision: 1.9 $ --> <reference id="ref.sem"> - <title>セマフォおよび共有メモリ関数</title> + <title>セマフォおよび共有メモリ関数(semaphore)</title> <titleabbrev>Semaphore</titleabbrev> + <partintro> <para> このモジュールは、システム V セマフォを用いてセマフォ関数を提供します。 @@ -117,7 +118,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>sem_acquire</function></funcdef> + <funcdef>bool <function>sem_acquire</function></funcdef> <paramdef>int <parameter>sem_identifier</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -157,7 +158,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>sem_release</function></funcdef> + <funcdef>bool <function>sem_release</function></funcdef> <paramdef>int <parameter>sem_identifier</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -185,6 +186,45 @@ </refsect1> </refentry> + <refentry id="function.sem-remove"> + <refnamediv> + <refname>sem_remove</refname> + <refpurpose>セマフォを削除する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>sem_remove</function></funcdef> + <paramdef>int <parameter>sem_identifier</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + 返り値: 成功時に&true;、エラー時に&false; + </para> + <para> + <function>sem_remove</function>は、セマフォ + <parameter>sem_identifier</parameter>が + <function>sem_get</function>により作成されている場合にそのセマフォ + を削除します。それ以外の場合は、警告を発生します。 + </para> + <para> + セマフォを削除した後、そのセマフォにはもうアクセスできません。 + </para> + <para> + <function>sem_get</function>, + <function>sem_release</function>, + <function>sem_acquire</function>も参照下さい。 + </para> + <note> + <simpara> + この関数は、Windowsシステムでは動作しません。この関数はPHP 4.1.0 + で追加されました。 + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.shm-attach"> <refnamediv> <refname>shm_attach</refname> @@ -366,6 +406,28 @@ この関数は、Windowsシステムでは動作しません。 </simpara> </note> + </refsect1> + </refentry> + + <refentry id='function.ftok'> + <refnamediv> + <refname>ftok</refname> + <refpurpose> + パス名とプロジェクトIDをSystem V IPCキーに変換する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ftok</function></funcdef> + <paramdef>string <parameter>pathname</parameter></paramdef> + <paramdef>string <parameter>proj</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> </refsect1> </refentry> Index: phpdoc/ja/functions/sesam.xml diff -u phpdoc/ja/functions/sesam.xml:1.10 phpdoc/ja/functions/sesam.xml:1.11 --- phpdoc/ja/functions/sesam.xml:1.10 Fri Dec 21 04:41:35 2001 +++ phpdoc/ja/functions/sesam.xml Sun Jan 27 07:01:56 2002 @@ -61,7 +61,10 @@ 例: <informalexample> <programlisting role="apache"> -php3_sesam_oml $.SYSLNK.SESAM-SQL.030</programlisting> +<![CDATA[ +php3_sesam_oml $.SYSLNK.SESAM-SQL.030 +]]> + </programlisting> </informalexample> </para> </entry> @@ -76,16 +79,20 @@ 例: <informalexample> <programlisting role="apache"> +<![CDATA[ php3_sesam_configfile $SESAM.SESAM.CONF.AW +]]> </programlisting> </informalexample> 通常、次のような設定が含まれます。(SESAMリファレンスマニュ アルを参照) <informalexample> <programlisting role="bs2000"> +<![CDATA[ CNF=B NAM=K NOTYPE +]]> </programlisting> </informalexample> </para> @@ -102,7 +109,9 @@ 例: <informalexample> <programlisting role="apache"> +<![CDATA[ php3_sesam_messagecatalog $.SYSMES.SESAM-SQL.030 +]]> </programlisting> </informalexample> </para> @@ -435,19 +444,22 @@ <example> <title>"複数フィールド"カラムを作成する</title> <programlisting role="sesam"> -CREATE TABLE multi_field_test -( - pkey CHAR(20) PRIMARY KEY, - multi(3) CHAR(12) +<![CDATA[ +CREATE TABLE multi_field_test ( + pkey CHAR(20) PRIMARY KEY, + multi(3) CHAR(12) ) +]]> </programlisting> </example> 上のレコードに次のように代入することができます。 <example> <title>"複数フィールド"カラムに代入する</title> <programlisting role="sesam"> -INSERT INTO multi_field_test ( pkey, multi(2..3) ) - VALUES ( 'Second', &lt;'first_val','second_val'&gt;) +<![CDATA[ +INSERT INTO multi_field_test (pkey, multi(2..3) ) + VALUES ('Second', <'first_val', 'second_val'>) +]]> </programlisting> </example> (この場合のように)先頭の空のサブフィールドは無視され、代入された @@ -519,10 +531,12 @@ <example> <title>SESAM データベースへの接続</title> <programlisting role="php"> -&lt;?php -if (! sesam_connect ("mycatalog", "myschema", "otto") - die("SESAMに接続できません"; -?&gt; +<![CDATA[ +<?php +if (!sesam_connect ("mycatalog", "myschema", "otto") + die("Unable to connect to SESAM"); +?> +]]> </programlisting> </example> </para> @@ -569,9 +583,12 @@ <example> <title>SESAM 接続を閉じる</title> <programlisting role="php"> +<![CDATA[ if (sesam_connect ("mycatalog", "myschema", "otto")) { -... クエリ等 ... -sesam_disconnect(); } + ... some queries and stuff ... + sesam_disconnect(); +} +]]> </programlisting> </example> </para> @@ -684,10 +701,12 @@ <example> <title>SESAM トランザクションパラメータを設定する</title> <programlisting role="php"> -&lt;?php -sesam_settransaction(SESAM_TXISOL_REPEATABLE_READ, +<![CDATA[ +<?php +sesam_settransaction (SESAM_TXISOL_REPEATABLE_READ, SESAM_TXREAD_READONLY); -?&gt; +?> +]]> </programlisting> </example> </para> @@ -730,14 +749,16 @@ <example> <title>SESAM データベースの更新をコミットする</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php if (sesam_connect ("mycatalog", "myschema", "otto")) { - if (!sesam_execimm("INSERT INTO mytable VALUES (*, 'Small Test', &lt;0, 8, 15&gt;)")) - die("insert failed"); - if (!sesam_commit()) - die("commit failed"); + if (!sesam_execimm ("INSERT INTO mytable VALUES (*, 'Small Test', <0, 8, 15>)")) + die("insert failed"); + if (!sesam_commit()) + die("commit failed"); } -?&gt; +?> +]]> </programlisting> </example> </para> @@ -777,15 +798,17 @@ <example> <title>SESAM データベースへの更新を破棄する</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php if (sesam_connect ("mycatalog", "myschema", "otto")) { - if (sesam_execimm("INSERT INTO mytable VALUES (*, 'Small Test', &lt;0, 8, 15&gt;)") - &amp;&amp; sesam_execimm("INSERT INTO othertable VALUES (*, 'Another Test', 1)")) - sesam_commit(); - else - sesam_rollback(); + if (sesam_execimm ("INSERT INTO mytable VALUES (*, 'Small Test', <0, 8, 15>)") + && sesam_execimm ("INSERT INTO othertable VALUES (*, 'Another Test', 1)")) + sesam_commit(); + else + sesam_rollback(); } -?&gt; +?> +]]> </programlisting> </example> </para> @@ -834,12 +857,14 @@ <para> <informalexample> <programlisting role="php"> -$stmt = "INSERT INTO mytable VALUES('one', 'two')"; +<![CDATA[ +$stmt = "INSERT INTO mytable VALUES ('one', 'two')"; $result = sesam_execimm ($stmt); $err = sesam_diagnostic(); -print("sqlstate = ".$err["sqlstate"]."\n". - "Affected rows = ".$err["rowcount"]." == ". - sesam_affected_rows($result)."\n"); +print ("sqlstate = ".$err["sqlstate"]."\n". + "Affected rows = ".$err["rowcount"]." == ". + sesam_affected_rows($result)."\n"); +]]> </programlisting> </informalexample> <function>sesam_query</function> および @@ -857,7 +882,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>resource <function>sesam_query</function></funcdef> + <funcdef>string <function>sesam_query</function></funcdef> <paramdef>string <parameter>query</parameter></paramdef> <paramdef>bool <parameter> @@ -907,51 +932,55 @@ "phone"テーブルの全てのレコードをHTMLテーブルとして表示 </title> <programlisting role="php"> -&lt;?php -if (!sesam_connect("phonedb", "demo", "otto")) - die("接続できません"); -$result = sesam_query("select * from phone"); +<![CDATA[ +<?php +if (!sesam_connect ("phonedb", "demo", "otto")) + die ("cannot connect"); +$result = sesam_query ("select * from phone"); if (!$result) { - $err = sesam_diagnostic(); - die($err["errmsg"]); + $err = sesam_diagnostic(); + die ($err["errmsg"]); } -echo "&lt;TABLE BORDER&gt;\n"; -// 上の結果カラム名でタイトルヘッダを追加する -if ($cols = sesam_field_array($result)) { - echo " &lt;TR&gt;&lt;TH COLSPAN=".$cols["count"]."&gt;Result:&lt;/TH&gt;&lt;/TR&gt;\n"; - echo " &lt;TR&gt;\n"; - for ($col = 0; $col &lt; $cols["count"]; ++$col) { - $colattr = $cols[$col]; - /* SESAMの"複数テーブル"にまたがらテーブルヘッドを展開: */ - if ($colattr["count"] &gt; 1) { - echo " &lt;TH COLSPAN=".$colattr["count"]."&gt;".$colattr["name"]. - "(1..".$colattr["count"].")&lt;/TH&gt;\n"; - $col += $colattr["count"] - 1; +echo "<TABLE BORDER>\n"; +// Add title header with column names above the result: +if ($cols = sesam_field_array ($result)) { + echo " <TR><TH COLSPAN=".$cols["count"].">Result:</TH></TR>\n"; + echo " <TR>\n"; + for ($col = 0; $col < $cols["count"]; ++$col) { + $colattr = $cols[$col]; + /* Span the table head over SESAM's "Multiple Fields": */ + if ($colattr["count"] > 1) { + echo " <TH COLSPAN=".$colattr["count"].">".$colattr["name"]. + "(1..".$colattr["count"].")</TH>\n"; + $col += $colattr["count"] - 1; + } else + echo " <TH>" . $colattr["name"] . "</TH>\n"; } - else - echo " &lt;TH&gt;" . $colattr["name"] . "&lt;/TH&gt;\n"; - } - echo " &lt;/TR&gt;\n"; + echo " </TR>\n"; } do { - // 最大100レコード分の結果を取得 - $ok = sesam_fetch_result($result,100); - for ($row=0; $row &lt; $ok["rows"]; ++$row) { - echo " &lt;TR&gt;\n"; - for ($col = 0; $col &lt; $ok["cols"]; ++$col) { - if (isset($ok[$col][$row])) - echo " &lt;TD&gt;" . $ok[$col][$row] . "&lt;/TD&gt;\n"; - else - echo " &lt;TD&gt;-empty-&lt;/TD&gt;\n"; + // Fetch the result in chunks of 100 rows max. + $ok = sesam_fetch_result ($result, 100); + for ($row=0; $row < $ok["rows"]; ++$row) { + echo " <TR>\n"; + for ($col = 0; $col < $ok["cols"]; ++$col) { + if (isset($ok[$col][$row])) + echo " <TD>" . $ok[$col][$row] . "</TD>\n"; + } else { + echo " <TD>-empty-</TD>\n"; + } + } + echo " </TR>\n"; } - echo " &lt;/TR&gt;\n"; - } -} while ($ok["truncated"]); // まだデータがある可能性がある間 -echo "&lt;/TABLE&gt;\n"; -// 結果IDを開放 +} +while ($ok["truncated"]) { // while there may be more data + echo "</TABLE>\n"; +} +// free result id sesam_free_result($result); -?&gt; +?> +]]> </programlisting> </example> </para> @@ -1100,7 +1129,8 @@ <example> <title>エラー位置を付けてSESAMエラーメッセージを表示</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php // フォーマットされたエラーメッセージを出力する関数 // SQL命令における構文エラーの場所を表示 function PrintReturncode($exec_str) @@ -1113,58 +1143,58 @@ --$colspan; if ($err["rowcount"] == 0) --$colspan; - echo "&lt;TABLE BORDER&gt;\n"; - echo "&lt;TR&gt;&lt;TH COLSPAN=".$colspan."&gt;&lt;FONT COLOR=red&gt;ERROR:&lt;/FONT&gt; ". - htmlspecialchars($err["errmsg"])."&lt;/TH&gt;&lt;/TR&gt;\n"; - if ($err["errcol"] &gt;= 0) { - echo "&lt;TR&gt;&lt;TD COLSPAN=".$colspan."&gt;&lt;PRE&gt;\n"; - $errstmt = $exec_str."\n"; - for ($lin=0; $errstmt != ""; ++$lin) { - if ($lin != $err["errlin"]) { // $lin はerrlinより小さいかまたは大きい - if (! ($i = strchr($errstmt, "\n"))) - $i = ""; - $line = substr($errstmt, 0, strlen($errstmt)-strlen($i)+1); - $errstmt = substr($i, 1); - if ($line != "\n") - print htmlspecialchars($line); - } - else { - if (! ($i = strchr($errstmt, "\n"))) - $i = ""; - $line = substr($errstmt, 0, strlen($errstmt)-strlen($i)+1); - $errstmt = substr($i, 1); - for ($col=0; $col &lt; $err["errcol"]; ++$col) - echo (substr($line, $col, 1) == "\t") ? "\t" : "."; - echo "&lt;FONT COLOR=RED&gt;&lt;BLINK&gt;\\&lt;/BLINK&gt;&lt;/FONT&gt;\n"; - print "&lt;FONT COLOR=\"#880000\"&gt;".htmlspecialchars($line)."&lt;/FONT&gt;"; - for ($col=0; $col &lt; $err["errcol"]; ++$col) - echo (substr($line, $col, 1) == "\t") ? "\t" : "."; - echo "&lt;FONT COLOR=RED&gt;&lt;BLINK&gt;/&lt;/BLINK&gt;&lt;/FONT&gt;\n"; - } - } - echo "&lt;/PRE&gt;&lt;/TD&gt;&lt;/TR&gt;\n"; - } - echo "&lt;TR&gt;\n"; - echo " &lt;TD&gt;sqlstate=" . $err["sqlstate"] . "&lt;/TD&gt;\n"; - if ($err["errlin"] != -1) - echo " &lt;TD&gt;errlin=" . $err["errlin"] . "&lt;/TD&gt;\n"; - if ($err["errcol"] != -1) - echo " &lt;TD&gt;errcol=" . $err["errcol"] . "&lt;/TD&gt;\n"; - if ($err["rowcount"] != 0) - echo " &lt;TD&gt;rowcount=" . $err["rowcount"] . "&lt;/TD&gt;\n"; - echo "&lt;/TR&gt;\n"; - echo "&lt;/TABLE&gt;\n"; + echo "<TABLE BORDER>\n"; + echo "<TR><TH COLSPAN=".$colspan."><FONT COLOR=red>ERROR:</FONT> ". + htmlspecialchars($err["errmsg"])."</TH></TR>\n"; + if ($err["errcol"] >= 0) { + echo "<TR><TD COLSPAN=".$colspan."><PRE>\n"; + $errstmt = $exec_str."\n"; + for ($lin=0; $errstmt != ""; ++$lin) { + if ($lin != $err["errlin"]) { // $lin is less or greater than errlin + if (!($i = strchr ($errstmt, "\n"))) + $i = ""; + $line = substr ($errstmt, 0, strlen($errstmt)-strlen($i)+1); + $errstmt = substr($i, 1); + if ($line != "\n") + print htmlspecialchars ($line); + } else { + if (! ($i = strchr ($errstmt, "\n"))) + $i = ""; + $line = substr ($errstmt, 0, strlen ($errstmt)-strlen($i)+1); + $errstmt = substr($i, 1); + for ($col=0; $col < $err["errcol"]; ++$col) + echo (substr($line, $col, 1) == "\t") ? "\t" : "."; + echo "<FONT COLOR=RED><BLINK>\\</BLINK></FONT>\n"; + print "<FONT COLOR=\"#880000\">".htmlspecialchars($line)."</FONT>"; + for ($col=0; $col < $err["errcol"]; ++$col) + echo (substr ($line, $col, 1) == "\t") ? "\t" : "."; + echo "<FONT COLOR=RED><BLINK>/</BLINK></FONT>\n"; + } + } + echo "</PRE></TD></TR>\n"; + } + echo "<TR>\n"; + echo " <TD>sqlstate=" . $err["sqlstate"] . "</TD>\n"; + if ($err["errlin"] != -1) + echo " <TD>errlin=" . $err["errlin"] . "</TD>\n"; + if ($err["errcol"] != -1) + echo " <TD>errcol=" . $err["errcol"] . "</TD>\n"; + if ($err["rowcount"] != 0) + echo " <TD>rowcount=" . $err["rowcount"] . "</TD>\n"; + echo "</TR>\n"; + echo "</TABLE>\n"; } -if (!sesam_connect("mycatalog", "phoneno", "otto")) - die("接続できません"); +if (!sesam_connect ("mycatalog", "phoneno", "otto")) + die ("cannot connect"); $stmt = "SELECT * FROM phone\n". - " WHERE@ LASTNAME='KRAEMER'\n". - " ORDER BY FIRSTNAME"; -if (! ($result = sesam_query($stmt))) - PrintReturncode($stmt); -?&gt; + " WHERE@ LASTNAME='KRAEMER'\n". + " ORDER BY FIRSTNAME"; +if (!($result = sesam_query ($stmt))) + PrintReturncode ($stmt); +?> +]]> </programlisting> </example> </para> @@ -1308,12 +1338,14 @@ </para> <informalexample> <programlisting role="php"> -$result = sesam_execimm ("DELETE FROM PHONE WHERE LASTNAME = '".strtoupper($name)."'"); -if (! $result) { - ... エラー ... +<![CDATA[ +$result = sesam_execimm ("DELETE FROM PHONE WHERE LASTNAME = '".strtoupper ($name)."'"); +if (!$result) { + ... error ... } -print sesam_affected_rows($result). - " entries with last name ".$name." deleted.\n" +print sesam_affected_rows ($result). + " entries with last name ".$name." deleted.\n" +]]> </programlisting> </informalexample> </refsect1> @@ -1337,8 +1369,10 @@ </para> <informalexample> <programlisting role="php"> -if (!sesam_execimm($stmt)) - printf("%s&lt;br&gt;\n", sesam_errormsg()); +<![CDATA[ +if (!sesam_execimm ($stmt)) + printf ("%s<br>\n", sesam_errormsg()); +]]> </programlisting> </informalexample> <para> @@ -1573,9 +1607,9 @@ れた有効な結果IDです。 </para> <para> - <parameter><replaceable><optional>whence</optional></replaceable></parameter> - は、"スクロール型"カーソルで取得処理を行うためのオプションパラメー - タで、次のような定義済みの定数を設定することが可能です。 + <parameter>whence</parameter>は、"スクロール型"カーソルで取得処理 + を行うためのオプションパラメータで、次のような定義済みの定数を設 + 定することが可能です。 <table> <title><parameter>"whence"</parameter> パラメータで有効な値</title> <tgroup cols="3"> @@ -1644,18 +1678,16 @@ </para> <para> "スクロール型"カーソルを使用している場合、カーソルは結果集合を自 - 由に移動可能です。 - <parameter><replaceable><optional>whence</optional></replaceable></parameter> パラメータが省 - 略された場合、スクロールの型には、グローバルなデフォルト値 + 由に移動可能です。<parameter>whence</parameter> パラメータが省略 + された場合、スクロールの型には、グローバルなデフォルト値 (<literal>SESAM_SEEK_NEXT</literal>に初期化されており、 <function>sesam_seek_row</function>で設定可能です) が使用されます。 - <parameter><replaceable><optional>whence</optional></replaceable></parameter> が指定された場 - 合、その値はグローバルデフォルト値に置換されます。 + <parameter>whence</parameter> が指定された場合、その値はグローバ + ルデフォルト値に置換されます。 </para> <para> - <parameter><replaceable><optional>offset</optional></replaceable></parameter> は、オプション - のパラメータであり、 - <parameter><replaceable><optional>whence</optional></replaceable></parameter> が + <parameter>offset</parameter> は、オプションのパラメータであり、 + <parameter>whence</parameter> が <literal>SESAM_SEEK_RELATIVE</literal> または <literal>SESAM_SEEK_ABSOLUTE</literal> のどちらかである場合にのみ 評価されます(そして必要とされます)。このパラメータは、"スクロール @@ -1681,28 +1713,30 @@ <example> <title>SESAM レコードを取得</title> <programlisting role="php"> -&lt;?php -$result = sesam_query (&quot;SELECT * FROM phone\n&quot;. - &quot; WHERE LASTNAME='&quot;.strtoupper($name).&quot;'\n&quot;. - &quot; ORDER BY FIRSTNAME&quot;, 1); -if (! $result) { - ... エラー ... +<![CDATA[ +<?php +$result = sesam_query ("SELECT * FROM phone\n". + " WHERE LASTNAME='".strtoupper($name)."'\n". + " ORDER BY FIRSTNAME", 1); +if (!$result) { + ... error ... } -// 逆順にテーブルを出力 -print &quot;&lt;TABLE BORDER&gt;\n&quot;; +// print the table in backward order +print "<TABLE BORDER>\n"; $row = sesam_fetch_row ($result, SESAM_SEEK_LAST); -while (is_array($row)) { - print &quot; &lt;TR&gt;\n&quot;; - for($col = 0; $col &lt; $row[&quot;count&quot;]; ++$col) { - print &quot; &lt;TD&gt;&quot;.htmlspecialchars($row[$col]).&quot;&lt;/TD&gt;\n&quot;; +while (is_array ($row)) { + print " <TR>\n"; + for ($col = 0; $col < $row["count"]; ++$col) { + print " <TD>".htmlspecialchars ($row[$col])."</TD>\n"; } - print &quot; &lt;/TR&gt;\n&quot;; - // 暗黙の SESAM_SEEK_PRIOR を使用 + print " </TR>\n"; + // use implied SESAM_SEEK_PRIOR $row = sesam_fetch_row ($result); } -print &quot;&lt;/TABLE&gt;\n&quot;; +print "</TABLE>\n"; sesam_free_result ($result); -?&gt; +?> +]]> </programlisting> </example> <para> @@ -1752,10 +1786,9 @@ れた有効な結果IDです。 </para> <para> - オプションの <parameter><replaceable><optional>whence</optional></replaceable></parameter> - および <parameter><replaceable><optional>offset</optional></replaceable></parameter> パラメー - タの有効な値の詳細については、関数 - <function>sesam_fetch_row</function> を参照下さい。 + オプションの<parameter>whence</parameter>および + <parameter>offset</parameter>パラメータの有効な値の詳細については、 + 関数<function>sesam_fetch_row</function> を参照下さい。 </para> <para> <function>sesam_fetch_array</function> は、 @@ -1771,8 +1804,10 @@ <function>sesam_fetch_row</function>をコールするかそのカラムへの エイリアスを作成して下さい。 <informalexample> - <programlisting> + <programlisting role="sesam"> +<![CDATA[ SELECT TBL1.COL AS FOO, TBL2.COL AS BAR FROM TBL1, TBL2 +]]> </programlisting> </informalexample> </para> @@ -1786,7 +1821,9 @@ 次のように宣言されているあるカラムの場合、 <informalexample> <programlisting role="sesam"> +<![CDATA[ CREATE TABLE ... ( ... MULTI(3) INT ) +]]> </programlisting> </informalexample> 個々の"複数フィールド"カラムに関して連想添字は、それぞれ @@ -1801,25 +1838,27 @@ <example> <title>SESAM 取得配列</title> <programlisting role="php"> -&lt;?php -$result = sesam_query (&quot;SELECT * FROM phone\n&quot;. - &quot; WHERE LASTNAME='&quot;.strtoupper($name).&quot;'\n&quot;. - &quot; ORDER BY FIRSTNAME&quot;, 1); -if (! $result) { - ... エラー ... +<![CDATA[ +<?php +$result = sesam_query ("SELECT * FROM phone\n". + " WHERE LASTNAME='".strtoupper($name)."'\n". + " ORDER BY FIRSTNAME", 1); +if (!$result) { + ... error ... } -// テーブルを出力します -print &quot;&lt;TABLE BORDER&gt;\n&quot;; -while (($row = sesam_fetch_array ($result)) &amp;&amp; count($row) &gt; 0) { - print &quot; &lt;TR&gt;\n&quot;; - print &quot; &lt;TD&gt;&quot;.htmlspecialchars($row[&quot;firstname&quot;]).&quot;&lt;/TD&gt;\n&quot;; - print &quot; &lt;TD&gt;&quot;.htmlspecialchars($row[&quot;lastname&quot;]).&quot;&lt;/TD&gt;\n&quot;; - print &quot; &lt;TD&gt;&quot;.htmlspecialchars($row[&quot;phoneno&quot;]).&quot;&lt;/TD&gt;\n&quot;; - print &quot; &lt;/TR&gt;\n&quot;; +// print the table: +print "<TABLE BORDER>\n"; +while (($row = sesam_fetch_array ($result)) && count ($row) > 0) { + print " <TR>\n"; + print " <TD>".htmlspecialchars ($row["firstname"])."</TD>\n"; + print " <TD>".htmlspecialchars ($row["lastname"])."</TD>\n"; + print " <TD>".htmlspecialchars ($row["phoneno"])."</TD>\n"; + print " </TR>\n"; } -print &quot;&lt;/TABLE&gt;\n&quot;; +print "</TABLE>\n"; sesam_free_result ($result); -?&gt; +?> +]]> </programlisting> </example> <para> @@ -1930,9 +1969,9 @@ </table> </para> <para> - <parameter><replaceable><optional>offset</optional></replaceable></parameter> は、オプション - のパラメータであり、<parameter>whence</parameter> が - <literal>SESAM_SEEK_RELATIVE</literal> または + <parameter>offset</parameter>は、オプションのパラメータであり、 + <parameter>whence</parameter>が + <literal>SESAM_SEEK_RELATIVE</literal>または <literal>SESAM_SEEK_ABSOLUTE</literal> のどちらかである場合にのみ 評価されます(また必要とされます)。 </para> Index: phpdoc/ja/functions/session.xml diff -u phpdoc/ja/functions/session.xml:1.26 phpdoc/ja/functions/session.xml:1.27 --- phpdoc/ja/functions/session.xml:1.26 Wed Dec 12 15:53:40 2001 +++ phpdoc/ja/functions/session.xml Sun Jan 27 07:01:56 2002 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.27 $ --> <reference id="ref.session"> - <title>セッション処理関数</title> + <title>セッション処理関数(session)</title> <titleabbrev>セッション</titleabbrev> <partintro> @@ -49,6 +50,14 @@ に on となりました。 </para> </note> + <note> + <para> + PHP 4.1.0以降、$_SESSIONは、$_POST, $_GET, $_REQUEST等のようにグ + ローバル変数として利用可能です。$HTTP_SESSION_VARSと異なり、 + $_SESSIONは常にグローバルです。そこで、 + <literal>global</literal>は$_SESSIONの場合は不要です。 + </para> + </note> <para> <link linkend="ini.track-vars"><literal>track_vars</literal></link> が有効で<link linkend="ini.register-globals"> @@ -63,10 +72,53 @@ が有効な時に変数を登録する </title> <programlisting role="php"> -&lt;?php -session_register("count"); -$HTTP_SESSION_VARS["count"]++; -?&gt; +<![CDATA[ +<?php +if (isset($HTTP_SESSION_VARS['count'])) { + $HTTP_SESSION_VARS['count']++; +} +else { + $HTTP_SESSION_VARS['count'] = 0; +} +?> +]]> + </programlisting> + </example> + </para> + <para> + セキュリティとコードの可読性のために$_SESSION(またはPHP 4.0.6以前 + は$HTTP_SESSION_VARS)の使用が推奨されます。$_SESSIONまたは + $HTTP_SESSION_VARSの場合、 + session_register()/session_unregister()/session_is_registered()は + 不要です。ユーザは、通常の変数と同様にセッション変数にアクセス可能 + です。 + <example> + <title> + $_SESSIONで変数を登録 + </title> + <programlisting role="php"> +<![CDATA[ +<?php +// PHP 4.0.6以前の場合は$HTTP_SESSION_VARSを使用して下さい +if (!isset($_SESSION['count'])) { + $_SESSION['count'] = 0; +} +else { + $_SESSION['count']++; +?> +]]> + </programlisting> + </example> + <example> + <title>$_SESSIONで変数の登録を解除する</title> + <programlisting role="php"> +<![CDATA[ +<?php +// PHP 4.0.6以前の場合は$HTTP_SESSION_VARSを使用して下さい +unset($_SESSION['count']); + +?> +]]> </programlisting> </example> </para> @@ -75,7 +127,19 @@ linkend="ini.register-globals"><literal>register_globals</literal></link> が有効な場合、全てのグローバル変数はセッション変数として登録するこ とが可能で、セッション変数は対応するグローバル変数として回復されま - す。 + す。PHPは、どのグローバル変数がセッション変数として登録されるのか + を知る必要があるため、ユーザは、変数をsession_register()関数で登録 + する必要があります。しかし、$HTTP_SESSION_VARS/$_SESSIONの場合は、 + session_register()を使用する必要はありません。 + <caution> + <para> + $HTTP_SESSION_VARS/$_SESSIONを使用する場合、セッションモジュール + の内部動作を知っているユーザ以外は、 + <function>session_register</function>, + <function>session_is_registered</function>, + <function>session_unregister</function>を使用しないで下さい。 + </para> + </caution> <example> <title> <link @@ -83,10 +147,17 @@ が有効な場合に、変数を登録する </title> <programlisting role="php"> -&lt;?php -session_register("count"); -$count++; -?&gt; +<![CDATA[ +<?php +if (!session_is_registered('count')) { + session_register("count"); + $count = 0; +} +else { + $count++; +} +?> +]]> </programlisting> </example> </para> @@ -95,8 +166,8 @@ linkend="ini.track-vars"><literal>track_vars</literal></link>と <link linkend="ini.register-globals"><literal>register_globals</literal></link> - が共に有効な場合、グローバル変数と$HTTP_SESSION_VARSエントリは同じ - 値へのリファレンスとなります。 + が共に有効な場合、グローバル変数と$HTTP_SESSION_VARS/$_SESSIONエン + トリは同じ値へのリファレンスとなります。 </para> <para> セッションIDの通知を行うためには次の二つの方法があります。 @@ -135,27 +206,33 @@ <example> <title>単一のユーザーに関するヒット数を数える</title> <programlisting role="php"> -&lt;?php -session_register("count"); -$count++; -?&gt; +<![CDATA[ +<?php +if (!session_is_registered('count')) { + session_register('count'); + $count = 1; +} +else { + $count++; +} +?> -こんにちは、あなたがこのページに来たのは&lt;?php echo $count; ?&gt;回目ですね。 &lt;p&gt; +こんにちは、あなたがこのページに来たのは<?php echo $count; ?>回目ですね。 <p> -&lt;php? +<?php # ユーザーがクッキーを使用不可としている場合は、セッションIDを -# 保持するために &lt;?=SID?&gt; が必要です。 -?&gt; +# 保持するために<?=SID> が必要です。 +?> -続けるには、 -&lt;A HREF="nextpage.php?&lt;?=SID?&gt;"&gt;ここをクリック&lt;/A&gt; -して下さい。 +続けるには、<A HREF="nextpage.php?<?=SID?>">ここをクリック</A>して下さい。 +]]> </programlisting> </example> </para> <para> - PHPのコンパイル時に <literal>--enable-trans-sid</literal>を指定し - た場合には、<literal>&lt;?=SID?&gt;</literal> は必要ありません。 + PHPのコンパイル時に <link linkend="install.configure.enable-trans-sid"> + <literal>--enable-trans-sid</literal></link>を指定した場合には、 + <literal>&lt;?=SID?&gt;</literal> は必要ありません。 </para> <note> <para> @@ -187,6 +264,8 @@ 引数を定義します。デフォルトのファイルハンドラ選択した場合、 ファイルが作成される場所のパスになります。デフォルトは、 <literal>/tmp</literal> です。 + <literal>session.save_path</literal>のパスの深さが2より大きい場 + 合、ガーベッジコレクションは行われません。 </simpara> </listitem> <listitem> @@ -293,6 +372,25 @@ デフォルトは、<literal>180</literal>です。 </simpara> </listitem> + <listitem> + <simpara> + <literal>session.use_trans_sid</literal>は、 + <link linkend="install.configure.enable-trans-sid"> + <literal>--enable-trans-sid</literal></link>を指定してコンパイ + ルを行うことにより有効となった場合に、透過的なセッション + IDの付加をするかどうかを指定します。 + デフォルトは、<literal>1</literal>(有効)です。 + </simpara> + </listitem> + <listitem> + <simpara> + <literal>url_rewriter.tags</literal>は、透過的なセッションIDの + 付加機能が有効となった場合に、セッションIDを含めるために書き換 + えられるHTMLタグを指定します。デフォルトは、 + <literal>a=href,area=href,frame=src,input=src,form=fakeentry</literal> + です。 + </simpara> + </listitem> </itemizedlist> <note> <para> @@ -321,13 +419,36 @@ ンに基づき現在のセッションを復帰します) </simpara> <simpara> + 名前付きのセッションを使用したい場合、 + <function>session_start</function>の前に + <function>session_name</function>をコールする必要があります。 + </simpara> + <simpara> この関数は常に &true; を返します。 </simpara> <note> <para> - この関数は、PHP 4.0 で追加されました。 + クッキーに基づくセッションを使用している場合、ブラウザに何か出力 + を行う前に<function>session_start</function>をコールする必要があ + ります。 </para> </note> + <simpara> + <function>session_start</function>は、 + <literal>trans-sid</literal>が有効の場合にURL書換え用の内部出力ハ + ンドラを登録します。ユーザが、<function>ob_start</function>と共に + <literal>ob_gzhandler</literal>または類似のものを使用している場合、 + 出力ハンドラの順番は正しく出力を行うために重要です。例えば、 + セッション開始時にユーザは<literal>ob_gzhandler</literal>を登録す + る必要があります。 + </simpara> + <note> + <simpara> + <literal>ob_gzhandler</literal>よりも + <literal>zlib.output_compression</literal>の使用が推奨されていま + す。 + </simpara> + </note> </refsect1> </refentry> @@ -346,24 +467,61 @@ </funcsynopsis> <simpara> <function>session_destroy</function>は、現在のセッションに - 関連づけられた全てのデータを破棄します。 + 関連づけられた全てのデータを破棄します。この関数は、 + セッションに関するグローバル変数を破棄しません。また、セッション + クッキーを破棄しません。 </simpara> <simpara> - この関数は成功時に&true;、失敗時にセッションデータを破棄するために - &false;を返します。 - </simpara> - <note> - <para> - この関数は、PHP 4.0で追加されました。 - </para> - </note> + この関数はセッションデータの破棄に成功した場合に&true;、失敗した + 場合に&false;を返します。 + </simpara> + <para> + <example> + <title>セッションを破棄する</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// Initialize the session. +// If you are using session_name("something"), don't forget it now! +session_start(); +// Unset all of the session variables. +session_unset(); +// Finally, destroy the session. +session_destroy(); + +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>$_SESSIONでセッションを破棄する</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// Initialize the session. +// If you are using session_name("something"), don't forget it now! +session_start(); +// Unset all of the session variables. +unset($_SESSION); +// Finally, destroy the session. +session_destroy(); + +?> +]]> + </programlisting> + </example> + </para> </refsect1> </refentry> <refentry id="function.session-name"> <refnamediv> <refname>session_name</refname> - <refpurpose>現在のセッション名を取得または設定する</refpurpose> + <refpurpose>カレントのセッション名を取得または設定する</refpurpose> </refnamediv> <refsect1> <title>説明</title> @@ -378,9 +536,9 @@ </funcprototype> </funcsynopsis> <para> - <function>session_name</function> は、現在のセッション名を返します。 - <parameter>name</parameter> を指定した場合、現在のセッション名は、 - その値に変更されます。 + <function>session_name</function> は、カレントのセッション名を返 + します。<parameter>name</parameter> を指定した場合、カレントのセッ + ション名は、その値に変更されます。 </para> <para> セッション名は、クッキーおよびURLのセッションIDを参照します。 @@ -396,21 +554,18 @@ <example> <title><function>session_name</function>の例</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php -# セッション名をWebsiteIDに設定する +// セッション名をWebsiteIDに設定する $previous_name = session_name("WebsiteID"); -echo "前回のセッション名は、$previous_name です。&lt;p&gt;"; -?&gt; +echo "前回のセッション名は、$previous_name です。<p>"; +?> +]]> </programlisting> </example> - <note> - <para> - この関数は、PHP 4.0 で追加されました。 - </para> - </note> </refsect1> </refentry> @@ -432,15 +587,9 @@ </funcprototype> </funcsynopsis> <para> - <function>session_module_name</function> は、現在のセッションモジュール - の名前を返します。 - <parameter>module</parameter> が指定された場合、そのモジュール - が変わりに使用されます。 - <note> - <para> - この関数は、PHP 4.0 で追加されました。 - </para> - </note> + <function>session_module_name</function>は、現在のセッションモジュー + ルの名前を返します。<parameter>module</parameter> が指定された場 + 合、そのモジュールが変わりに使用されます。 </para> </refsect1> </refentry> @@ -448,7 +597,9 @@ <refentry id="function.session-save-path"> <refnamediv> <refname>session_save_path</refname> - <refpurpose>現在のセッションデータ保存パスを取得または設定する</refpurpose> + <refpurpose> + 現在のセッションデータ保存パスを取得または設定する + </refpurpose> </refnamediv> <refsect1> <title>説明</title> @@ -463,10 +614,9 @@ </funcprototype> </funcsynopsis> <para> - <function>session_save_path</function> は、現在のセッションデータ保存 - パスを返します。 - <parameter>path</parameter> が指定された場合、データを保存する - パスが変更されます。 + <function>session_save_path</function>は、現在のセッションデータ + 保存パスを返します。<parameter>path</parameter> が指定された場合、 + データを保存するパスが変更されます。 <note> <para> いくつかのオペレーションシステムでは、多くの小さなファイルを効率的に @@ -475,11 +625,6 @@ 優れています。 </para> </note> - <note> - <para> - この関数は、PHP 4.0で追加されました。 - </para> - </note> </para> </refsect1> </refentry> @@ -487,7 +632,7 @@ <refentry id="function.session-id"> <refnamediv> <refname>session_id</refname> - <refpurpose>現在のセッションIDを取得または設定する</refpurpose> + <refpurpose>カレントのセッションIDを取得または設定する</refpurpose> </refnamediv> <refsect1> <title>説明</title> @@ -502,13 +647,13 @@ </funcprototype> </funcsynopsis> <para> - <function>session_id</function>は、現在のセッションのセッションIDを - 返します。<parameter>id</parameter>が指定された場合、 - 現在のセッションIDセッションを置換します。 + <function>session_id</function>は、カレントのセッションのセッショ + ンIDを返します。<parameter>id</parameter>が指定された場合、カレン + トのセッションIDを置換します。 </para> <para> - 現在の名前とセッションIDを、URLに追加可能な文字列として取得するために - 定数 <systemitem>SID</systemitem> も使用することが可能です。 + カレントの名前とセッションIDを、URLに追加可能な文字列として取得す + るために定数 <systemitem>SID</systemitem> も使用することが可能です。 </para> </refsect1> </refentry> @@ -538,14 +683,68 @@ 各変数名が処理される毎に、<function>session_register</function> は、その変数名のグローバル変数を現在のセッションに登録します。 </para> + <caution> + <para> + この関数は、<emphasis>global</emphasis>変数を登録します。セッショ + ン変数を関数の内部で登録したい場合、<function>global</function> + を用いてその変数をグローバルとするか、下記のようにsession配列を + 使用して下さい。 + </para> + </caution> + <caution> + <para> + $HTTP_SESSION_VARS/$_SESSIONを使用する場合、 + <function>session_register</function>, + <function>session_is_registered</function>, + <function>session_unregister</function>を使用しないで下さい。 + </para> + </caution> <para> - この関数は、変数のセッションの登録が成功した場合に&true;を + この関数は全ての変数のセッションへの登録に成功した場合に&true;を 返します。 - <note> - <para> - この関数は、PHP 4.0 で追加されました。 - </para> - </note> + </para> + <para> + この関数をコールする前に<function>session_start</function>をコー + ルしていない場合、暗黙のうちに引数を付けずに + <function>session_start</function>がコールされます。 + </para> + <para> + 配列$HTTP_SESSION_VARSまたは$_SESSION (PHP >= 4.1.0)の適当なメン + バに設定をするだけでもセッション変数を作成することが可能です。 + <informalexample> + <programlisting role="php"> +<![CDATA[ +$barney = "A big purple dinosaur."; +session_register("barney"); + +$HTTP_SESSION_VARS["zim"] = "An invader from another planet."; + +# the auto-global $_SESSION array was introduced in PHP 4.1.0 +$_SESSION["spongebob"] = "He's got square pants."; +]]> + </programlisting> + </informalexample> + </para> + <note> + <para> + セッションにリソース変数を登録することは現在できません。例えば、 + データベースへの接続を生成し、接続IDをセッション変数として登録し、 + セッションが回復された時点で、接続が有効であることを期待すること + はできません。リソースを返すPHP関数は、その関数定義に + <literal>resource</literal>型の返り値を有することが示されている。 + リソースを返す関数のリストは、付録 + <link linkend="resource">resource types</link>で見ることができま + す。 + </para> + <para> + $_SESSION (またはPHP 4.0.6以前は$HTTP_SESSION_VARS)が使用されて + いる場合、$_SESSIONに変数を代入して下さい。 + すなわち、$_SESSION['var'] = 'ABC'; + </para> + </note> + <para> + <function>session_is_registered</function>および + <function>session_unregister</function>も参照下さい。 </para> </refsect1> </refentry> @@ -571,12 +770,30 @@ <para> この関数は、セッションからの変数登録の削除が成功した場合に&true;を 返します。 - <note> - <para> - この関数は、PHP 4.0で追加されました。 - </para> - </note> </para> + <note> + <para> + $_SESSION (またはPHP 4.0.6以前の場合は$HTTP_SESSION_VARS)が使用 + されている場合、セッション変数の登録を削除する際に + <function>unset</function>を使用して下さい。 + </para> + </note> + <caution> + <para> + この関数は、<parameter>name</parameter>に対応するグローバル変数 + の登録を削除しません。セッションとしてその変数が保存されるのを妨 + げるだけです。対応するグローバル変数を削除するには、 + <function>unset</function>をコールする必要があります。 + </para> + </caution> + <caution> + <para> + $HTTP_SESSION_VARS/$_SESSIONを使用している場合、 + <function>session_register</function>, + <function>session_is_registered</function>, + <function>session_unregister</function>を使用して下さい。 + </para> + </caution> </refsect1> </refentry> @@ -591,9 +808,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>void - <function>session_unset</function> - </funcdef> + <funcdef>void <function>session_unset</function></funcdef> <void/> </funcprototype> </funcsynopsis> @@ -601,6 +816,14 @@ 関数<function>session_unset</function>は現在登録されている全ての セッション変数を開放します。 </para> + <note> + <para> + $_SESSION(またはPHP 4.0.6以前の場合は$HTTP_SESSION_VARS)が使用さ + れている場合、セッション変数の登録を削除するために + <function>unset</function>を使用して下さい。 + すなわち、unset($_SESSION); + </para> + </note> </refsect1> </refentry> @@ -621,14 +844,24 @@ </funcsynopsis> <para> <function>session_is_registered</function> は、 - <parameter>name</parameter> という名前の変数が現在のセッションに - 登録されている場合に &true; を返します。 - <note> - <para> - この関数は、PHP 4.0で追加されました。 - </para> - </note> + <parameter>name</parameter>という名前の変数がカレントのセッション + に登録されている場合に &true; を返します。 </para> + <note> + <para> + $_SESSION(またはPHP 4.0.6以前の場合は$HTTP_SESSION_VARS)が使用さ + れている場合、ある変数が$_SESSIONに登録されているかを確認するた + めに<function>isset</function>を使用して下さい。 + </para> + </note> + <caution> + <para> + $HTTP_SESSION_VARS/$_SESSIONを使用している場合、 + <function>session_register</function>, + <function>session_is_registered</function>, + <function>session_unregister</function>を使用しないで下さい。 + </para> + </caution> </refsect1> </refentry> @@ -669,6 +902,12 @@ "domain" - クッキーのドメイン </simpara> </listitem> + <listitem> + <simpara> + "secure" - クッキーはセキュアな接続でのみ送信されます。 + (この項目は、PHP 4.0.4で追加されました) + </simpara> + </listitem> </itemizedlist> </para> </refsect1> @@ -727,11 +966,6 @@ <function>session_decode</function> は、 <parameter>data</parameter> のセッションデータをデコードし、 セッションに保存する変数を設定します。 - <note> - <para> - この関数は、PHP 4.0 で追加されました。 - </para> - </note> </para> </refsect1> </refentry> @@ -754,11 +988,6 @@ <para> <function>session_encode</function> は、現在のセッションの内容を エンコードした文字列を返します. - <note> - <para> - この関数は、PHP 4.0 で追加されました。 - </para> - </note> </para> </refsect1> </refentry> @@ -777,13 +1006,12 @@ <funcdef>void <function>session_set_save_handler</function> </funcdef> - <paramdef>string - <parameter>open</parameter></paramdef><paramdef>string - <parameter>close</parameter></paramdef><paramdef>string - <parameter>read</parameter></paramdef><paramdef>string - <parameter>write</parameter></paramdef><paramdef>string - <parameter>destroy</parameter></paramdef><paramdef>string - <parameter>gc</parameter></paramdef> + <paramdef>string <parameter>open</parameter></paramdef> + <paramdef>string <parameter>close</parameter></paramdef> + <paramdef>string <parameter>read</parameter></paramdef> + <paramdef>string <parameter>write</parameter></paramdef> + <paramdef>string <parameter>destroy</parameter></paramdef> + <paramdef>string <parameter>gc</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -816,13 +1044,19 @@ ように容易に拡張可能です。 </para> <para> + saveハンドラが期待通りに動作するようにread関数は常に文字列を返す + 必要があります。データがない場合には、空の文字列を返して下さい。 + 他のハンドラからの返り値は、論理式、すなわち、成功時に&true;、失 + 敗した場合に&false;を返します。 + </para> + <para> <example> <title> <function>session_set_save_handler</function>の例 </title> <programlisting role="php"> -&lt;?php - +<![CDATA[ +<?php function open ($save_path, $session_name) { global $sess_save_path, $sess_session_name; @@ -843,7 +1077,7 @@ $sess_data = fread($fp, filesize($sess_file)); return($sess_data); } else { - return(""); + return(""); // Must return "" here. } } @@ -879,9 +1113,10 @@ session_start(); -// 通常と同様にセッションを使用します。 +// proceed to use sessions normally -?&gt; +?> +]]> </programlisting> </example> </para> @@ -922,7 +1157,20 @@ くなります。 </para> <para> - キャッシュリミッタは、リクエストによる起動時に + <literal>private</literal>モードにおいて、Expireヘッダがクライア + ントに送信されます。これは、Mozillaのようないくつかのブラウザを混 + 乱させます。これを避けるには、 + <literal>private_no_expire</literal>モードを使用して下さい。 + このモードでは、Expireヘッダはクライアントに送信されません。 + </para> + <note> + <para> + <literal>private_no_expire</literal>は、PHP 4.2.0devで追加されま + した。 + </para> + </note> + <para> + キャッシュリミッタは、リクエスト開始時に <literal>session.cache_limiter</literal>に保存されたデフォルト値 にリセットされます。つまり、各リクエスト毎に (<function>session_start</function>がコールされた後に) @@ -932,22 +1180,43 @@ <example> <title><function>session_cache_limiter</function>の例</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php # キャッシュリミッタを'private'に設定する session_cache_limiter('private'); $cache_limiter = session_cache_limiter(); -echo "The cache limiter is now set to $cache_limiter&lt;p&gt;"; -?&gt; +echo "The cache limiter is now set to $cache_limiter<p>"; +?> +]]> </programlisting> </example> - <note> - <para> - この関数は、PHP 4.0.3で追加されました。 - </para> - </note> + </refsect1> + </refentry> + + <refentry id='function.session-cache-expire'> + <refnamediv> + <refname>session_cache_expire</refname> + <refpurpose>カレントのキャッシュの有効期限を返す</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>session_cache_expire</function></funcdef> + <paramdef>int + <parameter><optional>new_cache_expire</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>session_cache_expire</function>は、カレントのキャッシュ + の有効期限を返します。<parameter>new_cache_expire</parameter>が指 + 定された場合、カレントのキャッシュの有効期限は、 + <parameter>new_cache_expire</parameter>で置換されます。 + </para> </refsect1> </refentry> @@ -965,21 +1234,22 @@ </funcprototype> </funcsynopsis> <para> - End the current session and store session data. + カレントのセッションを終了し、セッションデータを保存します。 </para> <para> - Session data is usually stored after your script terminated - without the need to call <function>session_write_close</function>, but as - session data is locked to prevent concurrent writes only one - script may operate on a session at any time. When using framesets - together with sessions you will experience the frames loading one - by one due to this locking. You can reduce the time needed to - load all the frames by ending the session as soon as all changes - to session variables are done. + セッションデータは、<function>session_write_close</function>をコー + ルしなくても、スクリプト終了時に保存されます。しかし、 + セッションデータは、同時書き込みを防ぐためにロックされるため、あ + る時点であるセッションの処理ができるスクリプトは、1つだけです。 + セッションでフレームセットを使用する場合、このロックのためにフレー + ムがひとつずつロードされるような経験をするでしょう。 + セッションへの全ての変更が行われるとすぐにセッションを終了するこ + とにより、全てのフレームのロードに要する時間を減らすことができま + す。 </para> <!-- commented out until final decision on implementation <para> - See also: <function>session_readonly</function>. + <function>session_readonly</function>も参照下さい。 </para> --> </refsect1> Index: phpdoc/ja/functions/shmop.xml diff -u phpdoc/ja/functions/shmop.xml:1.6 phpdoc/ja/functions/shmop.xml:1.7 --- phpdoc/ja/functions/shmop.xml:1.6 Wed Dec 12 15:53:40 2001 +++ phpdoc/ja/functions/shmop.xml Sun Jan 27 07:01:56 2002 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.7 $ --> <reference id="ref.shmop"> - <title>共有メモリ関数</title> + <title>共有メモリ関数(shmop)</title> <titleabbrev>shmop</titleabbrev> <partintro> @@ -13,6 +14,10 @@ </para> <note> <simpara> + このモジュールは実験的なものです。APIその他は、通知なく変更される + 可能性があります。 + </simpara> + <simpara> PHP 4.0.3では、これらの関数の名前には<literal>shmop</literal>では なく<literal>shm</literal>が前に付きます。 <!-- TODO: do the old shm_* funcs still work, i.e. are they still @@ -23,26 +28,27 @@ <example> <title>共有メモリ操作の概要</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php // システムID 0xff3を有する 100 バイトの共有メモリブロックを作成する -$shm_id = shmop_open (0xff3, "c", 0644, 100); +$shm_id = shmop_open(0xff3, "c", 0644, 100); if(!$shm_id) { echo "共有メモリセグメントを作成できませんでした。\n"; } // 共有メモリのブロック長を得る -$shm_size = shmop_size ($shm_id); +$shm_size = shmop_size($shm_id); echo "SHM ブロックサイズ: ".$shm_size. " が作成されました。\n"; // 共有メモリにテスト用の文字列を書き込んでみる -$shm_bytes_written = shmop_write ($shm_id, "my shared memory block", 0); +$shm_bytes_written = shmop_write($shm_id, "my shared memory block", 0); if($shm_bytes_written != strlen("my shared memory block")) { echo "データ全体を書き込めませんでした。\n"; } // その文字列を再び読み込んでみる -$my_string = shmop_read ($shm_id, 0, $shm_size); +$my_string = shmop_read($shm_id, 0, $shm_size); if(!$my_string) { echo "共有メモリブロックから読み込めません。\n"; } @@ -54,7 +60,8 @@ } shmop_close($shm_id); -?&gt; +?> +]]> </programlisting> </example> </para> @@ -119,9 +126,11 @@ <example> <title>共有メモリブロックを新規に作成する</title> <programlisting role="php"> -&lt;?php -$shm_id = shmop_open (0x0fff, "c", 0644, 100); -?&gt; +<![CDATA[ +<?php +$shm_id = shmop_open(0x0fff, "c", 0644, 100); +?> +]]> </programlisting> </example> </para> @@ -159,9 +168,11 @@ <example> <title>共有メモリブロックを読み込む</title> <programlisting role="php"> -&lt;?php -$shm_data = shmop_read ($shm_id, 0, 50); -?&gt; +<![CDATA[ +<?php +$shm_data = shmop_read($shm_id, 0, 50); +?> +]]> </programlisting> </example> </para> @@ -201,9 +212,11 @@ <example> <title>共有メモリブロックに書き込む</title> <programlisting role="php"> -&lt;?php -$shm_bytes_written = shmop_write ($shm_id, $my_string, 0); -?&gt; +<![CDATA[ +<?php +$shm_bytes_written = shmop_write($shm_id, $my_string, 0); +?> +]]> </programlisting> </example> </para> @@ -241,9 +254,11 @@ <example> <title>共有メモリブロックの大きさを得る</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $shm_size = shmop_size($shm_id); -?&gt; +?> +]]> </programlisting> </example> </para> @@ -280,9 +295,11 @@ <example> <title>共有メモリブロックの削除</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php shmop_delete($shm_id); -?&gt; +?> +]]> </programlisting> </example> </para> @@ -318,9 +335,11 @@ <example> <title>共有メモリブロックを閉じる</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php shmop_close($shm_id); -?&gt; +?> +]]> </programlisting> </example> </para> Index: phpdoc/ja/functions/snmp.xml diff -u phpdoc/ja/functions/snmp.xml:1.8 phpdoc/ja/functions/snmp.xml:1.9 --- phpdoc/ja/functions/snmp.xml:1.8 Sun Jan 20 12:54:12 2002 +++ phpdoc/ja/functions/snmp.xml Sun Jan 27 07:01:56 2002 @@ -1,35 +1,37 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.9 $ --> <reference id="ref.snmp"> <title>SNMP関数</title> <titleabbrev>SNMP</titleabbrev> <partintro> <simpara> - UNIX 上で SNMP 関数を使用するためには、<ulink url="&url.ucd-snmp;"> - UCD SNMP</ulink> パッケージをインストールする必要があります。 - Windows 上では、これらの関数は NT 上でのみ利用可能であり、 - Win95/98 では利用できません。</simpara> - + UNIX上でSNMP関数を使用するためには、<ulink url="&url.ucd-snmp;"> + UCD SNMP</ulink>パッケージをインストールする必要があります。 + Windows上では、これらの関数は NT 上でのみ利用可能であり、 + Win95/98 では利用できません。 + </simpara> <simpara> 重要: UCD SNMP パッケージを使用するには、コンパイル前に - NO_ZEROLENGTH_COMMUNITY を 1 に定義する必要があります。 - UCD SNMP のコンフィグレーションを行った後、config.h を編集し、 + NO_ZEROLENGTH_COMMUNITYを1に定義する必要があります。UCD SNMPのコン + フィグレーションを行った後、config.hを編集し、 NO_ZEROLENGTH_COMMUNITY を探してください。 #define の行のコメントを外してください。 - これにより、次のようになるはずです。</simpara> - + これにより、次のようになるはずです。 + </simpara> <para> - <programlisting> + <programlisting role="c"> +<![CDATA[ #define NO_ZEROLENGTH_COMMUNITY 1 +]]> </programlisting> </para> - <simpara> - SNMP コマンドと組み合わせた場合に奇妙なセグメント例外が生じる場合は、 - 上の指示に従っていないと思われます。 - UCD SNMP を再コンパイルしたくない場合は、この不具合に対処するため - PHP を --enable-ucd-snmp-hack スイッチをつけてコンパイルしてください。</simpara> - + SNMP コマンドと組み合わせた場合に奇妙なセグメント例外が生じる場合 + は、上の指示に従っていないと思われます。UCD SNMPを再コンパイルした + くない場合は、この不具合に対処するため、PHPを + --enable-ucd-snmp-hack スイッチをつけてコンパイルしてください。 + </simpara> </partintro> <refentry id="function.snmpget"> @@ -41,7 +43,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>snmpget</function></funcdef> + <funcdef>string <function>snmpget</function></funcdef> <paramdef>string <parameter>hostname</parameter></paramdef> <paramdef>string <parameter>community</parameter></paramdef> <paramdef>string <parameter>object_id</parameter></paramdef> @@ -57,25 +59,25 @@ </paramdef> </funcprototype> </funcsynopsis> - <para> - 成功したらSNMPオブジェクトの値を、失敗すれば&false;を返します。</para> - + 成功したらSNMPオブジェクトの値を、失敗した場合に&false;を返します。 + </para> <para> <function>snmpget</function>は<parameter>object_id</parameter>で 指定されるSNMPオブジェクトの値を読みとるために使用されます。 SNMPエージェントを<parameter>hostname</parameter>で指定し、 リードコミュニティをパラメータ<parameter>community</parameter> - で指定します。</para> - + で指定します。 + </para> <para> <informalexample> <programlisting role="php"> -$syscontact = snmpget("127.0.0.1", "public", "system.SysContact.0") +<![CDATA[ +$syscontact = snmpget("127.0.0.1", "public", "system.SysContact.0"); +]]> </programlisting> </informalexample> </para> - </refsect1> </refentry> @@ -88,7 +90,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>string <function>snmpset</function></funcdef> + <funcdef>bool <function>snmpset</function></funcdef> <paramdef>string <parameter>hostname</parameter></paramdef> <paramdef>string <parameter>community</parameter></paramdef> <paramdef>string <parameter>object_id</parameter></paramdef> @@ -106,19 +108,17 @@ </paramdef> </funcprototype> </funcsynopsis> - <para> - 指定した SNMP オブジェクトの値を設定し、成功時に&true;、エラー時に - &false;を返します。</para> - + 指定した SNMP オブジェクトの値を設定し、成功時に&true;、エラー時 + に&false;を返します。 + </para> <para> <function>snmpset</function> 関数は、 - <parameter>object_id</parameter> で指定された SNMP オブジェクトの - 値を設定するために使用されます。 - SNMP エージェントを <parameter>hostname</parameter> で指定し、 - リードコミュニティを <parameter>community</parameter> パラメータで - 指定します。</para> - + <parameter>object_id</parameter>で指定された SNMP オブジェクトの + 値を設定するために使用されます。SNMP エージェントを + <parameter>hostname</parameter>で指定し、リードコミュニティを + <parameter>community</parameter>パラメータで指定します。 + </para> </refsect1> </refentry> @@ -147,11 +147,10 @@ </paramdef> </funcprototype> </funcsynopsis> - <para> <function>object_id</function>からルートとしてSNMPオブジェクト - の値を配列として返します。エラーの場合に&false;を返します。</para> - + の値を配列として返します。エラーの場合に&false;を返します。 + </para> <para> <function>snmpwalk</function>関数は<parameter>hostname</parameter> で指定したSNMPエージェントから全ての値を読みとるのに使用されます。 @@ -165,10 +164,12 @@ <informalexample> <programlisting role="php"> +<![CDATA[ $a = snmpwalk("127.0.0.1", "public", ""); +]]> </programlisting> - </informalexample></para> - + </informalexample> + </para> <para> 上記の関数コールは、ローカルホスト上で稼働するSNMP エージェントから全てのSNMPオブジェクトを返します。 @@ -176,15 +177,16 @@ <informalexample> <programlisting role="php"> -for ($i=0; $i&lt;count($a); $i++) { +<![CDATA[ +for ($i=0; $i < count($a); $i++) { echo $a[$i]; } +]]> </programlisting> - </informalexample></para> - + </informalexample> + </para> </refsect1> </refentry> - <refentry id="function.snmpwalkoid"> <refnamediv> @@ -212,12 +214,11 @@ </paramdef> </funcprototype> </funcsynopsis> - <para> 各オブジェクトのIDとその値をルートとして指定した <parameter>object_id</parameter> から始まる連想配列として返します。 - エラーの場合は&false;を返します。</para> - + エラーの場合は&false;を返します。 + </para> <para> <function>snmpwalkoid</function> 関数は、hostname で指定した SNMP エージェントから全てのオブジェクトIDとその値を読みこむ @@ -229,20 +230,21 @@ そのツリー以下の全てのオブジェクトが配列として返されます。 <parameter>object_id</parameter> が指定された場合、 <parameter>object_id</parameter> 以下の - 全ての SNMP オブジェクトが返されます。</para> - + 全ての SNMP オブジェクトが返されます。 + </para> <para> <function>snmpwalkoid</function> および <function>snmpwalk</function> があるのは、これまでの経緯 によります。 両方の関数は、下位互換のために提供されています。 - <informalexample> <programlisting role="php"> +<![CDATA[ $a = snmpwalkoid("127.0.0.1", "public", ""); +]]> </programlisting> - </informalexample></para> - + </informalexample> + </para> <para> 上の関数コールは、localhost で実行されている SNMP エージェントから 全ての SNMP オブジェクトを返します。 @@ -250,55 +252,58 @@ <informalexample> <programlisting role="php"> +<![CDATA[ for (reset($a); $i = key($a); next($a)) { - echo "$i: $a[$i]&lt;br>\n"; + echo "$i: $a[$i]<br>\n"; } +]]> </programlisting> - </informalexample></para> - + </informalexample> + </para> </refsect1> </refentry> - <refentry id="function.snmp-get-quick-print"> <refnamediv> <refname>snmp_get_quick_print</refname> - <refpurpose>UCD ライブラリの quick_print の現在の設定値を取得する + <refpurpose> + UCD ライブラリの quick_print の現在の設定値を取得する </refpurpose> </refnamediv> <refsect1> <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>boolean <function>snmp_get_quick_print</function></funcdef> - <paramdef>void <parameter></parameter></paramdef> + <funcdef>bool <function>snmp_get_quick_print</function></funcdef> + <void/> </funcprototype> </funcsynopsis> - <para> UCD ライブラリに保持された quick_print の現在の値を返します。 デフォルトでは、quick_print はオフです。 <informalexample> <programlisting role="php"> +<![CDATA[ $quickprint = snmp_get_quick_print(); +]]> </programlisting> - </informalexample></para> - + </informalexample> + </para> <para> - 上の関数コールは、quick_print がオフの場合に - &false; 、quick_print がオンの場合に - &true; を返します。</para> - + 上の関数コールは、quick_print がオフの場合に&false;、quick_print + がオンの場合に&true;を返します。 + </para> <para> <function>snmp_get_quick_print</function> は、UCB SNMP ライブラリを 使用している場合のみ利用可能です。 - この関数は、Windows SNMP ライブラリを使用している場合は利用できません。</para> - + この関数は、Windows SNMP ライブラリを使用している場合は利用できま + せん。 + </para> <para> 参照: <function>snmp_set_quick_print</function> に quick_print の - 役割に関する詳細な説明があります。</para> - + 役割に関する詳細な説明があります。 + </para> </refsect1> </refentry> @@ -313,10 +318,9 @@ <funcsynopsis> <funcprototype> <funcdef>void <function>snmp_set_quick_print</function></funcdef> - <paramdef>boolean <parameter>quick_print</parameter></paramdef> + <paramdef>bool <parameter>quick_print</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> UCB SNMP ライブラリで quick_print の値を設定します。この値を (1) に設定した場合、SNMP ライブラリは、'簡潔に表示された @@ -326,41 +330,73 @@ (IPアドレスまたは OIDのような)その値の種類を含むより詳細な情報を 出力します。 加えて、quick_print が有効でない場合、ライブラリは3文字以下の全ての - 文字列について16進数値も出力します。</para> - + 文字列について16進数値も出力します。 + </para> <para> quick_print の設定は、返される情報を吟味してから表示する場合に 使用されることが多いです。 <informalexample> <programlisting role="php"> +<![CDATA[ snmp_set_quick_print(0); $a = snmpget("127.0.0.1", "public", ".1.3.6.1.2.1.2.2.1.9.1"); -echo "$a&lt;BR>\n"; +echo "$a<BR>\n"; snmp_set_quick_print(1); $a = snmpget("127.0.0.1", "public", ".1.3.6.1.2.1.2.2.1.9.1"); -echo "$a&lt;BR>\n"; +echo "$a<BR>\n"; +]]> </programlisting> - </informalexample></para> - + </informalexample> + </para> <para> 最初に出力される値は、'Timeticks: (0) 0:00:00.00' のようになります。 - 一方、quick_print を有効にした後は、0:00:00.00' が出力されます。</para> - + 一方、quick_print を有効にした後は、0:00:00.00' が出力されます。 + </para> <para> デフォルトで、UCD SNMP ライブラリは冗長な値を返します。 - quick_print は、値のみを返すために用いられます。</para> - + quick_print は、値のみを返すために用いられます。 + </para> <para> 現在、文字列は引用符で括られて返されますが、この動作は将来の - リリースでは修正される予定です。</para> - + リリースでは修正される予定です。 + </para> <para> <function>snmp_set_quick_print</function> は、UCD SNMP ライブラリ を使用している場合のみ利用可能です。 この関数は、Windows SNMP ライブラリを使用している場合には - 利用できません。</para> - + 利用できません。 + </para> + </refsect1> + </refentry> + + <refentry id='function.snmprealwalk'> + <refnamediv> + <refname>snmprealwalk</refname> + <refpurpose> + 指定したオブジェクトに関するオブジェクトIDを含む全てのオブジェク + トを返す + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>snmprealwalk</function></funcdef> + <paramdef>string <parameter>host</parameter></paramdef> + <paramdef>string <parameter>community</parameter></paramdef> + <paramdef>string <parameter>object_id</parameter></paramdef> + <paramdef>int + <parameter><optional>timeout</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>retries</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> </refsect1> </refentry> Index: phpdoc/ja/functions/sockets.xml diff -u phpdoc/ja/functions/sockets.xml:1.9 phpdoc/ja/functions/sockets.xml:1.10 --- phpdoc/ja/functions/sockets.xml:1.9 Wed Dec 12 15:53:41 2001 +++ phpdoc/ja/functions/sockets.xml Sun Jan 27 07:01:56 2002 @@ -1,15 +1,23 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.10 $ --> <reference id="ref.sockets"> <title>ソケット関数</title> <titleabbrev>ソケット</titleabbrev> + <partintro> &warn.experimental; <simpara> ソケット拡張により、ソケット通信関数への低レベルなインターフェース - が実装され、クライアントとしてだけでなく、ソケットサーバーとして動作する - ことが可能となります。 + が実装され、クライアントとしてだけでなく、ソケットサーバーとして動 + 作することが可能となります。 </simpara> <para> + ここに既述されたソケット関数はPHP拡張モジュールの一部であり、コン + パイル時に<command>configure</command>にオプション<option + role="configure">--enable-sockets</option>を指定することにより使用 + 可能となります。 + </para> + <para> より一般的なクライアントサイドのソケットインターフェースについては、 <function>fsockopen</function> および <function>pfsockopen</function>を参照下さい。 @@ -38,56 +46,57 @@ り、エコーバックされます。接続を閉じるには、'quit'を入力します。 </para> <programlisting role="php"> -&lt;?php -error_reporting(E_ALL); +<![CDATA[ +<?php +error_reporting (E_ALL); -/* 接続待ちの間、スクリプトを待機させるようにする。 */ -set_time_limit(0); +/* Allow the script to hang around waiting for connections. */ +set_time_limit (0); $address = '192.168.1.53'; $port = 10000; -if (($sock = socket(AF_INET, SOCK_STREAM, 0)) &lt; 0) { - echo "socket() failed: reason: " . strerror($sock) . "\n"; +if (($sock = socket_create (AF_INET, SOCK_STREAM, 0)) < 0) { + echo "socket_create() failed: reason: " . socket_strerror ($sock) . "\n"; } -if (($ret = bind($sock, $address, $port)) &lt; 0) { - echo "bind() failed: reason: " . strerror($ret) . "\n"; +if (($ret = socket_bind ($sock, $address, $port)) < 0) { + echo "socket_bind() failed: reason: " . socket_strerror ($ret) . "\n"; } -if (($ret = listen($sock, 5)) &lt; 0) { - echo "listen() failed: reason: " . strerror($ret) . "\n"; +if (($ret = socket_listen ($sock, 5)) < 0) { + echo "socket_listen() failed: reason: " . socket_strerror ($ret) . "\n"; } do { - if (($msgsock = accept_connect($sock)) &lt; 0) { - echo "accept_connect() failed: reason: " . strerror($msgsock) . "\n"; + if (($msgsock = socket_accept($sock)) < 0) { + echo "socket_accept() failed: reason: " . socket_strerror ($msgsock) . "\n"; break; } do { - $buf = ''; - $ret = read($msgsock, $buf, 2048); - if ($ret &lt; 0) { - echo "read() failed: reason: " . strerror($ret) . "\n"; + $buf = socket_read ($msgsock, 2048); + if ($buf == FALSE) { + echo "socket_read() failed: reason: " . socket_strerror ($ret) . "\n"; break 2; } - if ($ret == 0) { + if (!$buf) { break 2; } - $buf = trim($buf); + $buf = trim ($buf); if ($buf == 'quit') { - close($msgsock); + socket_close ($msgsock); break 2; } $talkback = "PHP: You said '$buf'.\n"; - write($msgsock, $talkback, strlen($talkback)); + socket_write ($msgsock, $talkback, strlen ($talkback)); echo "$buf\n"; } while (true); - close($msgsock); + socket_close ($msgsock); } while (true); -close($sock); +socket_close ($sock); ?> +]]> </programlisting> </example> </para> @@ -99,29 +108,30 @@ ジに接続し、HEADリクエストを送信し、応答を出力た後、終了します。 </para> <programlisting role="php"> -&lt;?php -error_reporting(E_ALL); - -echo "&lt;h2>TCP/IP Connection&lt;/h2>\n"; - -/* WWWサービスのポートを得る。 */ -$service_port = getservbyname('www', 'tcp'); - -/* ターゲットホストのIPアドレスを得る。 */ -$address = gethostbyname('www.php.net'); - -/* TCP/IPソケットを作成する。 */ -$socket = socket(AF_INET, SOCK_STREAM, 0); -if ($socket &lt; 0) { - echo "socket() failed: reason: " . strerror($socket) . "\n"; +<![CDATA[ +<?php +error_reporting (E_ALL); + +echo "<h2>TCP/IP Connection</h2>\n"; + +/* Get the port for the WWW service. */ +$service_port = getservbyname ('www', 'tcp'); + +/* Get the IP address for the target host. */ +$address = gethostbyname ('www.php.net'); + +/* Create a TCP/IP socket. */ +$socket = socket_create (AF_INET, SOCK_STREAM, 0); +if ($socket < 0) { + echo "socket_create() failed: reason: " . socket_strerror ($socket) . "\n"; } else { - "socket() successful: " . strerror($socket) . "\n"; + "socket_create() successful: " . socket_strerror ($socket) . "\n"; } echo "Attempting to connect to '$address' on port '$service_port'..."; -$result = connect($socket, $address, $service_port); -if ($result &lt; 0) { - echo "connect() failed.\nReason: ($result) " . strerror($result) . "\n"; +$result = socket_connect ($socket, $address, $service_port); +if ($result < 0) { + echo "socket_connect() failed.\nReason: ($result) " . socket_strerror($result) . "\n"; } else { echo "OK.\n"; } @@ -130,52 +140,55 @@ $out = ''; echo "Sending HTTP HEAD request..."; -write($socket, $in, strlen($in)); +socket_write ($socket, $in, strlen ($in)); echo "OK.\n"; echo "Reading response:\n\n"; -while (read($socket, $out, 2048)) { +while ($out = socket_read ($socket, 2048)) { echo $out; } echo "Closing socket..."; -close($socket); +socket_close ($socket); echo "OK.\n\n"; ?> +]]> </programlisting> </example> </para> </partintro> - <refentry id="function.accept-connect"> + <refentry id="function.socket-accept"> <refnamediv> - <refname>accept_connect</refname> + <refname>socket_accept</refname> <refpurpose>ソケットへの接続を許可する</refpurpose> </refnamediv> <refsect1> <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>accept_connect</function></funcdef> - <paramdef>int <parameter>socket</parameter></paramdef> + <funcdef>int <function>socket_accept</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> - <function>socket</function>を使用してソケット + <function>socket_create</function>を使用してソケット <parameter>socket</parameter>を作成した後、 - <function>bind</function>で名前に関連付け、 - <function>listen</function>で接続をモニタします。この関数は、この - ソケットへの接続を許可します。接続に成功すると、新規のソケット記 - 述子が返されます。この記述子は、通信の際に使用可能です。ソケット - 上に複数の接続がキューで待っている場合、最初の接続が使用されます。 - 接続待ちがない場合、<function>accept_connect</function>は接続が存 - 在するまでブロックされます。<parameter>socket</parameter>が + <function>socket_bind</function>で名前に関連付け、 + <function>socket_listen</function>で接続をモニタします。この関数 + は、このソケットへの接続を許可します。接続に成功すると、新規のソ + ケット記述子が返されます。この記述子は、通信の際に使用可能です。 + ソケット上に複数の接続がキューで待っている場合、最初の接続が使用 + されます。接続待ちがない場合、<function>socket_accept</function> + は接続が存在するまでブロックされます。 + <parameter>socket</parameter>が <function>socket_set_blocking</function>または - <function>set_nonblock</function>により非ブロックモードで作成され - た場合、エラーコードが返されます。 + <function>socket_set_nonblock</function>により非ブロックモードで + 作成された場合、エラーコードが返されます。 </para> <para> - <function>accept_connect</function>により返されたソケット記述子は、 + <function>socket_accept</function>により返されたソケット記述子は、 新規接続を許可するために使用することはできません。この場合でも元 の接続待ちのソケット <parameter>socket</parameter>は、オープンさ れたままであり、再使用可能です。 @@ -183,24 +196,20 @@ <para> 成功時に新規ソケット記述子を返し、失敗時に負のエラーコードを返し ます。このコードは、エラーの内容を文字列で取得するために - <function>strerror</function>に渡すことが可能です。 - </para> - <para> - <function>accept_connect</function>の使用例については、 - <function>bind</function>のドキュメントを参照下さい。 + <function>socket_strerror</function>に渡すことが可能です。 </para> <para> - <function>bind</function>, - <function>connect</function>, - <function>listen</function>, - <function>socket</function>, - <function>socket_get_status</function>, - <function>strerror</function>も参照下さい。 + <function>socket_bind</function>, + <function>socket_connect</function>, + <function>socket_listen</function>, + <function>socket_create</function>, + <function>socket_get_status</function>, + <function>socket_strerror</function>も参照下さい。 </para> </refsect1> </refentry> - <refentry id="function.bind"> + <refentry id="function.socket-bind"> <refnamediv> <refname>bind</refname> <refpurpose>ソケットに名前をバインドする</refpurpose> @@ -209,8 +218,8 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>bind</function></funcdef> - <paramdef>int <parameter>socket</parameter></paramdef> + <funcdef>int <function>socket_bind</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> <paramdef>string <parameter>address</parameter></paramdef> <paramdef>int <parameter> @@ -219,11 +228,13 @@ </paramdef> </funcprototype> </funcsynopsis> + &warn.experimental.func; <para> - <function>bind</function>は、<parameter>address</parameter>で指定 - した名前を<parameter>socket</parameter>で指定したソケットにバイン - ドします。このソケットは、<function>socket</function>で作成した有 - 効なソケット記述子である必要があります。 + <function>socket_bind</function>は、 + <parameter>address</parameter>で指定した名前を + <parameter>socket</parameter>で指定したソケットにバインドします。 + このソケットは、<function>socket</function>で作成した有効なソケッ + ト記述子である必要があります。 </para> <para> ソケットの種類が<constant>AF_INET</constant>の場合、パラメータ @@ -239,124 +250,70 @@ <para> 成功時にゼロを返し、失敗時に負のエラーコードを返します。このコー ドは、エラーの内容を文字列で取得するために - <function>strerror</function>に渡すことが可能です。 - </para> - <para> - <example> - <title><function>bind</function>の例</title> - <programlisting role="php"> -&lt;?php -error_reporting(E_ALL); - -/* スクリプトが接続を待ち続けることを許可する */ -set_time_limit(0); - -if (($sock = socket(AF_INET, SOCK_STREAM, 0)) &lt; 0) { - echo "socket() failed: reason: " . strerror($sock) . "\n"; -} - -if (($ret = bind($sock, '192.168.1.53', 10001)) &lt; 0) { - echo "bind() failed: reason: " . strerror($ret) . "\n"; -} - -if (($ret = listen($sock, 5)) &lt; 0) { - echo "listen() failed: reason: " . strerror($ret) . "\n"; -} - -do { - if (($msgsock = accept_connect($soc<function>socket_get_status</function>, k)) &lt; 0) { - echo "accept_connect() failed: reason: " . strerror($msgsock) . "\n"; - break; - } - do { - $buf = ''; - $ret = read($msgsock, $buf, 2048); - if ($ret &lt; 0) { - echo "read() failed: reason: " . strerror($ret) . "\n"; - break 2; - } - if ($ret == 0) {<function>socket_get_status</function>, - break 2; - } - $buf = trim($buf); - if ($buf == 'quit') { - close($msgsock); - break 2; - } - $talkback = "PHP: You said '$buf'.\n"; - write($msgsock, $talkback, strlen($talkback)); - echo "$buf\n";<function>socket_get_status</function>, - } while (true); - close($msgsock); -} while (true); - -close($sock); -?> - </programlisting> - </example> + <function>socket_strerror</function>に渡すことが可能です。 </para> <para> - <function>accept_connect</function>, - <function>connect</function>, - <function>listen</function>, - <function>socket</function>, - <function>socket_get_status</function>, - <function>strerror</function>も参照下さい。 + <function>socket_connect</function>, + <function>socket_listen</function>, + <function>socket_create</function>, + <function>socket_get_status</function>, + <function>socket_strerror</function>も参照下さい。 </para> </refsect1> </refentry> - <refentry id="function.close"> + <refentry id="function.socket-close"> <refnamediv> - <refname>close</refname> + <refname>socket_close</refname> <refpurpose>ファイル記述子を閉じる</refpurpose> </refnamediv> <refsect1> <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>close</function></funcdef> + <funcdef>bool <function>socket_close</function></funcdef> <paramdef>resource <parameter>socket</parameter></paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - - <function>close</function> は、<parameter>socket</parameter>で - 指定したファイル(またはソケット)記述子を閉じます。 + <function>socket_close</function> は、 + <parameter>socket</parameter>で指定したファイル(またはソケット)記 + 述子を閉じます。 </para> <para> - <function>close</function> で、<function>fopen</function>, + <function>socket_close</function> で、<function>fopen</function>, <function>popen</function>, <function>fsockopen</function>, <function>psockopen</function>で作成されたPHPのファイル記述子を 使用してはならないことに注意して下さい。この関数は、 - <function>socket</function>、または - <function>accept_connect</function>で作成されたソケット用です。 + <function>socket_create</function>、または + <function>socket_accept</function>で作成されたソケット用です。 </para> <para> 成功時に &true; 、エラー発生時(すなわち<parameter>socket</parameter> が無効の場合)に &false; を返します。 </para> <para> - <function>bind</function>, <function>listen</function>, - <function>socket</function>, - <function>socket_get_status</function>, - <function>strerror</function>も参照下さい。 + <function>socket_bind</function>, + <function>socket_listen</function>, + <function>socket_create</function>, + <function>socket_get_status</function>, + <function>socket_strerror</function>も参照下さい。 </para> </refsect1> </refentry> - <refentry id="function.connect"> + <refentry id="function.socket-connect"> <refnamediv> - <refname>connect</refname> + <refname>socket_connect</refname> <refpurpose>ソケット上の接続を初期化する</refpurpose> </refnamediv> <refsect1> <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>connect</function></funcdef> - <paramdef>int <parameter>socket</parameter></paramdef> + <funcdef>int <function>socket_connect</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> <paramdef>string <parameter>address</parameter></paramdef> <paramdef>int <parameter> @@ -368,8 +325,8 @@ &warn.experimental.func; <para> ソケット記述子<parameter>socket</parameter>を用いて接続を初期化し - ます。この記述子は、<function>socket</function>で作成した有効なソ - ケット記述子である必要があります。 + ます。この記述子は、<function>socket_create</function>で作成した + 有効なソケット記述子である必要があります。 </para> <para> ソケットの種類が<constant>AF_INET</constant>の場合、パラメータ @@ -388,34 +345,34 @@ <function>strerror</function>に渡すことが可能です。 </para> <para> - <function>bind</function>, - <function>listen</function>, - <function>socket</function>, - <function>socket_get_status</function>, - <function>strerror</function>も参照下さい。 + <function>socket_bind</function>, + <function>socket_listen</function>, + <function>socket_create</function>, + <function>socket_get_status</function>, + <function>socket_strerror</function>も参照下さい。 </para> </refsect1> </refentry> - <refentry id="function.listen"> + <refentry id="function.socket-listen"> <refnamediv> - <refname>listen</refname> + <refname>socket_listen</refname> <refpurpose>ソケット上で接続待ち(listen)する</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>listen</function></funcdef> - <paramdef>int <parameter>socket</parameter></paramdef> + <funcdef>int <function>socket_listen</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> <paramdef>int <parameter>backlog</parameter></paramdef> </funcprototype> </funcsynopsis> &warn.experimental.func; <para> ソケット<parameter>socket</parameter>が - <function>socket</function>を用いて作成され、 - <function>bind</function>で名前が付けられた後、 + <function>socket_create</function>を用いて作成され、 + <function>socket_bind</function>で名前が付けられた後、 <parameter>socket</parameter>上の接続要求を待つための通信ができる ようになります。最大<parameter>backlog</parameter>個の接続を処理 用のキューで待ち受けることが可能です。 @@ -427,35 +384,31 @@ </para> <para> 成功時にゼロ、失敗時に負のエラーコードを返します。このコードを - <function>strerror</function>に指定することによりエラーの内容を文 - 字列として取得可能です。 - </para> - <para> - <function>listen</function>の使用例については、 - <function>bind</function>の使用例の記述を参照下さい。 + <function>socket_strerror</function>に指定することによりエラーの + 内容を文字列として取得可能です。 </para> <para> - <function>accept_connect</function>, - <function>bind</function>, - <function>connect</function>, - <function>socket</function>, + <function>socket_accept</function>, + <function>socket_bind</function>, + <function>socket_connect</function>, + <function>socket_create</function>, <function>socket_get_status</function>, - <function>strerror</function>も参照下さい。 + <function>socket_strerror</function>も参照下さい。 </para> </refsect1> </refentry> - <refentry id="function.read"> + <refentry id="function.socket-read"> <refnamediv> - <refname>read</refname> + <refname>socket_read</refname> <refpurpose>ソケットから読みこむ</refpurpose> </refnamediv> <refsect1> <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>read</function></funcdef> - <paramdef>int <parameter>socket_des</parameter></paramdef> + <funcdef>string <function>socket_read</function></funcdef> + <paramdef>resource <parameter>socket_des</parameter></paramdef> <paramdef>string <parameter>buffer</parameter></paramdef> <paramdef>int <parameter>length</parameter></paramdef> <paramdef>int @@ -463,15 +416,16 @@ </paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - 関数 <function>read</function> は、関数 - <function>accept_connect</function> により作成されたソケット + 関数 <function>socket_read</function> は、関数 + <function>socket_accept</function> により作成されたソケット <parameter>socket_des</parameter> から <parameter>length</parameter> に設定されたバイト数分、 <parameter>buffer</parameter> に読み込みます。これ以外に読み込み - を終了するために \n、\t、\0 を使用することが可能です。読み込まれ - たバイト数が返されます。 + を終了するために \n、\t、\0 を使用することが可能です。この関数は、 + データを返します。<function>socket_read</function>が失敗した場合 + に&false;を返します。 </para> <para> オプションのパラメータ <parameter>type</parameter> は、名前のある @@ -479,7 +433,8 @@ <itemizedlist> <listitem> <simpara> - PHP_BINARY_READ - バイナリ対応のread() (PHP >= 4.0.7でデフォルト) + PHP_BINARY_READ - システムの<function>socket_read</function>を + 使用する (PHP &gt;= 4.1.0でデフォルト) </simpara> </listitem> <listitem> @@ -491,33 +446,33 @@ </itemizedlist> </para> <para> - <function>accept_connect</function>, - <function>bind</function>, - <function>connect</function>, - <function>listen</function>, - <function>strerror</function>, + <function>socket_accept</function>, + <function>socket_bind</function>, + <function>socket_connect</function>, + <function>socket_listen</function>, + <function>socket_strerror</function>, <function>socket_get_status</function>, - <function>write</function> も参照下さい。 + <function>socket_write</function>も参照下さい。 </para> </refsect1> </refentry> - <refentry id="function.socket"> + <refentry id="function.socket-create"> <refnamediv> - <refname>socket</refname> + <refname>socket_create</refname> <refpurpose>ソケットを作成する(通信時の終端)</refpurpose> </refnamediv> <refsect1> <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>socket</function></funcdef> + <funcdef>resource <function>socket_create</function></funcdef> <paramdef>int <parameter>domain</parameter></paramdef> <paramdef>int <parameter>type</parameter></paramdef> <paramdef>int <parameter>protocol</parameter></paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> 通信用の終端(ソケット)を作成し、そのソケットへの記述子を返します。 </para> @@ -539,61 +494,63 @@ </para> <para> 成功時に有効な記述子を返し、失敗時に負のエラーコードを返します。 - このコードを<function>strerror</function>に渡すことにより、エラー - の内容を文字列で取得することが可能です。 + このコードを<function>socket_strerror</function>に渡すことにより、 + エラーの内容を文字列で取得することが可能です。 </para> <para> - <function>socket</function>の使用法に関するより詳しい情報や種々の - パラメータの意味については、UNIXマニュアルページ<filename>socket - (2)</filename>を参照下さい。 + <function>socket_create</function>の使用法に関するより詳しい情報 + や種々のパラメータの意味については、UNIXマニュアルページ + <filename>socket (2)</filename>を参照下さい。 </para> <para> - <function>accept_connect</function>, - <function>bind</function>, - <function>connect</function>, - <function>listen</function>, - <function>strerror</function>, + <function>socket_accept</function>, + <function>socket_bind</function>, + <function>socket_connect</function>, + <function>socket_listen</function>, + <function>socket_strerror</function>, <function>socket_get_status</function>も参照下さい。 </para> </refsect1> </refentry> - <refentry id="function.strerror"> + <refentry id="function.socket-strerror"> <refnamediv> - <refname>strerror</refname> + <refname>socket_strerror</refname> <refpurpose>ソケットエラーの内容を文字列として返す</refpurpose> </refnamediv> <refsect1> <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>string <function>strerror</function></funcdef> + <funcdef>string <function>socket_strerror</function></funcdef> <paramdef>int <parameter>errno</parameter></paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - <function>strerror</function> は、パラメータ + <function>socket_strerror</function> は、パラメータ <parameter>errno</parameter>にソケット関数の返り値の一つを引数と して指定し、対応する内容を文字列で返します。これは、動作しない原 因を明らかにする際に便利です。例えば、システムのインクルードファ イルを探し'-111'が意味することを探す代わりに、これを - <function>strerror</function>に渡すだけで、原因を知ることができま - す。 + <function>socket_strerror</function>に渡すだけで、原因を知ること + ができます。 </para> <para> <example> <title><function>strerror</function>の例</title> <programlisting role="php"> -&lt;?php -if (($socket = socket(AF_INET, SOCK_STREAM, 0)) &lt; 0) { - echo "socket() failed: reason: " . strerror($socket) . "\n"; +<![CDATA[ +<?php +if (($socket = socket_create (AF_INET, SOCK_STREAM, 0)) < 0) { + echo "socket_create() failed: reason: " . socket_strerror ($socket) . "\n"; } -if (($ret = bind($socket, '127.0.0.1', 80)) &lt; 0) { - echo "bind() failed: reason: " . strerror($ret) . "\n"; +if (($ret = socket_bind ($socket, '127.0.0.1', 80)) < 0) { + echo "socket_bind() failed: reason: " . socket_strerror ($ret) . "\n"; } ?> +]]> </programlisting> <para> 上記の例の出力はおそらく次のようになります。(このスクリプトがルー @@ -605,46 +562,756 @@ </example> </para> <para> - <function>accept_connect</function>, - <function>bind</function>, - <function>connect</function>, - <function>listen</function>, - <function>socket</function>, + <function>socket_accept</function>, + <function>socket_bind</function>, + <function>socket_connect</function>, + <function>socket_listen</function>, + <function>socket_create</function>, <function>socket_get_status</function>も参照下さい。 </para> </refsect1> </refentry> - <refentry id="function.write"> + <refentry id="function.socket-write"> <refnamediv> - <refname>write</refname> + <refname>socket_write</refname> <refpurpose>ソケットに書き込む</refpurpose> </refnamediv> <refsect1> <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>write</function></funcdef> - <paramdef>int <parameter>socket_des</parameter></paramdef> + <funcdef>int <function>socket_write</function></funcdef> + <paramdef>resource <parameter>socket_des</parameter></paramdef> <paramdef>string <parameter>&amp;buffer</parameter></paramdef> <paramdef>int <parameter>length</parameter></paramdef> </funcprototype> </funcsynopsis> - &warn.experimental.func; + &warn.experimental.func; <para> - 関数 <function>write</function> は、 + 関数 <function>socket_write</function> は、 <parameter>length</parameter>で指定されたバイト数分、 <parameter>&amp;buffer</parameter> の内容をソケット <parameter>socket_des</parameter> に書き込みます。 </para> <para> - <function>accept_connect</function>, - <function>bind</function>, - <function>connect</function>, - <function>listen</function>, - <function>read</function>, - <function>strerror</function>, - <function>socket_get_status</function> も参照下さい。 + <function>socket_accept</function>, + <function>socket_bind</function>, + <function>socket_connect</function>, + <function>socket_listen</function>, + <function>socket_read</function>, + <function>socket_strerror</function>, + <function>socket_get_status</function>.も参照下さい。 + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-fd-alloc"> + <refnamediv> + <refname>socket_fd_alloc</refname> + <refpurpose>ファイル記述子集合を確保する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource <function>socket_fd_alloc</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-fd-free"> + <refnamediv> + <refname>socket_fd_free</refname> + <refpurpose>ファイル記述子集合を解放する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_fd_free</function></funcdef> + <paramdef>resource <parameter>set</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-fd-set"> + <refnamediv> + <refname>socket_fd_set</refname> + <refpurpose>集合にファイル記述子を追加する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_fd_set</function></funcdef> + <paramdef>resource <parameter>set</parameter></paramdef> + <paramdef>mixed <parameter>socket</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-fd-clear"> + <refnamediv> + <refname>socket_fd_clear</refname> + <refpurpose>ある集合からファイル記述子をクリアする</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_fd_clear</function></funcdef> + <paramdef>resource <parameter>set</parameter></paramdef> + <paramdef>mixed <parameter>socket</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-fd-isset"> + <refnamediv> + <refname>socket_fd_isset</refname> + <refpurpose> + あるファイル記述子が、ファイル記述子集合の中で設定されているかど + うかを調べる + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_fd_isset</function></funcdef> + <paramdef>resource <parameter>set</parameter></paramdef> + <paramdef>resource <parameter>socket</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-fd-zero"> + <refnamediv> + <refname>socket_fd_zero</refname> + <refpurpose>ファイル記述子集合をクリアする</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_fd_zero</function></funcdef> + <paramdef>resource <parameter>set</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-select"> + <refnamediv> + <refname>socket_select</refname> + <refpurpose> + tv_secとtv_usec で指定した有効時間でselect()システムコールを実行 + する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>socket_select</function></funcdef> + <paramdef>resource <parameter>read_fd</parameter></paramdef> + <paramdef>resource <parameter>write_fd</parameter></paramdef> + <paramdef>resource <parameter>except_fd</parameter></paramdef> + <paramdef>int <parameter>tv_sec</parameter></paramdef> + <paramdef>int + <parameter><optional>tv_usec</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-create-listen"> + <refnamediv> + <refname>socket_create_listen</refname> + <refpurpose> + 接続を受けつけるためにポートにソケットをオープンする + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource <function>socket_create_listen</function></funcdef> + <paramdef>int <parameter>port</parameter></paramdef> + <paramdef>int + <parameter><optional>backlog</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-set-nonblock"> + <refnamediv> + <refname>socket_set_nonblock</refname> + <refpurpose>ファイル記述子fdを非ブロックモードに設定する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_set_nonblock</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-getsockname"> + <refnamediv> + <refname>socket_getsockname</refname> + <refpurpose> + fdを指定、ソケットのローカル側を既述するsa.sin_addrおよび + sa.sin_portの値をaddrおよびportの文字列に保存する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_getsockname</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> + <paramdef>string <parameter>&amp;addr</parameter></paramdef> + <paramdef>int + <parameter><optional>&amp;port</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-getpeername"> + <refnamediv> + <refname>socket_getpeername</refname> + <refpurpose> + fdを指定、ソケットのリモート側を既述するsa.sin_addrおよび + sa.sin_portの値をaddrおよびportの文字列に保存する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_getpeername</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> + <paramdef>string <parameter>&amp;addr</parameter></paramdef> + <paramdef>int + <parameter><optional>&amp;port</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-iovec-alloc"> + <refnamediv> + <refname>socket_iovec_alloc</refname> + <refpurpose> + sendmsg, recvmsg, writev, readvで使用するよう'struct iovec'を構築する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource <function>socket_iovec_alloc</function></funcdef> + <paramdef>int <parameter>num_vectors</parameter></paramdef> + <paramdef>int + <parameter><optional></optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-iovec-fetch"> + <refnamediv> + <refname>socket_iovec_fetch</refname> + <refpurpose> + iovec_id[iovec_position] で指定したiovecに保存されたデータを返す + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>socket_iovec_fetch</function></funcdef> + <paramdef>resource <parameter>iovec</parameter></paramdef> + <paramdef>int <parameter>iovec_position</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-iovec-set"> + <refnamediv> + <refname>socket_iovec_set</refname> + <refpurpose> + iovec_id[iovec_position]に保持されたデータにnew_valを設定する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_iovec_set</function></funcdef> + <paramdef>resource <parameter>iovec</parameter></paramdef> + <paramdef>int <parameter>iovec_position</parameter></paramdef> + <paramdef>string <parameter>new_val</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-iovec-add"> + <refnamediv> + <refname>socket_iovec_add</refname> + <refpurpose>新規ベクトルを収集用配列に追加する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_iovec_add</function></funcdef> + <paramdef>resource <parameter>iovec</parameter></paramdef> + <paramdef>int <parameter>iov_len</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-iovec-delete"> + <refnamediv> + <refname>socket_iovec_delete</refname> + <refpurpose>ベクトルの配列からベクトルを削除する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_iovec_delete</function></funcdef> + <paramdef>resource <parameter>iovec</parameter></paramdef> + <paramdef>int <parameter>iov_pos</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-iovec-free"> + <refnamediv> + <refname>socket_iovec_free</refname> + <refpurpose>iovec_idで指定したiovecを解放する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_iovec_free</function></funcdef> + <paramdef>resource <parameter>iovec</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-readv"> + <refnamediv> + <refname>socket_readv</refname> + <refpurpose> + iovec_idで定義した収集用配列を用いてfdから読み込む + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_readv</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> + <paramdef>resource <parameter>iovec_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-writev"> + <refnamediv> + <refname>socket_writev</refname> + <refpurpose> + iovec_idで定義した収集用配列を用いてファイル記述子fdに書き込む + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_writev</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> + <paramdef>resource <parameter>iovec_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-recv"> + <refnamediv> + <refname>socket_recv</refname> + <refpurpose>接続したソケットからデータを受信する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>socket_recv</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> + <paramdef>int <parameter>len</parameter></paramdef> + <paramdef>int <parameter>flags</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-send"> + <refnamediv> + <refname>socket_send</refname> + <refpurpose>接続したソケットにデータを送信する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>socket_send</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> + <paramdef>string <parameter>buf</parameter></paramdef> + <paramdef>int <parameter>len</parameter></paramdef> + <paramdef>int <parameter>flags</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-recvfrom"> + <refnamediv> + <refname>socket_recvfrom</refname> + <refpurpose> + 接続しているかどうかによらず、ソケットからデータを受信する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>socket_recvfrom</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> + <paramdef>string <parameter>&amp;buf</parameter></paramdef> + <paramdef>int <parameter>len</parameter></paramdef> + <paramdef>int <parameter>flags</parameter></paramdef> + <paramdef>string <parameter>&amp;name</parameter></paramdef> + <paramdef>int + <parameter><optional>&amp;port</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-sendto"> + <refnamediv> + <refname>socket_sendto</refname> + <refpurpose> + 接続しているかどうかによらずソケットにメッセージを送信する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>socket_sendto</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> + <paramdef>string <parameter>buf</parameter></paramdef> + <paramdef>int <parameter>len</parameter></paramdef> + <paramdef>int <parameter>flags</parameter></paramdef> + <paramdef>string <parameter>addr</parameter></paramdef> + <paramdef>int + <parameter><optional>port</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-recvmsg"> + <refnamediv> + <refname>socket_recvmsg</refname> + <refpurpose> + 接続用であるかどうかにかかわらずソケットのメッセージを受信する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_recvmsg</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> + <paramdef>resource <parameter>iovec</parameter></paramdef> + <paramdef>array <parameter>&amp;control</parameter></paramdef> + <paramdef>int <parameter>&amp;controllen</parameter></paramdef> + <paramdef>int <parameter>&amp;flags</parameter></paramdef> + <paramdef>string <parameter>&amp;addr</parameter></paramdef> + <paramdef>int + <parameter><optional>&amp;port</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-sendmsg"> + <refnamediv> + <refname>socket_sendmsg</refname> + <refpurpose> + 接続用であるかどうかにかかわらずソケットにメッセージを送信する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_sendmsg</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> + <paramdef>resource <parameter>iovec</parameter></paramdef> + <paramdef>int <parameter>flags</parameter></paramdef> + <paramdef>string <parameter>addr</parameter></paramdef> + <paramdef>int + <parameter><optional>port</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-getopt"> + <refnamediv> + <refname>socket_getopt</refname> + <refpurpose>ソケットのオプションを取得する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>socket_getopt</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> + <paramdef>int <parameter>level</parameter></paramdef> + <paramdef>int <parameter>optname</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-setopt"> + <refnamediv> + <refname>socket_setopt</refname> + <refpurpose>ソケットのオプションを設定する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_setopt</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> + <paramdef>int <parameter>level</parameter></paramdef> + <paramdef>int <parameter>optname</parameter></paramdef> + <paramdef>int <parameter></parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-create-pair"> + <refnamediv> + <refname>socket_create_pair</refname> + <refpurpose> + 区別できないソケットの組を作成し、fdに保存する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_create_pair</function></funcdef> + <paramdef>int <parameter>domain</parameter></paramdef> + <paramdef>int <parameter>type</parameter></paramdef> + <paramdef>int <parameter>protocol</parameter></paramdef> + <paramdef>array <parameter>&amp;fd</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-shutdown"> + <refnamediv> + <refname>socket_shutdown</refname> + <refpurpose> + 受信、送信、または送受信用のソケットをシャットダウンする + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>socket_shutdown</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> + <paramdef>int + <parameter><optional>how</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id="function.socket-last-error"> + <refnamediv> + <refname>socket_last_error</refname> + <refpurpose>ソケットの直近のエラーを返す/クリアする</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>socket_last_error</function></funcdef> + <paramdef>resource <parameter>socket</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; </para> </refsect1> </refentry> Index: phpdoc/ja/functions/strings.xml diff -u phpdoc/ja/functions/strings.xml:1.48 phpdoc/ja/functions/strings.xml:1.49 --- phpdoc/ja/functions/strings.xml:1.48 Mon Dec 24 10:01:25 2001 +++ phpdoc/ja/functions/strings.xml Sun Jan 27 07:01:56 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.48 $ --> +<!-- $Revision: 1.49 $ --> <reference id="ref.strings"> <title>Strings(文字列関数)</title> <titleabbrev>文字列</titleabbrev> @@ -118,7 +118,7 @@ 文字の前にバックスラッシュを挿入した文字列を返します。クォート されるべき文字とは、シングルクォート(<literal>'</literal>), ダブルクォート(<literal>"</literal>),バックスラッシュ - (<literal>\</literal>) ,NUL (ヌルバイト) です。 + (<literal>\</literal>) ,NUL (&null; バイト) です。 </para> <note> <para> @@ -153,6 +153,10 @@ <parameter>str</parameter> を16進表現に変換したASCII文字列を返し ます。変換は、上位ニブルからバイト毎に行われます。 </para> + <para> + <function>pack</function>および<function>unpack</function>も参照 + 下さい。 + </para> </refsect1> </refentry> @@ -253,14 +257,11 @@ ]]> </programlisting> </example> - この関数は、<function>ereg_replace</function>よりも - 著しく高速です。 - <note> - <para> - この関数は、3.0.6 で追加されました。 - </para> - </note> </para> + <simpara> + <function>explode</function>, <function>split</function>, + <function>wordwrap</function>も参照下さい。 + </simpara> </refsect1> </refentry> @@ -336,7 +337,7 @@ <funcprototype> <funcdef>mixed <function>count_chars</function></funcdef> <paramdef>string <parameter>string</parameter></paramdef> - <paramdef> + <paramdef>int <parameter> <replaceable><optional>mode</optional></replaceable> </parameter> @@ -378,11 +379,6 @@ </listitem> </itemizedlist> </para> - <note> - <para> - この関数は、PHP 4.0で追加されました。 - </para> - </note> </refsect1> </refentry> @@ -1410,11 +1406,6 @@ <para> 定数 CHAR_MAX は上記の方法を使用する場合にも定義されます。 </para> - <note> - <para> - PHP 4.0.5で追加されました。 - </para> - </note> <para> <function>setlocale</function>も参照下さい。 </para> @@ -1703,6 +1694,12 @@ <parameter>arr</parameter> が指定された場合、 変数は、代わりに配列の要素としてこの変数に保存されます。 </para> + <note> + <para> + オプションの2番目のパラメータのサポートはPHP 4.0.3で追加さされま + した。 + </para> + </note> <para> <example> <title><function>parse_str</function>の使用法</title> @@ -1740,6 +1737,10 @@ <simpara> <parameter>arg</parameter>を出力します。&return.success; </simpara> + <para> + <function>print</function>は実際には関数では(言語構造です)ありま + せん。このため、引数を括弧で括る必要はありません。 + </para> <example> <title><function>print</function>の例</title> <programlisting role="php"> @@ -2117,6 +2118,22 @@ &false; を返します。また、カテゴリ名が無効の場合は警告メッセージ が発生します。 </para> + <para> + <example> + <title><function>setlocale</function>の例</title> + <programlisting role="php"> +<![CDATA[ +<?php + /* ロケールをオランダ語に設定 */ + setlocale (LC_ALL, 'nl_NL'); + + /* 出力: vrijdag 22 december 1978 */ + echo strftime ("%A %e %B %Y", mktime (0, 0, 0, 12, 22, 1978)); +?> +]]> + </programlisting> + </example> + </para> </refsect1> </refentry> @@ -2569,11 +2586,6 @@ <function>strcmp</function>とは異なり、バイナリには使用できないこ とに注意して下さい。 </simpara> - <note> - <simpara> - PHP 4.0.5で追加されました。 - </simpara> - </note> <simpara> <function>ereg</function>, <function>strcmp</function>, <function>strcasecmp</function>, <function>substr</function>, @@ -2682,11 +2694,6 @@ バックスラッシュを取り除いた文字列を返します。C言語と同様に <literal>\n</literal>, <literal>\r</literal> ..., 8進表現, 16進表 現を認識します。 - <note> - <simpara> - PHP4b3-dev で追加されました。 - </simpara> - </note> </para> <simpara> <function>addcslashes</function> も参照下さい。 @@ -3153,11 +3160,9 @@ <para> 出力は、"-=-=-=-=-=-=-=-=-=-=" となります。 </para> - <note> - <para> - この関数は、PHP 4.0 で追加されました。 - </para> - </note> + <para> + <function>substr_count</function>も参照下さい。 + </para> </refsect1> </refentry> @@ -3610,7 +3615,7 @@ <title><function>strtr</function>の例</title> <programlisting role="php"> <![CDATA[ -$addr = strtr($addr, " ", "aao"); +$addr = strtr($addr, "&auml;&aring;&ouml;", "aao"); ]]> </programlisting> </example> @@ -3619,7 +3624,7 @@ <function>strtr</function> は、引数を2つ指定してコールすることが可能です。 引数を2つ指定してコールっ_場合、異なった動作となります。 文字列<parameter>from</parameter> では、ソース文字列で変換を行う - 「文字列 -> 文字列」の組を指定する必要があィ~す。 + 「文字列 -> 文字列」の組を指定する必要があります。 <function>strtr</function> は、常にまず最も長くマッチする文字列を探し、 既に置換されている部分文字列については再度置換を行いません。 </para> @@ -3637,7 +3642,8 @@ </para> <note> <simpara> - この機能 (2番目の引数) は、PHP 4.0 で追加されました。 + このオプションのパラメータ<parameter>to</parameter>および + <parameter>from</parameter>は、PHP 4.0.0 で追加されました。 </simpara> </note> <para> @@ -3830,14 +3836,14 @@ echo substr_replace ($var, 'bob', 0, strlen ($var)) . "<br>\n"; /* $var の先頭に 'bob' を挿入します */ -echo substr_replace ($var, 'bob', 0, 0) . "<br>\n"; +echo substr_replace($var, 'bob', 0, 0) . "<br>\n"; /* 次の2つの例は、$var の 'MNRPQR' を 'bob'で置換します */ -echo substr_replace ($var, 'bob', 10, -1) . "<br>\n"; -echo substr_replace ($var, 'bob', -7, -1) . "<br>\n"; +echo substr_replace($var, 'bob', 10, -1) . "<br>\n"; +echo substr_replace($var, 'bob', -7, -1) . "<br>\n"; /* $var から 'MNRPQR' を削除します */ -echo substr_replace ($var, '', 10, -1) . "<br>\n"; +echo substr_replace($var, '', 10, -1) . "<br>\n"; ?> ]]> </programlisting> @@ -3847,11 +3853,6 @@ <function>str_replace</function>および<function>substr</function> も参照下さい。 </para> - <note> - <simpara> - <function>substr_replace</function> は、PHP 4.0 で追加されました。 - </simpara> - </note> </refsect1> </refentry> @@ -3876,7 +3877,8 @@ </funcsynopsis> <note> <simpara> - 2番目のパラメータは、PHP 4.1.0で追加されました。 + オプションの<parameter>charlist</parameter>パラメータは、PHP + 4.1.0で追加されました。 </simpara> </note> <para> Index: phpdoc/ja/functions/swf.xml diff -u phpdoc/ja/functions/swf.xml:1.12 phpdoc/ja/functions/swf.xml:1.13 --- phpdoc/ja/functions/swf.xml:1.12 Wed Dec 12 15:53:47 2001 +++ phpdoc/ja/functions/swf.xml Sun Jan 27 07:01:56 2002 @@ -1,4 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.13 $ --> <reference id="ref.swf"> <title>Shockwave Flash関数</title> <titleabbrev>SWF</titleabbrev> @@ -21,11 +22,10 @@ ShockwaveファイルをPHPから作成することができるようになります。 何ができるかが分かると驚かされることでしょう。次のコードを見て下さい。 <example> - <title> - SWFの例 - </title> + <title>SWFの例</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php swf_openfile ("test.swf", 256, 256, 30, 1, 1, 1); swf_ortho2 (-100, 100, -100, 100); swf_defineline (1, -70, 0, 70, 0, .2); @@ -43,7 +43,7 @@ swf_placeobject (11, 60); swf_popmatrix (); -for ($i = 0; $i &lt; 30; $i++) { +for ($i = 0; $i < 30; $i++) { $p = $i/(30-1); swf_pushmatrix (); swf_scale (1-($p*.9), 1, 1); @@ -58,7 +58,7 @@ swf_showframe (); } -for ($i = 0; $i &lt; 30; $i++) { +for ($i = 0; $i < 30; $i++) { swf_removeobject (50); if (($i%4) == 0) { swf_showframe (); @@ -71,10 +71,9 @@ swf_closefile (); ?> +]]> </programlisting> </example> - このコードはアニメーションを生成し、<ulink - url="&url.swf.test;">url</ulink>で見ることができます。 </para> <note> <para> @@ -161,7 +160,8 @@ た、データベースにこれを保存します。 </title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php // 変数$textはユーザにより投稿されます。 @@ -224,6 +224,7 @@ @mysql_close ($dbh); } ?> +]]> </programlisting> </example> </para> @@ -250,8 +251,8 @@ </funcprototype> </funcsynopsis> <para> - カレントのフレームにパラメータ<parameter>name</parameter>で指定した名前を - 付けます。 + カレントのフレームにパラメータ<parameter>name</parameter>で指定し + た名前を付けます。 </para> </refsect1> </refentry> @@ -340,34 +341,26 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>void - <function>swf_mulcolor</function> - </funcdef> - <paramdef>float - <parameter>r</parameter> - </paramdef> - <paramdef>float - <parameter>g</parameter> - </paramdef> - <paramdef>float - <parameter>b</parameter> - </paramdef> - <paramdef>float - <parameter>a</parameter> - </paramdef> + <funcdef>void <function>swf_mulcolor</function></funcdef> + <paramdef>float <parameter>r</parameter></paramdef> + <paramdef>float <parameter>g</parameter></paramdef> + <paramdef>float <parameter>b</parameter></paramdef> + <paramdef>float <parameter>a</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>swf_mulcolor</function>関数はグローバル乗算色を指定した <parameter>rgba</parameter>色に設定します。この色は、この後 (暗黙の内に)関数<function>swf_placeobject</function>, - <function>swf_modifyobject</function>,<function>swf_addbuttonrecord</function> - で使用されます。オブジェクトがスクリーンに描かれる時に - オブジェクトの色に<parameter>rgba</parameter>値が掛けられます。 + <function>swf_modifyobject</function>, + <function>swf_addbuttonrecord</function>で使用されます。オブジェ + クトがスクリーンに描かれる時にオブジェクトの色に + <parameter>rgba</parameter>値が掛けられます。 </para> <note> <para> - <parameter>rgba</parameter>値は正または負のどちらかとすることができます。 + <parameter>rgba</parameter>値は正または負のどちらかとすることが + できます。 </para> </note> </refsect1> @@ -384,34 +377,26 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>void - <function>swf_addcolor</function> - </funcdef> - <paramdef>float - <parameter>r</parameter> - </paramdef> - <paramdef>float - <parameter>g</parameter> - </paramdef> - <paramdef>float - <parameter>b</parameter> - </paramdef> - <paramdef>float - <parameter>a</parameter> - </paramdef> + <funcdef>void <function>swf_addcolor</function></funcdef> + <paramdef>float <parameter>r</parameter></paramdef> + <paramdef>float <parameter>g</parameter></paramdef> + <paramdef>float <parameter>b</parameter></paramdef> + <paramdef>float <parameter>a</parameter></paramdef> </funcprototype> </funcsynopsis> <para> 関数<function>swf_addcolor</function>は、グローバル加算色を指定した <parameter>rgba</parameter>色に設定します。この色は、この後 (暗黙の内に)関数<function>swf_placeobject</function>, - <function>swf_modifyobject</function>,<function>swf_addbuttonrecord</function> - で使用されます。オブジェクトがスクリーンに描かれる時に - オブジェクトの色に<parameter>rgba</parameter>値が加算されます。 + <function>swf_modifyobject</function>, + <function>swf_addbuttonrecord</function>で使用されます。オブジェ + クトがスクリーンに描かれる時にオブジェクトの色に + <parameter>rgba</parameter>値が加算されます。 </para> <note> <para> - <parameter>rgba</parameter>値は正または負のどちらかとすることができます。 + <parameter>rgba</parameter>値は正または負のどちらかとすることが + できます。 </para> </note> </refsect1> @@ -428,27 +413,22 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>void - <function>swf_placeobject</function> - </funcdef> - <paramdef>int - <parameter>objid</parameter> - </paramdef> - <paramdef>int - <parameter>depth</parameter> - </paramdef> + <funcdef>void <function>swf_placeobject</function></funcdef> + <paramdef>int <parameter>objid</parameter></paramdef> + <paramdef>int <parameter>depth</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <parameter>objid</parameter>で指定したオブジェクトを深さ<parameter>depth</parameter> - でカレントのフレームに配置します。 + <parameter>objid</parameter>で指定したオブジェクトを深さ + <parameter>depth</parameter>でカレントのフレームに配置します。 パラメータ<parameter>objid</parameter>と<parameter>depth</parameter>は 1〜65535の間である必要があります。 </para> <para> - この関数は、(<function>swf_mulcolor</function>で指定した)カレントの乗算色および - (<function>swf_addcolor</function>で指定した)カレントの加算色をオブジェクトに色づけ - する際に使用します。また、オブジェクトの位置を決める際にカレントの行列を使用します。 + この関数は、(<function>swf_mulcolor</function>で指定した)カレント + の乗算色および(<function>swf_addcolor</function>で指定した)カレン + トの加算色をオブジェクトに色づけする際に使用します。また、オブジェ + クトの位置を決める際にカレントの行列を使用します。 </para> <note> <para> @@ -469,27 +449,23 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>void - <function>swf_modifyobject</function> - </funcdef> - <paramdef>int - <parameter>depth</parameter> - </paramdef> - <paramdef>int - <parameter>how</parameter> - </paramdef> + <funcdef>void <function>swf_modifyobject</function></funcdef> + <paramdef>int <parameter>depth</parameter></paramdef> + <paramdef>int <parameter>how</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - オブジェクトの位置または/および色を指定した深さ<parameter>depth</parameter> - に更新します。パラメータ<parameter>how</parameter>は更新するものを定義します。 - <parameter>how</parameter>は定数MOD_MATRIXまたはMOD_COLORまたは組み合わせたもの - (MOD_MATRIX|MOD_COLOR)とすることが可能です。 + オブジェクトの位置または/および色を指定した深さ + <parameter>depth</parameter>に更新します。パラメータ + <parameter>how</parameter>は更新するものを定義します。 + <parameter>how</parameter>は定数MOD_MATRIXまたはMOD_COLORまたは組 + み合わせたもの(MOD_MATRIX|MOD_COLOR)とすることが可能です。 </para> <para> - MOD_COLORは(関数<function>swf_mulcolor</function>で指定した)カレントの乗算色および - (関数<function>swf_addcolor</function>で指定した)カレントの加算色をオブジェクトを塗る際 - に使用します。MOD_MATRIXはオブジェクトを配置する際にカレントの行列を使用します。 + MOD_COLORは(関数<function>swf_mulcolor</function>で指定した)カレ + ントの乗算色および(関数<function>swf_addcolor</function>で指定し + た)カレントの加算色をオブジェクトを塗る際に使用します。MOD_MATRIX + はオブジェクトを配置する際にカレントの行列を使用します。 </para> </refsect1> </refentry> @@ -505,12 +481,8 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>void - <function>swf_removeobject</function> - </funcdef> - <paramdef>int - <parameter>depth</parameter> - </paramdef> + <funcdef>void <function>swf_removeobject</function></funcdef> + <paramdef>int <parameter>depth</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -530,14 +502,13 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>int - <function>swf_nextid</function> - </funcdef> + <funcdef>int <function>swf_nextid</function></funcdef> <void/> </funcprototype> </funcsynopsis> <para> - 関数<function>swf_nextid</function>は次に利用可能なオブジェクトIDを返します。 + 関数<function>swf_nextid</function>は次に利用可能なオブジェクトID + を返します。 </para> </refsect1> </refentry> @@ -561,8 +532,8 @@ </funcsynopsis> <para> 関数<function>swf_startdoaction</function>はカレントのフレームの - アクションリストの記述を開始します。この関数は、カレントのフレームのアクションが - 定義された後にコールする必要があります。 + アクションリストの記述を開始します。この関数は、カレントのフレー + ムのアクションが定義された後にコールする必要があります。 </para> </refsect1> </refentry> @@ -581,14 +552,13 @@ <funcdef>void <function>swf_actiongotoframe</function> </funcdef> - <paramdef>int - <parameter>framenumber</parameter> - </paramdef> + <paramdef>int <parameter>framenumber</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - 関数<function>swf_actionGotoFrame</function>は<parameter>framenumber</parameter> - で指定したフレームまで移動し、実行した後、停止します。 + 関数<function>swf_actionGotoFrame</function>は + <parameter>framenumber</parameter>で指定したフレームまで移動し、 + 実行した後、停止します。 </para> </refsect1> </refentry> @@ -607,17 +577,14 @@ <funcdef>void <function>swf_actiongeturl</function> </funcdef> - <paramdef>string - <parameter>url</parameter> - </paramdef> - <paramdef>string - <parameter>target</parameter> - </paramdef> + <paramdef>string <parameter>url</parameter></paramdef> + <paramdef>string <parameter>target</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - 関数<function>swf_actionGetUrl</function>はターゲット<parameter>target</parameter> - からパラメータ<parameter>url</parameter>で指定したURLを得ます。 + 関数<function>swf_actionGetUrl</function>はターゲット + <parameter>target</parameter>からパラメータ + <parameter>url</parameter>で指定したURLを得ます。 </para> </refsect1> </refentry> @@ -762,9 +729,10 @@ <para> 関数<function>swf_actionWaitForFrame</function>は、パラメータ <parameter>framenumber</parameter>で指定したフレームがロードされている - かどうかを確認し、ロードされていない場合はパラメータ<parameter>skipcount</parameter> - で指定したアクションの数だけスキップします。 - この関数は "Loading..." 型のアニメーションの場合に有用です。 + かどうかを確認し、ロードされていない場合はパラメータ + <parameter>skipcount</parameter>で指定したアクションの数だけスキッ + プします。この関数は "Loading..." 型のアニメーションの場合に有用 + です。 </para> </refsect1> </refentry> @@ -790,8 +758,8 @@ </funcsynopsis> <para> 関数<function>swf_actionSetTarget</function>は全てのアクションの - コンテキストを設定します。この関数を現在実行中の他のflashムービーを制御する - ために使用することが可能です。 + コンテキストを設定します。この関数を現在実行中の他のflashムービー + を制御するために使用することが可能です。 </para> </refsect1> </refentry> @@ -816,8 +784,9 @@ </funcprototype> </funcsynopsis> <para> - 関数<function>swf_actionGotoLabel</function>は<parameter>label</parameter> - で指定したラベルを有するフレームを表示した後、停止します。 + 関数<function>swf_actionGotoLabel</function>は + <parameter>label</parameter>で指定したラベルを有するフレームを表 + 示した後、停止します。 </para> </refsect1> </refentry> @@ -860,31 +829,19 @@ <funcdef>void <function>swf_defineline</function> </funcdef> - <paramdef>int - <parameter>objid</parameter> - </paramdef> - <paramdef>float - <parameter>x1</parameter> - </paramdef> - <paramdef>float - <parameter>y1</parameter> - </paramdef> - <paramdef>float - <parameter>x2</parameter> - </paramdef> - <paramdef>float - <parameter>y2</parameter> - </paramdef> - <paramdef>float - <parameter>width</parameter> - </paramdef> + <paramdef>int <parameter>objid</parameter></paramdef> + <paramdef>float <parameter>x1</parameter></paramdef> + <paramdef>float <parameter>y1</parameter></paramdef> + <paramdef>float <parameter>x2</parameter></paramdef> + <paramdef>float <parameter>y2</parameter></paramdef> + <paramdef>float <parameter>width</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>swf_defineline</function>は、x座標をパラメータ<parameter>x1</parameter>、 - y座標を<parameter>y1</parameter>で指定した座標から線を引きます。 - 線は、x座標を<parameter>x2</parameter>、y座標を<parameter>y2</parameter>で - 指定する点まで引かれます。 + <function>swf_defineline</function>は、x座標をパラメータ + <parameter>x1</parameter>、y座標を<parameter>y1</parameter>で指定 + した座標から線を引きます。線は、x座標を<parameter>x2</parameter>、 + y座標を<parameter>y2</parameter>で指定する点まで引かれます。 幅をパラメータ<parameter>width</parameter>で定義することも可能です。 </para> </refsect1> @@ -904,33 +861,21 @@ <funcdef>void <function>swf_definerect</function> </funcdef> - <paramdef>int - <parameter>objid</parameter> - </paramdef> - <paramdef>float - <parameter>x1</parameter> - </paramdef> - <paramdef>float - <parameter>y1</parameter> - </paramdef> - <paramdef>float - <parameter>x2</parameter> - </paramdef> - <paramdef>float - <parameter>y2</parameter> - </paramdef> - <paramdef>float - <parameter>width</parameter> - </paramdef> + <paramdef>int <parameter>objid</parameter></paramdef> + <paramdef>float <parameter>x1</parameter></paramdef> + <paramdef>float <parameter>y1</parameter></paramdef> + <paramdef>float <parameter>x2</parameter></paramdef> + <paramdef>float <parameter>y2</parameter></paramdef> + <paramdef>float <parameter>width</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>swf_definerect</function>は長方形を定義します。 - この際、左上隅の座標のxは<parameter>x1</parameter>、yは<parameter>y1</parameter> - となります。右下隅の座標のxは<parameter>x2</parameter>、yは<parameter>y2</parameter> - となります。 - 長方形の輪郭の幅をパラメータ<parameter>width</parameter>で指定可能です。 - widthが0.0の場合、長方形は塗りつぶされます。 + この際、左上隅の座標のxは<parameter>x1</parameter>、yは + <parameter>y1</parameter>となります。右下隅の座標のxは + <parameter>x2</parameter>、yは<parameter>y2</parameter>となります。 + 長方形の輪郭の幅をパラメータ<parameter>width</parameter>で指定可 + 能です。widthが0.0の場合、長方形は塗りつぶされます。 </para> </refsect1> </refentry> @@ -964,7 +909,8 @@ </funcprototype> </funcsynopsis> <para> - 関数<function>swf_definepoly</function>はx,y座標の配列で指定したポリゴンを定義します。 + 関数<function>swf_definepoly</function>はx,y座標の配列で指定した + ポリゴンを定義します。 (座標はパラメータ<parameter>coords</parameter>で定義します) パラメータ<parameter>npoints</parameter>は、 <parameter>coords</parameter>で指定した配列に含まれる全ての点の数です。 @@ -1785,13 +1731,15 @@ 関数<function>swf_addbuttonrecord</function>の例 </title> <programlisting role="php"> +<![CDATA[ swf_startButton ($objid, TYPE_MENUBUTTON); -swf_addButtonRecord (BSDown|BSOver, $buttonImageId, 340); -swf_onCondition (MenuEnter); -swf_actionGetUrl ("http://www.designmultimedia.com", "_level1"); -swf_onCondition (MenuExit); -swf_actionGetUrl ("", "_level1"); + swf_addButtonRecord (BSDown|BSOver, $buttonImageId, 340); + swf_onCondition (MenuEnter); + swf_actionGetUrl ("http://www.designmultimedia.com", "_level1"); + swf_onCondition (MenuExit); + swf_actionGetUrl ("", "_level1"); swf_endButton (); +]]> </programlisting> </example> </para> @@ -1955,25 +1903,26 @@ <funcdef>void <function>swf_viewport</function> </funcdef> - <paramdef>double + <paramdef>float <parameter>xmin</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>xmax</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>ymin</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>ymax</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - 関数<function>swf_viewport</function>は描画の範囲として<parameter>xmin</parameter>から - <parameter>xmax</parameter>、<parameter>ymin</parameter>から<parameter>ymax</parameter> - までを選択します。 - この関数がコールされない場合、描画範囲はデフォルトとして画面の大きさになります。 + 関数<function>swf_viewport</function>は描画の範囲として + <parameter>xmin</parameter>から<parameter>xmax</parameter>、 + <parameter>ymin</parameter>から<parameter>ymax</parameter>までを + 選択します。この関数がコールされない場合、描画範囲はデフォルトと + して画面の大きさになります。 </para> </refsect1> </refentry> @@ -1992,29 +1941,29 @@ <funcdef>void <function>swf_ortho</function> </funcdef> - <paramdef>double + <paramdef>float <parameter>xmin</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>xmax</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>ymin</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>ymax</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>zmin</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>zmax</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - 関数<function>swf_ortho</function>は、ユーザ座標の直交マッピングをカレントの - ビューポートに定義します。 + 関数<function>swf_ortho</function>は、ユーザ座標の直交マッピング + をカレントのビューポートに定義します。 </para> </refsect1> </refentry> @@ -2033,25 +1982,26 @@ <funcdef>void <function>swf_ortho2</function> </funcdef> - <paramdef>double + <paramdef>float <parameter>xmin</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>xmax</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>ymin</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>ymax</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - 関数<function>swf_ortho2</function>は、ユーザ座標の2次元直交マッピングを - カレントのビューポートに定義します。この関数は、デフォルトを - Flashムービーの1対1のマッピングとします。遠近法による - 変換を望む場合、関数<function>swf_perspective</function>を使用することが可能です。 + 関数<function>swf_ortho2</function>は、ユーザ座標の2次元直交マッ + ピングをカレントのビューポートに定義します。この関数は、デフォル + トをFlashムービーの1対1のマッピングとします。遠近法による変換を望 + む場合、関数<function>swf_perspective</function>を使用することが + 可能です。 </para> </refsect1> </refentry> @@ -2070,26 +2020,27 @@ <funcdef>void <function>swf_perspective</function> </funcdef> - <paramdef>double + <paramdef>float <parameter>fovy</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>aspect</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>near</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>far</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - 関数<function>swf_perspective</function>は、遠近法による投影変換を定義します。 - パラメータ<parameter>fovy</parameter>は、y方向の視野角です。 - パラメータ<parameter>aspect</parameter>は、描画領域のビューポートのアスペクト比 - を指定します。パラメータ<parameter>near</parameter>は近いクリッピング面であり、 - パラメータ<parameter>far</parameter>は遠いクリッピング面です。 + 関数<function>swf_perspective</function>は、遠近法による投影変換 + を定義します。パラメータ<parameter>fovy</parameter>は、y方向の視 + 野角です。パラメータ<parameter>aspect</parameter>は、描画領域の + ビューポートのアスペクト比を指定します。パラメータ + <parameter>near</parameter>は近いクリッピング面であり、パラメータ + <parameter>far</parameter>は遠いクリッピング面です。 </para> <note> <para> @@ -2115,16 +2066,16 @@ <funcdef>void <function>swf_polarview</function> </funcdef> - <paramdef>double + <paramdef>float <parameter>dist</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>azimuth</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>incidence</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>twist</parameter> </paramdef> </funcprototype> @@ -2158,25 +2109,25 @@ <funcdef>void <function>swf_lookat</function> </funcdef> - <paramdef>double + <paramdef>float <parameter>view_x</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>view_y</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>view_z</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>reference_x</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>reference_y</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>reference_z</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>twist</parameter> </paramdef> </funcprototype> @@ -2255,13 +2206,13 @@ <funcdef>void <function>swf_scale</function> </funcdef> - <paramdef>double + <paramdef>float <parameter>x</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>y</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>z</parameter> </paramdef> </funcprototype> @@ -2289,13 +2240,13 @@ <funcdef>void <function>swf_translate</function> </funcdef> - <paramdef>double + <paramdef>float <parameter>x</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>y</parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter>z</parameter> </paramdef> </funcprototype> @@ -2321,7 +2272,7 @@ <funcdef>void <function>swf_rotate</function> </funcdef> - <paramdef>double + <paramdef>float <parameter>angle</parameter> </paramdef> <paramdef>string Index: phpdoc/ja/functions/sybase.xml diff -u phpdoc/ja/functions/sybase.xml:1.9 phpdoc/ja/functions/sybase.xml:1.10 --- phpdoc/ja/functions/sybase.xml:1.9 Wed Dec 12 15:53:47 2001 +++ phpdoc/ja/functions/sybase.xml Sun Jan 27 07:01:56 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> - +<!-- $Revision: 1.10 $ --> <reference id="ref.sybase"> <title>Sybase 関数</title> <titleabbrev>Sybase</titleabbrev> @@ -95,6 +95,9 @@ <paramdef>string <parameter>servername</parameter></paramdef> <paramdef>string <parameter>username</parameter></paramdef> <paramdef>string <parameter>password</parameter></paramdef> + <paramdef>string + <parameter><optional>charset</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> @@ -197,7 +200,9 @@ <funcprototype> <funcdef>object <function>sybase_fetch_field</function></funcdef> <paramdef>int <parameter>result</parameter></paramdef> - <paramdef>int <parameter>field_offset</parameter></paramdef> + <paramdef>int + <parameter><optional>field_offset</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> @@ -279,8 +284,8 @@ (違いはわずかです。) </para> <para> - <function>sybase_fetch-array</function>および - <function>sybase_fetch-row</function>も参照下さい。 + <function>sybase_fetch_array</function>および + <function>sybase_fetch_row</function>も参照下さい。 </para> </refsect1> </refentry> @@ -299,7 +304,7 @@ </funcprototype> </funcsynopsis> <para> - 取り込まれた行に対する配列、または、もう行がない場合は、flaseを + 取り込まれた行に対する配列、または、もう行がない場合は、&false;を 返します。 </para> <para> @@ -380,7 +385,7 @@ <funcsynopsis> <funcprototype> <funcdef>string <function>sybase_get_last_message</function></funcdef> - <paramdef>void <parameter></parameter></paramdef> + <void/> </funcprototype> </funcsynopsis> <para> @@ -530,7 +535,7 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>sybase_num_rows</function></funcdef> - <paramdef>string <parameter>result</parameter></paramdef> + <paramdef>int <parameter>result</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -557,6 +562,9 @@ <paramdef>string <parameter>servername</parameter></paramdef> <paramdef>string <parameter>username</parameter></paramdef> <paramdef>string <parameter>password</parameter></paramdef> + <paramdef>string + <parameter><optional>charset</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> @@ -627,7 +635,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>sybase_result</function></funcdef> + <funcdef>string <function>sybase_result</function></funcdef> <paramdef>int <parameter>result</parameter></paramdef> <paramdef>int <parameter>row</parameter></paramdef> <paramdef>mixed <parameter>field</parameter></paramdef> @@ -671,7 +679,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>sybase_select_db</function></funcdef> + <funcdef>bool <function>sybase_select_db</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>int <parameter>link_identifier</parameter></paramdef> </funcprototype> Index: phpdoc/ja/functions/uodbc.xml diff -u phpdoc/ja/functions/uodbc.xml:1.15 phpdoc/ja/functions/uodbc.xml:1.16 --- phpdoc/ja/functions/uodbc.xml:1.15 Wed Dec 12 15:53:48 2001 +++ phpdoc/ja/functions/uodbc.xml Sun Jan 27 07:01:56 2002 @@ -1,4 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.16 $ --> <reference id="ref.odbc"> <title>Unified ODBC 関数</title> <titleabbrev>ODBC</titleabbrev> @@ -507,6 +508,69 @@ しかし、このポインタは配列型に変換されるのでどんな型であっても 構いません。この配列には、添字0から始まるカラム番号が代入されます。 </para> + <para> + <example> + <title><function>odbc_fetch_into</function> 4.0.6以前の例</title> + <programlisting role="php"> +<![CDATA[ +$rc = odbc_fetch_into($res_id, $my_array); +]]> + </programlisting> + <para> + または + </para> + <programlisting role="php"> +<![CDATA[ +$rc = odbc_fetch_into($res_id, $row, $my_array); + +$rc = odbc_fetch_into($res_id, 1, $my_array); +]]> + </programlisting> + </example> + </para> + <para> + PHP 4.0.5以降、<parameter>result_array</parameter>はもはや参照渡 + しとする必要はありません。 + </para> + <para> + PHP 4.0.6以降、<parameter>rownumber</parameter>は、定数として渡す + ことはできず、変数と必要があります。 + </para> + <para> + <example> + <title><function>odbc_fetch_into</function> 4.0.6での例</title> + <programlisting role="php"> +<![CDATA[ +$rc = odbc_fetch_into($res_id, $my_array); +]]> + </programlisting> + <para> + または + </para> + <programlisting role="php"> +<![CDATA[ +$row = 1; +$rc = odbc_fetch_into($res_id, $row, $my_array); +]]> + </programlisting> + </example> + </para> + <para> + 将来: PHP 4.1の場合、この関数は以下の形式に移動されます。 + <funcsynopsis> + <funcprototype> + <funcdef>int <function>odbc_fetch_into</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>array <parameter>result_array</parameter></paramdef> + <paramdef>int + <parameter><optional>rownumber</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <parameter>rownumber</parameter>がオプションとなり、 + <parameter>result_array</parameter>はオプションではないことに注意 + して下さい。 + </para> </refsect1> </refentry> @@ -559,6 +623,69 @@ </refsect1> </refentry> + <refentry id='function.odbc-fetch-array'> + <refnamediv> + <refname>odbc_fetch_array</refname> + <refpurpose>連想配列として結果の行を取得する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>odbc_fetch_array</function></funcdef> + <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>int + <parameter><optional>rownumber</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.odbc-next-result'> + <refnamediv> + <refname>odbc_next_result</refname> + <refpurpose>複数の結果が利用可能などうか確認する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>odbc_next_result</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + + <refentry id='function.odbc-fetch-object'> + <refnamediv> + <refname>odbc_fetch_object</refname> + <refpurpose>オブジェクトとして結果の行を取得する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>object <function>odbc_fetch_object</function></funcdef> + <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>int + <parameter><optional>rownumber</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + <refentry id="function.odbc-field-name"> <refnamediv> <refname>odbc_field_name</refname> @@ -910,8 +1037,10 @@ 例えば次のようにします。 <informalexample> <programlisting role="php"> -$item_3 = odbc_result ($Query_ID, 3 ); +<![CDATA[ +$item_3 = odbc_result ($Query_ID, 3); $item_val = odbc_result ($Query_ID, "val"); +]]> </programlisting> </informalexample> </para> @@ -1057,6 +1186,7 @@ <example> <title>ODBC Setoption の例</title> <programlisting role="php"> +<![CDATA[ // 1. SQLSetConnectOption() のオプション 102 は SQL_AUTOCOMMIT です。 // SQL_AUTOCOMMIT の値 1 は SQL_AUTOCOMMIT_ON です。 // この例は odbc_autocommit($conn, true); と同じ結果 @@ -1070,6 +1200,7 @@ $result = odbc_prepare ($conn, $sql); odbc_setoption ($result, 2, 0, 30); odbc_execute ($result); +]]> </programlisting> </example> </para> Index: phpdoc/ja/functions/url.xml diff -u phpdoc/ja/functions/url.xml:1.9 phpdoc/ja/functions/url.xml:1.10 --- phpdoc/ja/functions/url.xml:1.9 Wed Dec 12 15:53:49 2001 +++ phpdoc/ja/functions/url.xml Sun Jan 27 07:01:56 2002 @@ -1,4 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.10 $ --> <reference id="ref.url"> <title>URL 関数</title> <titleabbrev>URLs</titleabbrev> @@ -133,16 +134,20 @@ <example> <title><function>rawurlencode</function> の例1</title> <programlisting role="php"> -echo '&lt;A HREF="ftp://user:', rawurlencode ('foo @+%/'), +<![CDATA[ +echo '<a href="ftp://user:', rawurlencode('foo @+%/'), '@ftp.my.com/x.txt">'; +]]> </programlisting> </example> また、URLの一部としてパス情報を渡す場合は、 <example> <title><function>rawurlencode</function> の例2</title> <programlisting role="php"> -echo '&lt;A HREF="http://x.com/department_list_script/', - rawurlencode ('sales and marketing/Miami'), '">'; +<![CDATA[ +echo '<a href="http://x.com/department_list_script/', + rawurlencode('sales and marketing/Miami'), '">'; +]]> </programlisting> </example> のようにします。 @@ -175,14 +180,16 @@ <example> <title><function>urldecode</function>の使用例</title> <programlisting role="php"> -$a = split ('&amp;', $QUERY_STRING); +<![CDATA[ +$a = explode('&', $QUERY_STRING); $i = 0; -while ($i &lt; count ($a)) { - $b = split ('=', $a [$i]); - echo 'Value for parameter ', htmlspecialchars (urldecode ($b [0])), - ' is ', htmlspecialchars (urldecode ($b [1])), "&lt;BR>"; - $i++; +while ($i < count($a)) { + $b = split('=', $a[$i]); + echo 'Value for parameter ', htmlspecialchars(urldecode($b[0])), + ' is ', htmlspecialchars(urldecode($b[1])), "<br />\n"; + $i++; } +]]> </programlisting> </example> </para> @@ -220,7 +227,9 @@ <example> <title><function>urlencode</function>の使用例</title> <programlisting role="php"> - echo '&lt;A HREF="mycgi?foo=', urlencode ($userinput), '"&gt;'; +<![CDATA[ +echo '<a href="mycgi?foo=', urlencode($userinput), '">'; +]]> </programlisting> </example> </para> @@ -244,14 +253,18 @@ <example> <title><function>urlencode/htmlentities</function>の例</title> <programlisting role="php"> -echo '&lt;A HREF="mycgi?foo=', htmlentities (urlencode ($userinput) ), '"&gt;'; +<![CDATA[ +echo '<a href="mycgi?foo=', htmlentities(urlencode($userinput)), '">'; +]]> </programlisting> </example> </para> </note> <para> - <function>urldecode</function>、<function>rawurlencode</function>、 - <function>rawurldecode</function>も参考にしてください。 + <function>urldecode</function>, + <function>htmlentities</function>, + <function>rawurldecode</function>, + <function>rawurlencode</function>も参考にしてください。 </para> </refsect1> </refentry> Index: phpdoc/ja/functions/var.xml diff -u phpdoc/ja/functions/var.xml:1.33 phpdoc/ja/functions/var.xml:1.34 --- phpdoc/ja/functions/var.xml:1.33 Wed Dec 12 15:53:49 2001 +++ phpdoc/ja/functions/var.xml Sun Jan 27 07:01:56 2002 @@ -1,44 +1,36 @@ <?xml version="1.0" encoding="utf-8"?> -<reference id="ref.variables"> - <title>変数用の関数</title> +<!-- $Revision: 1.34 $ --> + <reference id="ref.variables"> + <title>変数用の関数(variable)</title> <titleabbrev>変数</titleabbrev> + <partintro> + <para> + 変数の動作に関する情報については、このマニュアルの + <link linkend="langref">言語リファレンス</link>セクションにある + <link linkend="language.variables">変数</link>のエントリを参照下さ + い。 + </para> + </partintro> + <refentry id="function.doubleval"> <refnamediv> <refname>doubleval</refname> - <refpurpose>変数の値をdoubleとして取得する</refpurpose> + <refpurpose><function>floatval</function>のエイリアス</refpurpose> </refnamediv> <refsect1> <title>説明</title> - <funcsynopsis> - <funcprototype> - <funcdef>double <function>doubleval</function></funcdef> - <paramdef>mixed <parameter>var</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <parameter>var</parameter>の値をdouble(浮動小数点数) - として返します。 - </simpara> <para> - <parameter>var</parameter> はどんなスカラー型でもかまいません。 - <function>doubleval</function> には配列やオブジェクトは指定 - できません。 - <informalexample> - <programlisting role="php"> -$var = '122.34343The'; -$double_value_of_var = doubleval ($var); -print $double_value_of_var; // 122.34343 を出力します - </programlisting> - </informalexample> + この関数は、<function>floatval</function>のエイリアスです。 </para> - <simpara> - <function>intval</function>, - <function>strval</function>, - <function>settype</function>, - <link linkend="language.types.type-juggling">型のジャグリング</link> - も参照下さい。 - </simpara> + <note> + <para> + このエイリアスは、関数の名称変更に伴い削除されています。以前のバー + ジョンのPHPでは、<function>floatval</function>がまだ利用できない + ため、<function>floatval</function>のこのエイリアスを使用する必 + 要があります。 + </para> + </note> </refsect1> </refentry> @@ -51,33 +43,90 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>empty</function></funcdef> + <funcdef>boolean <function>empty</function></funcdef> <paramdef>mixed <parameter>var</parameter></paramdef> </funcprototype> </funcsynopsis> + <note> + <para> + <function>empty</function>は、言語構造です。 + </para> + </note> <para> - <parameter>var</parameter> が設定され、かつ空でないかゼロでない値を - 有する場合に &false; を返し、そうでなければ &true; を返します。 + この関数は、変数が設定されていない場合に警告は生成されないこと以 + 外は、<literal>(boolean)<parameter>var</parameter></literal>の逆 + です。より詳細な情報については、<link + linkend="language.types.boolean.casting">論理値への変換</link>を + 参照下さい。 + </para> + + <!-- Returns &false; if <parameter>var</parameter> is set and has a + non-empty or non-zero value; &true; otherwise. --> + <informalexample> - <programlisting role="php"> + <programlisting role="php"> +<![CDATA[ $var = 0; -if ( empty($var) ) { // trueと評価された場合 - print '$var is either 0 or not at all set'; + +if (empty($var)) { // evaluates true + echo '$var is either 0 or not set at all'; } -if ( !isset($var) ) { // falseと評価された場合 - print 'The $var is not set at all'; + +if (!isset($var)) { // evaluates false + echo '$var is not set at all'; } - </programlisting> +]]> + </programlisting> </informalexample> - </para> <simpara> - 変数でないものに使用しても意味がないことに注意して下さい。 - 例えば、<command>empty( addslashes( $name ) )</command>は - 変数でないものに対して - &false;値を持つ変数であるかどうかを調べているため意味がありません。 + 変数でないものに使用しても意味がないことに注意して下さい。すなわ + ち、<command>empty( addslashes( $name ) )</command>は変数でないも + のに対して&false;値を持つ変数であるかどうかを調べているため意味が + ありません。 + <!-- will even result in parse error (at least in PHP 4) --> + </simpara> + <simpara> + <function>isset</function> および <function>unset</function> も参 + 照下さい。 + </simpara> + </refsect1> + </refentry> + + <refentry id="function.floatval"> + <refnamediv> + <refname>floatval</refname> + <refpurpose>変数のfloat値を取得する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>floatval</function></funcdef> + <paramdef>mixed <parameter>var</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <parameter>var</parameter>の<type>float</type>値を返します。 </simpara> + <para> + <parameter>var</parameter>はあらゆるスカラー型とすることが可能で + す。配列またはオブジェクトに<function>floatval</function>を使用す + ることはできません。 + <informalexample> + <programlisting role="php"> +<![CDATA[ +$var = '122.34343The'; +$float_value_of_var = floatval ($var); +print $float_value_of_var; // prints 122.34343 +]]> + </programlisting> + </informalexample> + </para> <simpara> - <function>isset</function> および <function>unset</function> も参照下さい。 + <function>intval</function>, + <function>strval</function>, <function>settype</function>, + <link linkend="language.types.type-juggling">型の相互変換</link> + も参照下さい。 </simpara> </refsect1> </refentry> @@ -98,29 +147,46 @@ <para> PHP 変数 <parameter>var</parameter> の型を返します。 </para> + <warning> + <simpara> + 返された文字列は将来的なバージョンで変更される可能性があるので、 + 特定の型を調べるために<function>gettype</function>を使用しないで + 下さい。更に、この関数は文字列比較を行うため、処理が遅いです。 + <!-- where's my dictionary? -->. + </simpara> + <simpara> + 替わりに<literal>is_*</literal>関数を使用して下さい。 + </simpara> + </warning> <para> 返された文字列は、以下のいずれかの値を持ちます。 <itemizedlist> <listitem> - <simpara>"boolean"</simpara> + <simpara>"<type>boolean</type>" (PHP 4以降)</simpara> + </listitem> + <listitem> + <simpara>"<type>integer</type>"</simpara> </listitem> <listitem> - <simpara>"integer"</simpara> + <simpara> + "<type>double</type>" (歴史的な理由により<type>float</type>の + 場合に"double"が返され、"float"とはなりません) + </simpara> </listitem> <listitem> - <simpara>"double"</simpara> + <simpara>"<type>string</type>"</simpara> </listitem> <listitem> - <simpara>"string"</simpara> + <simpara>"<type>array</type>"</simpara> </listitem> <listitem> - <simpara>"array"</simpara> + <simpara>"<type>object</type>"</simpara> </listitem> <listitem> - <simpara>"object"</simpara> + <simpara>"<type>resource</type>" (PHP 4以降)</simpara> </listitem> <listitem> - <simpara>"resource"</simpara> + <simpara>"<type>null</type>" (PHP 4以降)</simpara> </listitem> <listitem> <simpara>"user function" (PHP 3のみ。古い形式)</simpara> @@ -131,12 +197,22 @@ </itemizedlist> </para> <para> - PHP 4 でユーザ関数に関する <function>gettype</function> の以前の - 使用法を置き換えるには <function>function_exists</function> およ - び <function>method_exists</function> を使用する必要があります。 + PHP 4の場合、ある関数に関する<function>gettype</function>の以前の + 使用法を置き換えるには<function>function_exists</function>および + <function>method_exists</function>を使用する必要があります。 </para> <para> - <function>settype</function> も参照下さい。 + <function>settype</function>, + <function>is_array</function>, + <function>is_bool</function>, + <function>is_float</function>, + <function>is_integer</function>, + <function>is_null</function>, + <function>is_numeric</function>, + <function>is_object</function>, + <function>is_resource</function>, + <function>is_scalar</function>, + <function>is_string</function>も参照下さい。 </para> </refsect1> </refentry> @@ -153,7 +229,7 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>get_defined_vars</function></funcdef> - <paramdef>void <parameter></parameter></paramdef> + <void/> </funcprototype> </funcsynopsis> <para> @@ -161,6 +237,7 @@ の定義済の変数のリストを有する多次元の配列を返します。 <informalexample> <programlisting role="php"> +<![CDATA[ $b = array(1,1,2,3,5,8); $arr = get_defined_vars(); @@ -180,6 +257,7 @@ // 変数の配列で利用可能なキーを全て出力 print_r(array_keys(get_defined_vars())); +]]> </programlisting> </informalexample> </para> @@ -199,14 +277,15 @@ <funcsynopsis> <funcprototype> <funcdef>string <function>get_resource_type</function></funcdef> - <paramdef>resource <parameter>$handle</parameter></paramdef> + <paramdef>resource <parameter>handle</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - この関数は、指定したリソースの型を表す文字列を返します。パラメー - タが、有効なリソースでない場合はエラーとなります。 + この関数は、指定した<type>resource</type>の型を表す文字列を返しま + す。パラメータが有効なリソースでない場合はエラーとなります。 <informalexample> <programlisting role="php"> +<![CDATA[ $c = mysql_connect(); echo get_resource_type($c)."\n"; // mysql link を出力 @@ -218,12 +297,72 @@ $doc = new_xmldoc("1.0"); echo get_resource_type($doc->doc)."\n"; // domxml document を出力 +]]> </programlisting> </informalexample> </para> </refsect1> </refentry> + <refentry id="function.import-request-variables"> + <refnamediv> + <refname>import_request_variables</refname> + <refpurpose> + GET/POST/Cookie変数をグローバルスコープにインポートする + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>import_request_variables</function></funcdef> + <paramdef>string <parameter>types</parameter></paramdef> + <paramdef>string + <parameter><optional>prefix</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + GET/POST/Cookie変数をグローバルスコープにインポートします。この関 + 数は、<link + linkend="ini.register-globals">register_globals</link>を無効とし + ているが、いくつかの変数をグローバルスコープで参照したいといった + 場合に有用です。 + </simpara> + <simpara> + <parameter>types</parameter>パラメータを使用すると、インポートす + るリクエスト変数の種類を指定可能です。文字'G', 'P', 'C'をそれぞれ + GET, POST, Cookieに使用できます。これらの文字は、大文字小文字を区 + 別しないため、'g', 'p', 'c'の組み合せも使用することが可能です。 + POSTには、アップロードされたファイルの情報も含まれます。 + 文字の順番には注意して下さい。"gp"とすると、POST変数は同名のGET変 + 数を上書きします。GPC以外の文字は無視されます。 + </simpara> + <note> + <para> + 引数<parameter>prefix</parameter>はオプションですが、 + 接頭辞を指定しないか空の文字列を接頭辞として指定すると、通知レベ + ルエラーが発生します。これは、セキュリティ上の問題を生じるリスク + です。通知レベルエラーは、デフォルトのエラー出力レベルでは表示さ + れません。 + </para> + </note> + <informalexample> + <programlisting role="php"> +<![CDATA[ +// This will import GET and POST vars +// with an "rvar_" prefix +import_request_variables("gP", "rvar_"); +]]> + </programlisting> + </informalexample> + <simpara> + <link linkend="ini.register-globals">register_globals</link>, + <link linkend="ini.track-vars">track_vars</link>も参照下さい。 + </simpara> + </refsect1> + </refentry> + <refentry id="function.intval"> <refnamediv> <refname>intval</refname> @@ -244,15 +383,23 @@ </funcsynopsis> <simpara> 指定された値 base を基数(デフォルトは 10)とする、 - <parameter>var</parameter> の整数としての値を返します。 + <parameter>var</parameter>の<type>integer</type>としての値を返し + ます。 </simpara> <simpara> - <parameter>var</parameter> はどんなスカラー型でもかまいません。 - <function>intval</function> には配列やオブジェクトは指定 - できません。 + <parameter>var</parameter>は、どんなスカラー型でもかまいません。 + <function>intval</function> には<type>array</type>や + <type>object</type>は指定できません。 </simpara> + <note> + <para> + <function>intval</function>の引数<parameter>base</parameter>は、 + <parameter>var</parameter>引数が文字列でない限り、意味がありませ + ん。 + </para> + </note> <simpara> - <function>doubleval</function>, + <function>floatval</function>, <function>strval</function>, <function>settype</function>, <link linkend="language.types.type-juggling"> @@ -279,13 +426,10 @@ そうでなければ&false;を返します。 </para> <para> - <function>is_double</function>, <function>is_float</function>, <function>is_int</function>, <function>is_integer</function>, - <function>is_real</function>, <function>is_string</function>, - <function>is_long</function>, <function>is_object</function> も参照下さい。 </para> </refsect1> @@ -307,14 +451,15 @@ </funcprototype> </funcsynopsis> <para> - パラメータ<parameter>var</parameter>がbooleanである場合に&true;を返 - します。 + パラメータ<parameter>var</parameter>が<type>boolean</type>である + 場合に&true;を返します。 </para> <para> - <function>is_array</function>,<function>is_double</function>, - <function>is_float</function>,<function>is_int</function>, - <function>is_integer</function>,<function>is_real</function>, - <function>is_string</function>,<function>is_long</function>, + <function>is_array</function>, + <function>is_float</function>, + <function>is_int</function>, + <function>is_integer</function>, + <function>is_string</function>, <function>is_object</function>も参照下さい。 </para> </refsect1> @@ -323,30 +468,12 @@ <refentry id="function.is-double"> <refnamediv> <refname>is_double</refname> - <refpurpose>変数が double かどうかを検査する</refpurpose> + <refpurpose><function>is_float</function>のエイリアス</refpurpose> </refnamediv> <refsect1> <title>説明</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_double</function></funcdef> - <paramdef>mixed <parameter>var</parameter></paramdef> - </funcprototype> - </funcsynopsis> <para> - <parameter>var</parameter> が double であれば&true;、 - そうでなければ&false;を返します。 - </para> - <para> - <function>is_array</function>, - <function>is_bool</function>, - <function>is_float</function>, - <function>is_int</function>, - <function>is_integer</function>, - <function>is_real</function>, - <function>is_string</function>, - <function>is_long</function>, - <function>is_object</function> も参照下さい。 + この関数は、<function>is_float</function>のエイリアスです。 </para> </refsect1> </refentry> @@ -354,7 +481,7 @@ <refentry id="function.is-float"> <refnamediv> <refname>is_float</refname> - <refpurpose> 変数がfloatかどうかを検査する</refpurpose> + <refpurpose>変数がfloatかどうか調べる</refpurpose> </refnamediv> <refsect1> <title>説明</title> @@ -365,18 +492,24 @@ </funcprototype> </funcsynopsis> <simpara> - この関数は<function>is_double</function>の別名です。 + <parameter>var</parameter>が<type>float</type>の場合に&true;、そ + うでない場合に&false;を返します。 </simpara> + <tip> + <para> + 変数が数値、または数値文字列(フォーム入力の場合は常に文字列です) + かどうかを調べるには、<function>is_numeric</function>を使用する + 必要があります。 + </para> + </tip> <simpara> - <function>is_double</function>, <function>is_bool</function>, - <function>is_real</function>, <function>is_int</function>, <function>is_integer</function>, + <function>is_numeric</function>, <function>is_string</function>, - <function>is_object</function>, <function>is_array</function>, - <function>is_long</function> も参照下さい。 + <function>is_object</function>も参照下さい。 </simpara> </refsect1> </refentry> @@ -395,18 +528,24 @@ </funcprototype> </funcsynopsis> <simpara> - この関数は <function>is_long</function> の別名です。 + <parameter>var</parameter>が<type>integer</type>の場合に&true;、 + そうでない場合に&false;を返します。 </simpara> + <tip> + <para> + 変数が数値、または数値文字列(フォーム入力の場合は常に文字列です) + かどうかを調べるには、<function>is_numeric</function>を使用する + 必要があります。 + </para> + </tip> <simpara> <function>is_bool</function>, - <function>is_double</function>, <function>is_float</function>, <function>is_integer</function>, + <function>is_numeric</function>, <function>is_string</function>, - <function>is_real</function>, - <function>is_object</function>, <function>is_array</function>, - <function>is_long</function> も参照下さい。 + <function>is_object</function>も参照下さい。 </simpara> </refsect1> </refentry> @@ -414,60 +553,25 @@ <refentry id="function.is-integer"> <refnamediv> <refname>is_integer</refname> - <refpurpose> 変数が整数かどうかを検査する</refpurpose> + <refpurpose><function>is_int</function>のエイリアス</refpurpose> </refnamediv> <refsect1> <title>説明</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_integer</function></funcdef> - <paramdef>mixed <parameter>var</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - この関数は<function>is_long</function>の別名です。 - </simpara> - <simpara> - <function>is_bool</function>, - <function>is_double</function>, - <function>is_float</function>, - <function>is_int</function>, - <function>is_string</function>, - <function>is_real</function>, - <function>is_object</function>, - <function>is_array</function>, - <function>is_long</function> も参照下さい。 - </simpara> + <para> + この関数は、<function>is_int</function>の別名です。 + </para> </refsect1> </refentry> <refentry id="function.is-long"> <refnamediv> <refname>is_long</refname> - <refpurpose> 変数が整数かどうかを検査する</refpurpose> + <refpurpose><function>is_int</function>のエイリアス</refpurpose> </refnamediv> <refsect1> <title>説明</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_long</function></funcdef> - <paramdef>mixed <parameter>var</parameter></paramdef> - </funcprototype> - </funcsynopsis> <para> - <parameter>var</parameter>が整数(long)であれば&true;を、 - そうでなければ&false;を返します。 - </para> - <para> - <function>is_bool</function>, - <function>is_double</function>, - <function>is_float</function>, - <function>is_int</function>, - <function>is_real</function>, - <function>is_string</function>, - <function>is_object</function>, - <function>is_array</function>, - <function>is_integer</function> も参照下さい。 + この関数は、<function>is_int</function>の別名です。 </para> </refsect1> </refentry> @@ -476,7 +580,7 @@ <refnamediv> <refname>is_null</refname> <refpurpose> - 変数がヌルかどうか調べる + 変数が &null;かどうか調べる </refpurpose> </refnamediv> <refsect1> @@ -488,20 +592,17 @@ </funcprototype> </funcsynopsis> <para> - <parameter>var</parameter> がヌルの場合に&true;、その他に&false;を返 - します。 + <parameter>var</parameter> が<type>null</type>の場合に&true;、そ + の他に&false;を返します。 </para> <para> <function>is_bool</function>, - <function>is_double</function>, <function>is_numeric</function>, <function>is_float</function>, <function>is_int</function>, - <function>is_real</function>, <function>is_string</function>, <function>is_object</function>, - <function>is_array</function>, - <function>is_integer</function>も参照下さい。 + <function>is_array</function>も参照下さい。 </para> </refsect1> </refentry> @@ -525,10 +626,8 @@ </para> <para> <function>is_bool</function>, - <function>is_double</function>, <function>is_float</function>, <function>is_int</function>, - <function>is_real</function>, <function>is_string</function>, <function>is_object</function>, <function>is_array</function>, @@ -556,12 +655,9 @@ </para> <para> <function>is_bool</function>, - <function>is_long</function>, <function>is_int</function>, <function>is_integer</function>, <function>is_float</function>, - <function>is_double</function>, - <function>is_real</function>, <function>is_string</function>, <function>is_array</function> も参照下さい。 </para> @@ -571,30 +667,13 @@ <refentry id="function.is-real"> <refnamediv> <refname>is_real</refname> - <refpurpose>変数が実数(real)かどうかを検査する</refpurpose> + <refpurpose><function>is_float</function>のエイリアス</refpurpose> </refnamediv> <refsect1> <title>説明</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_real</function></funcdef> - <paramdef>mixed <parameter>var</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - この関数は <function>is_double</function> の別名です。 - </simpara> - <simpara> - <function>is_bool</function>, - <function>is_long</function>, - <function>is_int</function>, - <function>is_integer</function>, - <function>is_float</function>, - <function>is_double</function>, - <function>is_object</function>, - <function>is_string</function>, - <function>is_array</function> も参照下さい。 - </simpara> + <para> + この関数は、<function>is_float</function> の別名です。 + </para> </refsect1> </refentry> @@ -619,10 +698,7 @@ 返し、その他の場合に&false;を返します。 </para> <para> - リソースとはファイルやデータベース結果ハンドル等を意味し、 - PHP内部関数により確保や開放が行われます。これらのリソースに関して - 使用終了後でかつユーザのコードにより開放が行われていない場合に、 - 何らかのクリーンアップが必要となる可能性があります。 + 詳細については、<type>resource</type>型のドキュメントを参照下さい。 </para> </refsect1> </refentry> @@ -641,19 +717,16 @@ <funcdef>bool <function>is_scalar</function> </funcdef> - <paramdef>mixed - <parameter>var</parameter> - </paramdef> + <paramdef>mixed <parameter>var</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>is_scalar</function> returns &true; if the variable - given by the <parameter>var</parameter> parameter is a scalar, - otherwise it returns &false;. + <function>is_scalar</function>は、パラメータ + <parameter>var</parameter>で指定した変数がスカラーの場合に&true;、 + その他の場合に&false;を返します。 </para> <para> - Scalar variables are those containing an integer, float, string - or boolean. For example: + スカラー変数には、整数、float、文字列、論理値が含まれます。例えば、 <informalexample> <programlisting role="php"> function show_var($var) { @@ -684,8 +757,10 @@ </para> <note> <para> - この関数は、PHP 4.0.4pl1 のリリースコード後にCVSコードに追加され - ました。4.0.4pl1 + リソース型は現在整数に基づく抽象型であるため、 + <function>is_scalar</function>は<type>resource</type>型の値をス + カラー値と判定しません。この実装の詳細は変更される可能性があるた + め、前堤にするべきではありません。 </para> </note> <para> @@ -717,7 +792,7 @@ </funcprototype> </funcsynopsis> <para> - <parameter>var</parameter>が文字列であ?ptrue、 + <parameter>var</parameter>が<type>string</type>である場合に&true;、 そうでなければ&false;を返します。 </para> <para> @@ -726,8 +801,6 @@ <function>is_int</function>, <function>is_integer</function>, <function>is_float</function>, - <function>is_double</function>, - <function>is_real</function>, <function>is_object</function>, <function>is_array</function> も参照下さい。 </para> @@ -756,16 +829,18 @@ <function>isset</function> はもう&true;とはなりません。 &null;に設定されている変数を調べた場合、 <function>isset</function> は&false;を返します。 - ヌルバイト(<literal>"\0"</literal>)はPHPの定数 + &null;バイト(<literal>"\0"</literal>)はPHPの定数 &null;と等価ではないことにも注意して下さい。 <informalexample> <programlisting role="php"> +<![CDATA[ $a = "test"; echo isset ($a); // TRUE unset ($a); echo isset ($a); // FALSE $foo = NULL; -print isset ($foo); // FALSE +print isset ($foo); // FALSE +]]> </programlisting> </informalexample> </para> @@ -792,10 +867,11 @@ </funcprototype> </funcsynopsis> <simpara> - この関数は、解り易い形式で変数の値に関する情報を表示します。 - 文字列、整数、倍制度実数を指定した場合はその値が出力されます。 - 配列を指定した場合、キーと要素を表す形式で値が表示されます。 - オブジェクトに関しても同様の表示形式となります。 + <function>print_r</function>は、解り易い形式で変数の値に関する情 + 報を表示します。<type>string</type>, <type>integer</type>, + <type>float</type>を指定した場合はその値が出力されます。 + <type>array</type>を指定した場合、キーと要素を表す形式で値が表示 + されます。<type>object</type>に関しても同様の表示形式となります。 </simpara> <simpara> <function>print_r</function>は、配列ポインタを終端まで移動するこ @@ -806,26 +882,55 @@ <function>print_r</function>を <function>var_dump</function>と比較してみて下さい。 </simpara> + &tip.ob-capture; <para> <informalexample> <programlisting role="php"> -&lt;?php -$a = array (1, 2, array ("a", "b", "c")); -print_r ($a); +<![CDATA[ +<pre> +<?php + $a = array ('a' => 'apple', 'b' => 'banana', 'c' => array ('x','y','z')); + print_r ($a); ?> +</pre> +]]> </programlisting> </informalexample> </para> - <warning> - <para> - この関数は、指定した配列またはオブジェクが自分自身への直接または - 間接の参照を有しているか、同様のことを行う配列またはオブジェクト - を有している場合に際限なく実行し続けます。 - 特に<literal>$GLOBALS</literal>はそれ自体グローバル変数で、 - 自分自身へのリファレンスを有しているため、 - <literal>print_r($GLOBALS)</literal>はこのケースにあたります。 + <para> + 出力は次のようになります: + <screen> +<![CDATA[ +<pre> +Array +( + [a] => apple + [b] => banana + [c] => Array + ( + [0] => x + [1] => y + [2] => z + ) +) +</pre> +]]> + </screen> </para> - </warning> + <note> + <simpara> + PHP 4.0.4より前のバージョンでは、自分自身への直接または間接の参 + 照を含む<type>array</type>または<type>object</type>が指定された + 場合には、無限に<function>print_r</function>が実行されてしまいま + した。<literal>print_r($GLOBALS)</literal>が例で、 + <literal>$GLOBALS</literal>はそれ自体自分自身への参照を有するグ + ローバル変数です。 + </simpara> + </note> + <simpara> + <function>ob_start</function>, <function>var_dump</function>, + <function>var_export</function>も参照下さい。 + </simpara> </refsect1> </refentry> @@ -849,21 +954,33 @@ 保存可能なバイトストリーム表現を含む文字列を返します。 </simpara> <simpara> - 型や構造を失わずにPHPの値を保存または渡す際に有効です。 + 型や構造を失わずにPHPの値を保存または渡す際に有用です。 </simpara> <simpara> シリアル化された文字列をPHPの値に戻すには、 <function>unserialize</function>を使用して下さい。 - <function>serialize</function>は型<type>integer</type>, - <type>double</type>,<type>string</type>,<type>array</type> - (多次元),<type>object</type> - (オブジェクトプロパティはシリアル化されますが、メソッドは失われます) - に対応します。 - </simpara> + <function>serialize</function>は、<type>resource</type>以外の全て + の型を処理します。自分自身への参照を含む配列を + <function>serialize</function>することも可能です。 + <function>serialize</function>している配列/オブジェクト内の参照も + 保存されます。 + </simpara> + <!-- TODO + in 4.0.4pl1 this didn't work properly, however, there + been some fixes. I don't know whether this all + works correctly now, and if so, whether it is since 405 + or 406 + <note> + <simpara> + This didn't work correctly until 4.0.? + </simpara> + </note> + </simpara> + --> <note> <para> - PHP 3では、メソッドはシリアル化されたオブジェクトを非シリアル化 - する際に保存されません。PHP 4ではこの制限は取り除かれ、プロパティ + PHP 3では、オブジェクトのプロパティはシリアル化されますが、メソッ + ドは失われます。PHP 4ではこの制限は取り除かれ、プロパティ とメソッドの両方を保存します。より詳細な情報については、 <link linkend="language.oop">オブジェクトとクラス</link> の <link linkend="language.oop.serialization">オブジェクトのシリア @@ -874,21 +991,23 @@ <example> <title><function>serialize</function>の例</title> <programlisting role="php"> +<![CDATA[ // $session_data はカレントユーザーのセッション情報を含む多次元配列を // 保持しています。リクエストの最後にこれをデータベースに保存するために // serialize() を使用します。 -$conn = odbc_connect("webdb", "php", "chicken"); -$stmt = odbc_prepare($conn, +$conn = odbc_connect ("webdb", "php", "chicken"); +$stmt = odbc_prepare ($conn, "UPDATE sessions SET data = ? WHERE id = ?"); -$sqldata = array(serialize($session_data), $PHP_AUTH_USER); -if (!odbc_execute($stmt, &amp;$sqldata)) { +$sqldata = array (serialize($session_data), $PHP_AUTH_USER); +if (!odbc_execute ($stmt, &amp;$sqldata)) { $stmt = odbc_prepare($conn, "INSERT INTO sessions (id, data) VALUES(?, ?)"); if (!odbc_execute($stmt, &amp;$sqldata)) { /* 何か問題があったようです。Bitch, whine and moan. */ } } +]]> </programlisting> </example> </para> @@ -907,7 +1026,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>boolean <function>settype</function></funcdef> + <funcdef>bool <function>settype</function></funcdef> <paramdef>mixed <parameter>var</parameter></paramdef> <paramdef>string <parameter>type</parameter></paramdef> </funcprototype> @@ -918,14 +1037,43 @@ </para> <para> <parameter>type</parameter> の値は以下の命令のいずれかです。 - <itemizedlist> - <listitem><simpara>"boolean"</simpara></listitem> - <listitem><simpara>"integer"</simpara></listitem> - <listitem><simpara>"double"</simpara></listitem> - <listitem><simpara>"string"</simpara></listitem> - <listitem><simpara>"array"</simpara></listitem> - <listitem><simpara>"object"</simpara></listitem> + <listitem> + <simpara> + "boolean" (または、PHP 4.2.0以降は"bool") + </simpara> + </listitem> + <listitem> + <simpara> + "integer" (または、PHP 4.2.0以降は"int") + </simpara> + </listitem> + <listitem> + <simpara> + "float" (PHP 4.2.0以降でのみ可能、古いバージョンでは、"double" + を使用します) + </simpara> + </listitem> + <listitem> + <simpara> + "string" + </simpara> + </listitem> + <listitem> + <simpara> + "array" + </simpara> + </listitem> + <listitem> + <simpara> + "object" + </simpara> + </listitem> + <listitem> + <simpara> + "null" (PHP 4.1.0以降) + </simpara> + </listitem> </itemizedlist> </para> <para> @@ -935,16 +1083,21 @@ <example> <title><function>settype</function> の例</title> <programlisting role="php"> +<![CDATA[ $foo = "5bar"; // string $bar = true; // boolean settype($foo, "integer"); // ここでは、$foo は 5です (整数) settype($bar, "string"); // ここでは、$bar は "1" です (文字列) +]]> </programlisting> </example> </para> <para> - <function>gettype</function> も参照下さい。 + <function>gettype</function>, + <link linkend="language.types.typecasting">type-casting</link>, + <link linkend="language.types.type-juggling">type-juggling</link> + も参照下さい。 </para> </refsect1> </refentry> @@ -963,16 +1116,18 @@ </funcprototype> </funcsynopsis> <simpara> - <parameter>var</parameter> の文字列としての値を返します。 + <parameter>var</parameter>の<type>string</type>としての値を返しま + す。文字列への変換の詳細については、<type>string</type>のドキュメ + ントを参照下さい。 </simpara> <simpara> - <parameter>var</parameter> は全てのスカラー型とすることができます。 - <function>strval</function> では、配列またはオブジェクトを - 使用することはできません。 + <parameter>var</parameter>は、全てのスカラー値にできます。 + <function>strval</function>に配列又はオブジェクトは使用可能できま + せん。 </simpara> <simpara> - <function>doubleval</function>,<function>intval</function>, - <function>settype</function> , + <function>floatval</function>, + <function>intval</function>, <function>settype</function>, <link linkend="language.types.type-juggling">型の相互変換(ジャグリング) </link>を参照下さい。 </simpara> @@ -996,13 +1151,43 @@ <function>unserialize</function> は、シリアル化された変数 (<function>serialize</function> を参照) をとり、PHP 変数値に 戻す変換を行います。変換された値が返されます。その値は、 - <type>integer</type>, <type>double</type>, + <type>integer</type>, <type>float</type>, <type>string</type>, <type>array</type> , <type>object</type> とすることが可能です。オブジェクトがシリアル化された場合、返り値 にそのメソッドは保存されていません。 </simpara> <note> <para> + コールバック関数を設定することが可能です。(不完全な + <type>object</type> "__PHP_Incomplete_Class"を得ることを防ぐため) + コールバック関数は、非シリアル化する際に未定義のクラスをインスタ + ンス化する必要がある場合にコールされます。 + 'unserialize_callback_func'を定義するためには、 + php.ini, <function>ini_set</function>, .htaccessファイルを使用し + て下さい。未定義のクラスをインスタンス化する度に、コールバック関 + 数がコールされます。この機能を無効とするには、このグローバル変数 + を空として下さい。 + </para> + </note> + <para> + <example> + <title>unserialize_callback_funcの例</title> + <programlisting role="php"> +<![CDATA[ +$serialized_object='O:1:"a":1:{s:5:"value";s:3:"100";}'; + +ini_set('unserialize_callback_func','mycallback'); // set your callback_function + +function mycallback($classname) { + // just include a file containing your classdefinition + // you get $classname to figure out which classdefinition is required +} +]]> + </programlisting> + </example> + </para> + <note> + <para> PHP 3では、メソッドはシリアル化されたオブジェクトを非シリアル化 する際に保存されません。PHP 4ではこの制限は取り除かれ、プロパティ とメソッドの両方を保存します。より詳細な情報については、 @@ -1015,24 +1200,26 @@ <example> <title><function>unserialize</function>の例</title> <programlisting role="php"> +<![CDATA[ // ここで、データベースから $session_data にセッションデータをロード // するために unserialize() を使用します。 // この例は、<function>serialize</function> で記述された例を補足するものです。 -$conn = odbc_connect("webdb", "php", "chicken"); -$stmt = odbc_prepare($conn, "SELECT data FROM sessions WHERE id = ?"); -$sqldata = array($PHP_AUTH_USER); -if (!odbc_execute($stmt, &amp;$sqldata) || !odbc_fetch_into($stmt, &amp;$tmp)) { +$conn = odbc_connect ("webdb", "php", "chicken"); +$stmt = odbc_prepare ($conn, "SELECT data FROM sessions WHERE id = ?"); +$sqldata = array ($PHP_AUTH_USER); +if (!odbc_execute ($stmt, &amp;$sqldata) || !odbc_fetch_into ($stmt, &amp;$tmp)) { // 実行または取得が失敗した場合、空の配列で初期化します $session_data = array(); } else { // $tmp[0] にシリアル化されたデータを保持している必要があります。 - $session_data = unserialize($tmp[0]); - if (!is_array($session_data)) { + $session_data = unserialize ($tmp[0]); + if (!is_array ($session_data)) { // 何か問題があったため、空の配列で初期化します。 $session_data = array(); } } +]]> </programlisting> </example> </para> @@ -1077,6 +1264,7 @@ <example> <title><function>unset</function>の例</title> <programlisting role="php"> +<![CDATA[ // 変数を一つ破棄する unset ($foo); @@ -1085,6 +1273,7 @@ // 複数の変数を破棄する unset ($foo1, $foo2, $foo3); +]]> </programlisting> </example> </para> @@ -1098,6 +1287,7 @@ <function>unset</function>がコールされる前と同じ値を保持します。 <informalexample> <programlisting role="php"> +<![CDATA[ function destroy_foo() { global $foo; unset($foo); @@ -1106,13 +1296,16 @@ $foo = 'bar'; destroy_foo(); echo $foo; +]]> </programlisting> </informalexample> 上記の例の出力は次のようになります。 <informalexample> - <programlisting> + <screen> +<![CDATA[ bar - </programlisting> +]]> + </screen> </informalexample> </para> <para> @@ -1121,7 +1314,8 @@ <function>unset</function>がコールされる前と同じ値を保持します。 <informalexample> <programlisting role="php"> -function foo(&amp;$bar) { +<![CDATA[ +function foo(&$bar) { unset($bar); $bar = "blah"; } @@ -1131,23 +1325,28 @@ foo($bar); echo "$bar\n"; +]]> </programlisting> </informalexample> + 上の例の出力は以下のようになります。 The above example would output: <informalexample> - <programlisting> + <screen> +<![CDATA[ something something - </programlisting> +]]> + </screen> </informalexample> </para> <para> 静的変数が関数の内部で<function>unset</function>された場合、 - <function>unset</function> は静的変数自体ではなく静的変数へのリファ - レンスを破棄します。 + <function>unset</function>は、その変数とその静的変数への全てのリ + ファレンスを破棄します。 <informalexample> <programlisting role="php"> -function foo() { +<![CDATA[ +function foo() { static $a; $a++; echo "$a\n"; @@ -1158,15 +1357,18 @@ foo(); foo(); foo(); +]]> </programlisting> </informalexample> 上記の例の出力は次のようになります。 <informalexample> - <programlisting> + <screen> +<![CDATA[ 1 -2 -3 - </programlisting> +1 +1 +]]> + </screen> </informalexample> </para> <para> @@ -1174,12 +1376,14 @@ 配列<parameter>$GLOBALS</parameter>を使用し、次のようにして下さい。 <informalexample> <programlisting role="php"> +<![CDATA[ function foo() { - unset($GLOBALS['bar']); + unset($GLOBALS['bar']); } $bar = "something"; foo(); +]]> </programlisting> </informalexample> </para> @@ -1207,13 +1411,20 @@ <funcprototype> <funcdef>void <function>var_dump</function></funcdef> <paramdef>mixed <parameter>expression</parameter></paramdef> + <paramdef>mixed + <parameter><optional>expression</optional></parameter> + </paramdef> + <paramdef> + <parameter><optional>...</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <simpara> - この関数は、指定した式に関してその型や値を含む構造化された - 情報を返します。 - 配列の場合、その構造を表示するために各値について再帰的に探索されます。 + この関数は、指定した式に関してその型や値を含む構造化された情報を + 返します。配列の場合、その構造を表示するために各値について再帰的 + に探索されます。 </simpara> + &tip.ob-capture; <simpara> <function>var_dump</function>を <function>print_r</function>と比較して見て下さい。 @@ -1221,14 +1432,140 @@ <para> <informalexample> <programlisting role="php"> -&lt;pre> -&lt;?php - $a = array (1, 2, array ("a", "b", "c")); - var_dump ($a); +<![CDATA[ +<pre> +<?php +$a = array (1, 2, array ("a", "b", "c")); +var_dump ($a); + +/* output: +array(3) { + [0]=> + int(1) + [1]=> + int(2) + [2]=> + array(3) { + [0]=> + string(1) "a" + [1]=> + string(1) "b" + [2]=> + string(1) "c" + } +} + +*/ + +$b = 3.1; $c = TRUE; +var_dump($b,$c); + +/* output: +float(3.1) +bool(true) + +*/ +?>; +</pre> +]]> + </programlisting> + </informalexample> + </para> + </refsect1> + </refentry> + + <refentry id="function.var-export"> + <refnamediv> + <refname>var_export</refname> + <refpurpose> + 変数の文字列表現を出力または返す + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>var_export</function></funcdef> + <paramdef>mixed <parameter>expression</parameter></paramdef> + <paramdef>int + <parameter><optional>return</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + この関数は、この関数に渡された変数に関する構造化された情報を返し + ます。この関数は、<function>var_dump</function>に似ていますが、 + 返される表現が有効なPHPコードであるところが異なります。 + </simpara> + <simpara> + この関数の2番目の引数に&true;を指定することにより、変数表現を返す + ことも可能です。 + </simpara> + <simpara> + <function>var_export</function>を<function>var_dump</function>と + 比較して下さい。 + </simpara> + <para> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<pre> +<?php +$a = array (1, 2, array ("a", "b", "c")); +var_export ($a); + +/* output: +array ( + 0 => 1, + 1 => 2, + 2 => + array ( + 0 => 'a', + 1 => 'b', + 2 => 'c', + ), +) +*/ + +$b = 3.1; +$v = var_export($b, TRUE); +echo $v; + +/* output: +3.1 +*/ ?> -&lt;/pre> +</pre> +]]> </programlisting> </informalexample> + </para> + </refsect1> + </refentry> + + <refentry id='function.is-callable'> + <refnamediv> + <refname>is_callable</refname> + <refpurpose> + 引数が有効なコール可能な構造であるかどうかを調べる + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>is_callable</function></funcdef> + <paramdef>mixed <parameter>var</parameter></paramdef> + <paramdef>bool + <parameter><optional>syntax_only</optional></parameter> + </paramdef> + <paramdef>string + <parameter><optional>callable_name</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; </para> </refsect1> </refentry>
« previous php.doc (#969341652) next »