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: | Rui Hirokawa | 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"> -<?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"> -<?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"> -<?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"> -<?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', <'first_val','second_val'>) +<![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"> -<?php -if (! sesam_connect ("mycatalog", "myschema", "otto") - die("SESAMã«æ¥ç¶ã§ãã¾ãã"; -?> +<![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"> -<?php -sesam_settransaction(SESAM_TXISOL_REPEATABLE_READ, +<![CDATA[ +<?php +sesam_settransaction (SESAM_TXISOL_REPEATABLE_READ, SESAM_TXREAD_READONLY); -?> +?> +]]> </programlisting> </example> </para> @@ -730,14 +749,16 @@ <example> <title>SESAM ãã¼ã¿ãã¼ã¹ã®æ´æ°ãã³ããããã</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (sesam_connect ("mycatalog", "myschema", "otto")) { - if (!sesam_execimm("INSERT INTO mytable VALUES (*, 'Small Test', <0, 8, 15>)")) - 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"); } -?> +?> +]]> </programlisting> </example> </para> @@ -777,15 +798,17 @@ <example> <title>SESAM ãã¼ã¿ãã¼ã¹ã¸ã®æ´æ°ãç ´æ£ãã</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (sesam_connect ("mycatalog", "myschema", "otto")) { - 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(); + 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(); } -?> +?> +]]> </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"> -<?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 "<TABLE BORDER>\n"; -// ä¸ã®çµæã«ã©ã åã§ã¿ã¤ãã«ãããã追å ãã -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]; - /* SESAMã®"è¤æ°ãã¼ãã«"ã«ã¾ããããã¼ãã«ããããå±é: */ - if ($colattr["count"] > 1) { - echo " <TH COLSPAN=".$colattr["count"].">".$colattr["name"]. - "(1..".$colattr["count"].")</TH>\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 " <TH>" . $colattr["name"] . "</TH>\n"; - } - echo " </TR>\n"; + echo " </TR>\n"; } do { - // æå¤§100ã¬ã³ã¼ãåã®çµæãåå¾ - $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"; + // 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 " </TR>\n"; - } -} while ($ok["truncated"]); // ã¾ã ãã¼ã¿ãããå¯è½æ§ãããé -echo "</TABLE>\n"; -// çµæIDãéæ¾ +} +while ($ok["truncated"]) { // while there may be more data + echo "</TABLE>\n"; +} +// free result id sesam_free_result($result); -?> +?> +]]> </programlisting> </example> </para> @@ -1100,7 +1129,8 @@ <example> <title>ã¨ã©ã¼ä½ç½®ãä»ãã¦SESAMã¨ã©ã¼ã¡ãã»ã¼ã¸ã表示</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php // ãã©ã¼ããããããã¨ã©ã¼ã¡ãã»ã¼ã¸ãåºåãã颿° // SQLå½ä»¤ã«ãããæ§æã¨ã©ã¼ã®å ´æã表示 function PrintReturncode($exec_str) @@ -1113,58 +1143,58 @@ --$colspan; if ($err["rowcount"] == 0) --$colspan; - 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 ã¯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"; + 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); -?> + " 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<br>\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"> -<?php -$result = sesam_query ("SELECT * FROM phone\n". - " WHERE LASTNAME='".strtoupper($name)."'\n". - " ORDER BY FIRSTNAME", 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 "<TABLE BORDER>\n"; +// print the table in backward order +print "<TABLE BORDER>\n"; $row = sesam_fetch_row ($result, SESAM_SEEK_LAST); -while (is_array($row)) { - print " <TR>\n"; - for($col = 0; $col < $row["count"]; ++$col) { - print " <TD>".htmlspecialchars($row[$col])."</TD>\n"; +while (is_array ($row)) { + print " <TR>\n"; + for ($col = 0; $col < $row["count"]; ++$col) { + print " <TD>".htmlspecialchars ($row[$col])."</TD>\n"; } - print " </TR>\n"; - // æé»ã® SESAM_SEEK_PRIOR ãä½¿ç¨ + print " </TR>\n"; + // use implied SESAM_SEEK_PRIOR $row = sesam_fetch_row ($result); } -print "</TABLE>\n"; +print "</TABLE>\n"; sesam_free_result ($result); -?> +?> +]]> </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"> -<?php -$result = sesam_query ("SELECT * FROM phone\n". - " WHERE LASTNAME='".strtoupper($name)."'\n". - " ORDER BY FIRSTNAME", 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 "<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 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 "</TABLE>\n"; +print "</TABLE>\n"; sesam_free_result ($result); -?> +?> +]]> </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"> -<?php -session_register("count"); -$HTTP_SESSION_VARS["count"]++; -?> +<![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"> -<?php -session_register("count"); -$count++; -?> +<![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"> -<?php -session_register("count"); -$count++; -?> +<![CDATA[ +<?php +if (!session_is_registered('count')) { + session_register('count'); + $count = 1; +} +else { + $count++; +} +?> -ããã«ã¡ã¯ãããªãããã®ãã¼ã¸ã«æ¥ãã®ã¯<?php echo $count; ?>åç®ã§ããã <p> +ããã«ã¡ã¯ãããªãããã®ãã¼ã¸ã«æ¥ãã®ã¯<?php echo $count; ?>åç®ã§ããã <p> -<php? +<?php # ã¦ã¼ã¶ã¼ãã¯ããã¼ã使ç¨ä¸å¯ã¨ãã¦ããå ´åã¯ãã»ãã·ã§ã³IDã -# ä¿æããããã« <?=SID?> ãå¿ è¦ã§ãã -?> +# ä¿æããããã«<?=SID> ãå¿ è¦ã§ãã +?> -ç¶ããã«ã¯ã -<A HREF="nextpage.php?<?=SID?>">ãããã¯ãªãã¯</A> -ãã¦ä¸ããã +ç¶ããã«ã¯ã<A HREF="nextpage.php?<?=SID?>">ãããã¯ãªãã¯</A>ãã¦ä¸ããã +]]> </programlisting> </example> </para> <para> - PHPã®ã³ã³ãã¤ã«æã« <literal>--enable-trans-sid</literal>ãæå®ã - ãå ´åã«ã¯ã<literal><?=SID?></literal> ã¯å¿ è¦ããã¾ããã + PHPã®ã³ã³ãã¤ã«æã« <link linkend="install.configure.enable-trans-sid"> + <literal>--enable-trans-sid</literal></link>ãæå®ããå ´åã«ã¯ã + <literal><?=SID?></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"> -<?php +<![CDATA[ +<?php -# ã»ãã·ã§ã³åãWebsiteIDã«è¨å®ãã +// ã»ãã·ã§ã³åãWebsiteIDã«è¨å®ãã $previous_name = session_name("WebsiteID"); -echo "ååã®ã»ãã·ã§ã³åã¯ã$previous_name ã§ãã<p>"; -?> +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"> -<?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 -?> +?> +]]> </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"> -<?php +<![CDATA[ +<?php # ãã£ãã·ã¥ãªããã¿ã'private'ã«è¨å®ãã session_cache_limiter('private'); $cache_limiter = session_cache_limiter(); -echo "The cache limiter is now set to $cache_limiter<p>"; -?> +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"> -<?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); -?> +?> +]]> </programlisting> </example> </para> @@ -119,9 +126,11 @@ <example> <title>å ±æã¡ã¢ãªãããã¯ãæ°è¦ã«ä½æãã</title> <programlisting role="php"> -<?php -$shm_id = shmop_open (0x0fff, "c", 0644, 100); -?> +<![CDATA[ +<?php +$shm_id = shmop_open(0x0fff, "c", 0644, 100); +?> +]]> </programlisting> </example> </para> @@ -159,9 +168,11 @@ <example> <title>å ±æã¡ã¢ãªãããã¯ãèªã¿è¾¼ã</title> <programlisting role="php"> -<?php -$shm_data = shmop_read ($shm_id, 0, 50); -?> +<![CDATA[ +<?php +$shm_data = shmop_read($shm_id, 0, 50); +?> +]]> </programlisting> </example> </para> @@ -201,9 +212,11 @@ <example> <title>å ±æã¡ã¢ãªãããã¯ã«æ¸ãè¾¼ã</title> <programlisting role="php"> -<?php -$shm_bytes_written = shmop_write ($shm_id, $my_string, 0); -?> +<![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"> -<?php +<![CDATA[ +<?php $shm_size = shmop_size($shm_id); -?> +?> +]]> </programlisting> </example> </para> @@ -280,9 +295,11 @@ <example> <title>å ±æã¡ã¢ãªãããã¯ã®åé¤</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php shmop_delete($shm_id); -?> +?> +]]> </programlisting> </example> </para> @@ -318,9 +335,11 @@ <example> <title>å ±æã¡ã¢ãªãããã¯ãéãã</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php shmop_close($shm_id); -?> +?> +]]> </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<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]<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<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<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"> -<?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)) < 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)) < 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)) < 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)) < 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 < 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"> -<?php -error_reporting(E_ALL); - -echo "<h2>TCP/IP Connection</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 < 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 < 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"> -<?php -error_reporting(E_ALL); - -/* ã¹ã¯ãªãããæ¥ç¶ãå¾ ã¡ç¶ãããã¨ã許å¯ãã */ -set_time_limit(0); - -if (($sock = socket(AF_INET, SOCK_STREAM, 0)) < 0) { - echo "socket() failed: reason: " . strerror($sock) . "\n"; -} - -if (($ret = bind($sock, '192.168.1.53', 10001)) < 0) { - echo "bind() failed: reason: " . strerror($ret) . "\n"; -} - -if (($ret = listen($sock, 5)) < 0) { - echo "listen() failed: reason: " . strerror($ret) . "\n"; -} - -do { - if (($msgsock = accept_connect($soc<function>socket_get_status</function>, k)) < 0) { - echo "accept_connect() failed: reason: " . strerror($msgsock) . "\n"; - break; - } - do { - $buf = ''; - $ret = read($msgsock, $buf, 2048); - if ($ret < 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 >= 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"> -<?php -if (($socket = socket(AF_INET, SOCK_STREAM, 0)) < 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)) < 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>&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>&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>&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-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>&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-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>&buf</parameter></paramdef> + <paramdef>int <parameter>len</parameter></paramdef> + <paramdef>int <parameter>flags</parameter></paramdef> + <paramdef>string <parameter>&name</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-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>&control</parameter></paramdef> + <paramdef>int <parameter>&controllen</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-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>&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, "äåö", "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"> -<?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 < 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 < 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"> -<?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 '<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 '<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 ('&', $QUERY_STRING); +<![CDATA[ +$a = explode('&', $QUERY_STRING); $i = 0; -while ($i < count ($a)) { - $b = split ('=', $a [$i]); - echo 'Value for parameter ', htmlspecialchars (urldecode ($b [0])), - ' is ', htmlspecialchars (urldecode ($b [1])), "<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 '<A HREF="mycgi?foo=', urlencode ($userinput), '">'; +<![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 '<A HREF="mycgi?foo=', htmlentities (urlencode ($userinput) ), '">'; +<![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"> -<?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, &$sqldata)) { +$sqldata = array (serialize($session_data), $PHP_AUTH_USER); +if (!odbc_execute ($stmt, &$sqldata)) { $stmt = odbc_prepare($conn, "INSERT INTO sessions (id, data) VALUES(?, ?)"); if (!odbc_execute($stmt, &$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, &$sqldata) || !odbc_fetch_into($stmt, &$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, &$sqldata) || !odbc_fetch_into ($stmt, &$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(&$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"> -<pre> -<?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 +*/ ?> -</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>
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"> -<?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"> -<?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"> -<?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"> -<?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', <'first_val','second_val'>) +<![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"> -<?php -if (! sesam_connect ("mycatalog", "myschema", "otto") - die("SESAMã«æ¥ç¶ã§ãã¾ãã"; -?> +<![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"> -<?php -sesam_settransaction(SESAM_TXISOL_REPEATABLE_READ, +<![CDATA[ +<?php +sesam_settransaction (SESAM_TXISOL_REPEATABLE_READ, SESAM_TXREAD_READONLY); -?> +?> +]]> </programlisting> </example> </para> @@ -730,14 +749,16 @@ <example> <title>SESAM ãã¼ã¿ãã¼ã¹ã®æ´æ°ãã³ããããã</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (sesam_connect ("mycatalog", "myschema", "otto")) { - if (!sesam_execimm("INSERT INTO mytable VALUES (*, 'Small Test', <0, 8, 15>)")) - 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"); } -?> +?> +]]> </programlisting> </example> </para> @@ -777,15 +798,17 @@ <example> <title>SESAM ãã¼ã¿ãã¼ã¹ã¸ã®æ´æ°ãç ´æ£ãã</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (sesam_connect ("mycatalog", "myschema", "otto")) { - 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(); + 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(); } -?> +?> +]]> </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"> -<?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 "<TABLE BORDER>\n"; -// ä¸ã®çµæã«ã©ã åã§ã¿ã¤ãã«ãããã追å ãã -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]; - /* SESAMã®"è¤æ°ãã¼ãã«"ã«ã¾ããããã¼ãã«ããããå±é: */ - if ($colattr["count"] > 1) { - echo " <TH COLSPAN=".$colattr["count"].">".$colattr["name"]. - "(1..".$colattr["count"].")</TH>\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 " <TH>" . $colattr["name"] . "</TH>\n"; - } - echo " </TR>\n"; + echo " </TR>\n"; } do { - // æå¤§100ã¬ã³ã¼ãåã®çµæãåå¾ - $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"; + // 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 " </TR>\n"; - } -} while ($ok["truncated"]); // ã¾ã ãã¼ã¿ãããå¯è½æ§ãããé -echo "</TABLE>\n"; -// çµæIDãéæ¾ +} +while ($ok["truncated"]) { // while there may be more data + echo "</TABLE>\n"; +} +// free result id sesam_free_result($result); -?> +?> +]]> </programlisting> </example> </para> @@ -1100,7 +1129,8 @@ <example> <title>ã¨ã©ã¼ä½ç½®ãä»ãã¦SESAMã¨ã©ã¼ã¡ãã»ã¼ã¸ã表示</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php // ãã©ã¼ããããããã¨ã©ã¼ã¡ãã»ã¼ã¸ãåºåãã颿° // SQLå½ä»¤ã«ãããæ§æã¨ã©ã¼ã®å ´æã表示 function PrintReturncode($exec_str) @@ -1113,58 +1143,58 @@ --$colspan; if ($err["rowcount"] == 0) --$colspan; - 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 ã¯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"; + 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); -?> + " 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<br>\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"> -<?php -$result = sesam_query ("SELECT * FROM phone\n". - " WHERE LASTNAME='".strtoupper($name)."'\n". - " ORDER BY FIRSTNAME", 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 "<TABLE BORDER>\n"; +// print the table in backward order +print "<TABLE BORDER>\n"; $row = sesam_fetch_row ($result, SESAM_SEEK_LAST); -while (is_array($row)) { - print " <TR>\n"; - for($col = 0; $col < $row["count"]; ++$col) { - print " <TD>".htmlspecialchars($row[$col])."</TD>\n"; +while (is_array ($row)) { + print " <TR>\n"; + for ($col = 0; $col < $row["count"]; ++$col) { + print " <TD>".htmlspecialchars ($row[$col])."</TD>\n"; } - print " </TR>\n"; - // æé»ã® SESAM_SEEK_PRIOR ãä½¿ç¨ + print " </TR>\n"; + // use implied SESAM_SEEK_PRIOR $row = sesam_fetch_row ($result); } -print "</TABLE>\n"; +print "</TABLE>\n"; sesam_free_result ($result); -?> +?> +]]> </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"> -<?php -$result = sesam_query ("SELECT * FROM phone\n". - " WHERE LASTNAME='".strtoupper($name)."'\n". - " ORDER BY FIRSTNAME", 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 "<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 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 "</TABLE>\n"; +print "</TABLE>\n"; sesam_free_result ($result); -?> +?> +]]> </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"> -<?php -session_register("count"); -$HTTP_SESSION_VARS["count"]++; -?> +<![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"> -<?php -session_register("count"); -$count++; -?> +<![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"> -<?php -session_register("count"); -$count++; -?> +<![CDATA[ +<?php +if (!session_is_registered('count')) { + session_register('count'); + $count = 1; +} +else { + $count++; +} +?> -ããã«ã¡ã¯ãããªãããã®ãã¼ã¸ã«æ¥ãã®ã¯<?php echo $count; ?>åç®ã§ããã <p> +ããã«ã¡ã¯ãããªãããã®ãã¼ã¸ã«æ¥ãã®ã¯<?php echo $count; ?>åç®ã§ããã <p> -<php? +<?php # ã¦ã¼ã¶ã¼ãã¯ããã¼ã使ç¨ä¸å¯ã¨ãã¦ããå ´åã¯ãã»ãã·ã§ã³IDã -# ä¿æããããã« <?=SID?> ãå¿ è¦ã§ãã -?> +# ä¿æããããã«<?=SID> ãå¿ è¦ã§ãã +?> -ç¶ããã«ã¯ã -<A HREF="nextpage.php?<?=SID?>">ãããã¯ãªãã¯</A> -ãã¦ä¸ããã +ç¶ããã«ã¯ã<A HREF="nextpage.php?<?=SID?>">ãããã¯ãªãã¯</A>ãã¦ä¸ããã +]]> </programlisting> </example> </para> <para> - PHPã®ã³ã³ãã¤ã«æã« <literal>--enable-trans-sid</literal>ãæå®ã - ãå ´åã«ã¯ã<literal><?=SID?></literal> ã¯å¿ è¦ããã¾ããã + PHPã®ã³ã³ãã¤ã«æã« <link linkend="install.configure.enable-trans-sid"> + <literal>--enable-trans-sid</literal></link>ãæå®ããå ´åã«ã¯ã + <literal><?=SID?></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"> -<?php +<![CDATA[ +<?php -# ã»ãã·ã§ã³åãWebsiteIDã«è¨å®ãã +// ã»ãã·ã§ã³åãWebsiteIDã«è¨å®ãã $previous_name = session_name("WebsiteID"); -echo "ååã®ã»ãã·ã§ã³åã¯ã$previous_name ã§ãã<p>"; -?> +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"> -<?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 -?> +?> +]]> </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"> -<?php +<![CDATA[ +<?php # ãã£ãã·ã¥ãªããã¿ã'private'ã«è¨å®ãã session_cache_limiter('private'); $cache_limiter = session_cache_limiter(); -echo "The cache limiter is now set to $cache_limiter<p>"; -?> +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"> -<?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); -?> +?> +]]> </programlisting> </example> </para> @@ -119,9 +126,11 @@ <example> <title>å ±æã¡ã¢ãªãããã¯ãæ°è¦ã«ä½æãã</title> <programlisting role="php"> -<?php -$shm_id = shmop_open (0x0fff, "c", 0644, 100); -?> +<![CDATA[ +<?php +$shm_id = shmop_open(0x0fff, "c", 0644, 100); +?> +]]> </programlisting> </example> </para> @@ -159,9 +168,11 @@ <example> <title>å ±æã¡ã¢ãªãããã¯ãèªã¿è¾¼ã</title> <programlisting role="php"> -<?php -$shm_data = shmop_read ($shm_id, 0, 50); -?> +<![CDATA[ +<?php +$shm_data = shmop_read($shm_id, 0, 50); +?> +]]> </programlisting> </example> </para> @@ -201,9 +212,11 @@ <example> <title>å ±æã¡ã¢ãªãããã¯ã«æ¸ãè¾¼ã</title> <programlisting role="php"> -<?php -$shm_bytes_written = shmop_write ($shm_id, $my_string, 0); -?> +<![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"> -<?php +<![CDATA[ +<?php $shm_size = shmop_size($shm_id); -?> +?> +]]> </programlisting> </example> </para> @@ -280,9 +295,11 @@ <example> <title>å ±æã¡ã¢ãªãããã¯ã®åé¤</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php shmop_delete($shm_id); -?> +?> +]]> </programlisting> </example> </para> @@ -318,9 +335,11 @@ <example> <title>å ±æã¡ã¢ãªãããã¯ãéãã</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php shmop_close($shm_id); -?> +?> +]]> </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<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]<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<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<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"> -<?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)) < 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)) < 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)) < 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)) < 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 < 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"> -<?php -error_reporting(E_ALL); - -echo "<h2>TCP/IP Connection</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 < 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 < 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"> -<?php -error_reporting(E_ALL); - -/* ã¹ã¯ãªãããæ¥ç¶ãå¾ ã¡ç¶ãããã¨ã許å¯ãã */ -set_time_limit(0); - -if (($sock = socket(AF_INET, SOCK_STREAM, 0)) < 0) { - echo "socket() failed: reason: " . strerror($sock) . "\n"; -} - -if (($ret = bind($sock, '192.168.1.53', 10001)) < 0) { - echo "bind() failed: reason: " . strerror($ret) . "\n"; -} - -if (($ret = listen($sock, 5)) < 0) { - echo "listen() failed: reason: " . strerror($ret) . "\n"; -} - -do { - if (($msgsock = accept_connect($soc<function>socket_get_status</function>, k)) < 0) { - echo "accept_connect() failed: reason: " . strerror($msgsock) . "\n"; - break; - } - do { - $buf = ''; - $ret = read($msgsock, $buf, 2048); - if ($ret < 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 >= 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"> -<?php -if (($socket = socket(AF_INET, SOCK_STREAM, 0)) < 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)) < 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>&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>&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>&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-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>&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-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>&buf</parameter></paramdef> + <paramdef>int <parameter>len</parameter></paramdef> + <paramdef>int <parameter>flags</parameter></paramdef> + <paramdef>string <parameter>&name</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-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>&control</parameter></paramdef> + <paramdef>int <parameter>&controllen</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-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>&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, "äåö", "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"> -<?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 < 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 < 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"> -<?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 '<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 '<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 ('&', $QUERY_STRING); +<![CDATA[ +$a = explode('&', $QUERY_STRING); $i = 0; -while ($i < count ($a)) { - $b = split ('=', $a [$i]); - echo 'Value for parameter ', htmlspecialchars (urldecode ($b [0])), - ' is ', htmlspecialchars (urldecode ($b [1])), "<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 '<A HREF="mycgi?foo=', urlencode ($userinput), '">'; +<![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 '<A HREF="mycgi?foo=', htmlentities (urlencode ($userinput) ), '">'; +<![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"> -<?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, &$sqldata)) { +$sqldata = array (serialize($session_data), $PHP_AUTH_USER); +if (!odbc_execute ($stmt, &$sqldata)) { $stmt = odbc_prepare($conn, "INSERT INTO sessions (id, data) VALUES(?, ?)"); if (!odbc_execute($stmt, &$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, &$sqldata) || !odbc_fetch_into($stmt, &$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, &$sqldata) || !odbc_fetch_into ($stmt, &$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(&$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"> -<pre> -<?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 +*/ ?> -</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>