cvs: phpdoc /ja/functions array.xml
| From: | Rui Hirokawa | Date: | Mon, 31 Dec 2001 01:09:52 +0000 |
| Subject: | cvs: phpdoc /ja/functions array.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969340543@lists.php.net to get a copy of this message | ||
hirokawa Sun Dec 30 20:09:52 2001 EDT
Modified files:
/phpdoc/ja/functions array.xml
Log:
translation updated.
Index: phpdoc/ja/functions/array.xml diff -u phpdoc/ja/functions/array.xml:1.36 phpdoc/ja/functions/array.xml:1.37 --- phpdoc/ja/functions/array.xml:1.36 Wed Dec 12 15:52:43 2001 +++ phpdoc/ja/functions/array.xml Sun Dec 30 20:09:52 2001 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.36 $ --> +<!-- $Revision: 1.37 $ --> <reference id="ref.array"> <title>é å颿°(array)</title> <titleabbrev>Arrays</titleabbrev> @@ -36,7 +36,9 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>array</function></funcdef> - <varargs/> + <paramdef>mixed + <parameter><optional>...</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> @@ -65,11 +67,13 @@ <example> <title><function>array</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $fruits = array ( "fruits" => array("a"=>"orange", "b"=>"banana", "c"=>"apple"), "numbers" => array(1, 2, 3, 4, 5, 6), "holes" => array("first", 5 => "second", "third") ); +]]> </programlisting> </example> </para> @@ -77,13 +81,15 @@ <example> <title><function>array</function> ã«ãããèªåã¤ã³ããã¯ã¹</title> <programlisting role="php"> +<![CDATA[ $array = array( 1, 1, 1, 1, 1, 8=>1, 4=>1, 19, 3=>13); print_r($array); +]]> </programlisting> - </example> - ãã®ä¾ã®åºåã¯æ¬¡ã®ããã«ãªãã¾ãã - <informalexample> - <programlisting> + <para> + ãã®ä¾ã®åºåã¯æ¬¡ã®ããã«ãªãã¾ãã + <screen role="php"> +<![CDATA[ Array ( [0] => 1 @@ -94,8 +100,10 @@ [8] => 1 [9] => 19 ) - </programlisting> - </informalexample> +]]> + </screen> + </para> + </example> ã¤ã³ããã¯ã¹ '3' ã¯äºåº¦å®ç¾©ããã¦ãããå¾ã®å¤ 13 ãä¿æããããã¨ ã«æ³¨æãã¦ä¸ãããã¤ã³ããã¯ã¹ 4 ã¯ã¤ã³ããã¯ã¹ 8 ã®å¾ã«å®ç¾©ããã æ¬¡ã«çæãããã¤ã³ããã¯ã¹(å¤ã¯19)ã¯ãæå¤§ã®ã¤ã³ããã¯ã¹ã 8 ã§ã @@ -106,27 +114,83 @@ <example> <title><function>array</function> ã§1ããå§ã¾ãé åã使</title> <programlisting role="php"> - $firstquarter = array(1 => 'January', 'February', 'March'); - print_r($firstquarter); +<![CDATA[ +$firstquarter = array(1 => 'January', 'February', 'March'); +print_r($firstquarter); +]]> </programlisting> - </example> - ãã®ä¾ã®åºåã¯æ¬¡ã®ããã«ãªãã¾ãã - <informalexample> - <programlisting> + <para> + ãã®ä¾ã®åºåã¯æ¬¡ã®ããã«ãªãã¾ãã + <screen> +<![CDATA[ Array ( - [1] => 'January' - [2] => 'February' - [3] => 'March' + [1] => 'January' + [2] => 'February' + [3] => 'March' ) - </programlisting> - </informalexample> +]]> + </screen> + </para> + </example> </para> <para> - <function>list</function>ãåç §ä¸ããã + <function>array_pad</function>, <function>list</function>, + <function>range</function>ãåç §ä¸ããã </para> </refsect1> </refentry> + + <refentry id="function.array-change-key-case"> + <refnamediv> + <refname>array_change_key_case</refname> + <refpurpose> + é åã®ãã¼ãå ¨ã¦å°æåã¾ãã¯å¤§æåã«ãã¦è¿ã + </refpurpose> + </refnamediv> + <refsect1> + <title>説æ</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>array_change_key_case</function></funcdef> + <paramdef>array <parameter>input</parameter></paramdef> + <paramdef>int + <parameter><optional>case</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>array_change_key_case</function> ã¯ãé å + <parameter>input</parameter>ã®ãã¼ãå ¨ã¦å°æåã¾ãã¯å¤§æåã«ãã¾ãã + 夿´ã¯ããªãã·ã§ã³ã®æå¾ã®ãã©ã¡ã¼ã¿<parameter>case</parameter>ã«ä¾å + ãã¾ããããã«ã¯ãäºã¤ã®å®æ°<constant>CASE_UPPER</constant>ããã³ + <constant>CASE_LOWER</constant>ãæå®å¯è½ã§ããããã©ã«ãã¯ã + <constant>CASE_LOWER</constant>ã§ãããã®é¢æ°ã¯æ°å¤æ·»åã¯ãã®ã¾ã¾ã« + ãã¾ãã + </para> + <example> + <title><function>array_change_key_case</function>ã®ä¾</title> + <programlisting role="php"> +<![CDATA[ +$input_array = array("FirSt" => 1, "SecOnd" => 4); +print_r(array_change_key_case($input_array, CASE_UPPER); +]]> + </programlisting> + <para> + ä¸ã®ããã°ã©ã ã®åºåã¯ä»¥ä¸ã®ããã«ãªãã¾ãã + <screen> +<![CDATA[ +Array +( + [FIRST] => 1 + [SECOND] => 2 +) +]]> + </screen> + </para> + </example> + </refsect1> + </refentry> <refentry id="function.array-chunk"> <refnamediv> @@ -158,18 +222,19 @@ å¯è½ã§ãã&false;ãæå®ããå ´åãè¿ãããåé åã§ã¯ã¼ãããå§ã¾ã æ°ããæ·»åã使ç¨ããã¾ããããã©ã«ãã¯ã&false;ã§ãã </para> - <para> - <example> - <title><function>array_chunk</function> ã®ä¾</title> - <programlisting role="php"> + <example> + <title><function>array_chunk</function> ã®ä¾</title> + <programlisting role="php"> +<![CDATA[ $input_array = array('a', 'b', 'c', 'd', 'e'); print_r(array_chunk($input_array, 2)); print_r(array_chunk($input_array, 2, TRUE)); - </programlisting> - </example> - ä¸ã®ããã°ã©ã ã®åºåã¯ä»¥ä¸ã®ããã«ãªãã¾ãã - <informalexample> - <programlisting> +]]> + </programlisting> + <para> + ä¸ã®ããã°ã©ã ã®åºåã¯ä»¥ä¸ã®ããã«ãªãã¾ãã + <screen> +<![CDATA[ Array ( [0] => Array @@ -210,9 +275,10 @@ ) ) - </programlisting> - </informalexample> - </para> +]]> + </screen> + </para> + </example> </refsect1> </refentry> @@ -239,15 +305,12 @@ <example> <title><function>array_count_values</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $array = array(1, "hello", 1, "world", "hello"); array_count_values($array); // array(1=>2, "hello"=>2, "world"=>1)ãè¿ãã¾ã +]]> </programlisting> </example> - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -265,9 +328,7 @@ <paramdef>array <parameter>array1</parameter></paramdef> <paramdef>array <parameter>array2</parameter></paramdef> <paramdef>array - <parameter> - <replaceable><optional> ...</optional></replaceable> - </parameter> + <parameter><optional> ...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -280,16 +341,33 @@ <example> <title><function>array_diff</function> ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $array1 = array ("a" => "green", "red", "blue"); $array2 = array ("b" => "green", "yellow", "red"); $result = array_diff ($array1, $array2); +]]> </programlisting> </example> </para> <para> ããã«ããã<varname>$result</varname> 㯠- <literal>array ("blue");</literal> ã¨ãªãã¾ãã + <literal>array ("blue");</literal> ã¨ãªãã¾ãã$array1ã«è¤æ°åå¨ + ããå ´åã§ãå ¨ã¦åæ§ã«å¦çããã¾ãã </para> + <note> + <simpara> + äºã¤ã®è¦ç´ ã¯ã<literal>(string) $elem1 === (string) $elem2</literal> + ã®å ´åã®ã¿çããã¨è¦ç´ããã¾ããè¨ãæããã¨ãæåå表ç¾ãåãå ´å㨠+ ãªãã¾ãã + <!-- TODO: example of it... --> + </simpara> + </note> + <warning> + <simpara> + ãã®é¢æ°ã¯ãPHP 4.0.4ã§ã¯åä½ãã¾ãã! + <!-- TODO: when exactly was this broken?... --> + </simpara> + </warning> <para> <function>array_intersect</function>ãåç §ä¸ããã </para> @@ -324,6 +402,7 @@ <example> <title><function>array_filter</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ function odd($var) { return ($var % 2 == 1); } @@ -332,11 +411,12 @@ return ($var % 2 == 0); } -$array1 = array ("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5); +$array1 = array ("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5); $array2 = array (6, 7, 8, 9, 10, 11, 12); $odd_arr = array_filter($array1, "odd"); $even_arr = array_filter($array2, "even"); +]]> </programlisting> </example> </para> @@ -346,6 +426,7 @@ ãã<varname>$even_arr</varname> 㯠<literal>array (6, 8, 10, 12);</literal>ã¨ãªãã¾ãã </para> + ¬e.func-callback; <para> <function>array_map</function>, <function>array_reduce</function>ãåç §ä¸ããã @@ -356,7 +437,7 @@ <refentry id="function.array-flip"> <refnamediv> <refname>array_flip</refname> - <refpurpose>é åã®å¤ãéé ã«ãã</refpurpose> + <refpurpose>é åã®å¤ãå転ã«ãã</refpurpose> </refnamediv> <refsect1> <title>説æ</title> @@ -367,21 +448,45 @@ </funcprototype> </funcsynopsis> <para> - <function>array_flip</function> ã¯ãé åãéé ã«ãã¦è¿ãã¾ãã + <function>array_flip</function> ã¯ãé åãå転ãã¦è¿ãã¾ãã + ããªãã¡ã<parameter>trans</parameter>ã®ãã¼ã¯å¤ã¨ãªãã + <parameter>trans</parameter>ã®å¤ã¯ãã¼ã¨ãªãã¾ãã + </para> + <para> + <parameter>trans</parameter>ã®å¤ã¯æå¹ãªãã¼ãå¿ è¦ã¨ãããã¨ã«æ³¨æã㦠+ ä¸ãããããªãã¡ããã¼ã¯ã<type>integer</type>ã¾ã㯠+ <type>string</type>ã§ããå¿ è¦ãããã¾ããããå¤ãééã£ãåã§ããå ´åã + è¦åãåºåãããåé¡ã®ãã®ãã¼/å¤ã®çµã¯éé ã«ããã¾ããã + </para> + <para> + ããå¤ãè¤æ°ååºç¾ããå ´åãæå¾ã®ãã¼ããã®å¤ã¨ãã¦ä½¿ç¨ããããã®ä»ã® + å¤ã¯å¤±ããã¾ãã + </para> + <para> + <function>array_flip</function>ã¯å¤±æããå ´åã«&false;ãè¿ãã¾ãã </para> <para> <example> <title><function>array_flip</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $trans = array_flip ($trans); $original = strtr ($str, $trans); +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title><function>array_flip</function>ã®ä¾ : è¡çª</title> + <programlisting role="php"> +<![CDATA[ +$trans = array ("a" => 1, "b" => 1, "c" => 2); +$trans = array_flip ($trans); +// ããã§$transã¯æ¬¡ã®ããã«ãªãã¾ã: array(1 => "b", 2 => "c"); +]]> </programlisting> </example> - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -412,6 +517,7 @@ <example> <title><function>array_fill</function> ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $a = array_fill(5, 6, 'banana'); /* @@ -424,6 +530,7 @@ $a[9] = "banana"; $a[10] = "banana"; */ +]]> </programlisting> </example> </para> @@ -443,9 +550,7 @@ <paramdef>array <parameter>array1</parameter></paramdef> <paramdef>array <parameter>array2</parameter></paramdef> <paramdef>array - <parameter> - <replaceable><optional> ...</optional></replaceable> - </parameter> + <parameter><optional> ...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -458,9 +563,11 @@ <example> <title><function>array_intersect</function> ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $array1 = array ("a" => "green", "red", "blue"); $array2 = array ("b" => "green", "yellow", "red"); $result = array_intersect ($array1, $array2); +]]> </programlisting> </example> </para> @@ -468,12 +575,73 @@ ããã«ããã<varname>$result</varname> 㯠<literal>array ("a" => "green", "red");</literal>ã¨ãªãã¾ãã </para> + <note> + <simpara> + äºã¤ã®è¦ç´ ã¯ã + <literal>(string) $elem1 === (string) $elem2</literal>ã®å ´åã®ã¿ + çããã¨ã¿ãªããã¾ããè¨ãæããã¨ãæåå表ç¾ãåãå ´åã¨ãªãã¾ãã + <!-- TODO: example of it... --> + </simpara> + </note> + <warning> + <simpara> + ãã®é¢æ°ã¯PHP 4.0.4ã§ã¯åä½ãã¾ãã! + <!-- TODO: when exactly was this broken?... --> + </simpara> + </warning> <para> <function>array_diff</function>ãåç §ä¸ããã </para> </refsect1> </refentry> + <refentry id="function.array-key-exists"> + <refnamediv> + <refname>array_key_exists</refname> + <refpurpose> + æå®ãããã¼ã¾ãã¯æ·»åãé åã«ãããã©ããã調ã¹ã + </refpurpose> + </refnamediv> + <refsect1> + <title>説æ</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>array_key_exists</function></funcdef> + <paramdef>mixed <parameter>key</parameter></paramdef> + <paramdef>array <parameter>search</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + æå®ãã<parameter>key</parameter>ãé åã«è¨å®ããã¦ããå ´åã + <function>array_key_exists</function>ã¯&true;ãè¿ãã¾ãã + <parameter>key</parameter>ã¯é åæ·»åã¨ãã¦ä½¿ç¨ã§ããå ¨ã¦ã® + å¤ã使ç¨å¯è½ã§ãã + </para> + <para> + <example> + <title><function>array_key_exists</function>ã®ä¾</title> + <programlisting role="php"> +<![CDATA[ +$search_array = array("first" => 1, "second" => 4); +if (array_key_exists("first", $search_array)) { + echo "The 'first' element is in the array"; +} +]]> + </programlisting> + </example> + </para> + <note> + <simpara> + ãã®é¢æ°ã®ååã¯ãPHPãã¼ã¸ã§ã³4.0.6ã§ã¯ + <function>key_exists</function>ã§ãã + </simpara> + </note> + <para> + <function>isset</function>ãåç §ä¸ããã + </para> + </refsect1> + </refentry> + <refentry id="function.array-keys"> <refnamediv> <refname>array_keys</refname> @@ -486,9 +654,7 @@ <funcdef>array <function>array_keys</function></funcdef> <paramdef>array <parameter>input</parameter></paramdef> <paramdef>mixed - <parameter> - <replaceable><optional>search_value</optional></replaceable> - </parameter> + <parameter><optional>search_value</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -505,6 +671,7 @@ <example> <title><function>array_keys</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $array = array(0 => 100, "color" => "red"); array_keys($array); // array(0, "color")ãè¿ãã¾ã @@ -513,6 +680,7 @@ $array = array ("color" => array("blue", "red", "green"), "size" => array("small", "medium", "large")); array_keys ($array); // é å("color", "size") ãè¿ãã¾ã +]]> </programlisting> </example> </para> @@ -525,15 +693,18 @@ PHP 3ã¦ã¼ã¶ç¨ã®<function>array_keys</function>ã®å®è£ </title> <programlisting role="php"> +<![CDATA[ function array_keys ($arr, $term="") { $t = array(); while (list($k,$v) = each($arr)) { - if ($term && $v != $term) + if ($term && $v != $term) { continue; $t[] = $k; } - return $t; + } + return $t; } +]]> </programlisting> </example> </para> @@ -547,7 +718,9 @@ <refentry id="function.array-map"> <refnamediv> <refname>array_map</refname> - <refpurpose>æå®ããé åã®è¦ç´ ã«ã³ã¼ã«ããã¯é¢æ°ãé©ç¨ãã</refpurpose> + <refpurpose> + æå®ããé åã®è¦ç´ ã«ã³ã¼ã«ããã¯é¢æ°ãé©ç¨ãã + </refpurpose> </refnamediv> <refsect1> <title>説æ</title> @@ -572,12 +745,14 @@ <example> <title><function>array_map</function> ã®ä¾</title> <programlisting role="php"> +<![CDATA[ function cube($n) { return $n*$n*$n; } $a = array(1, 2, 3, 4, 5); $b = array_map("cube", $a); +]]> </programlisting> </example> </para> @@ -589,6 +764,7 @@ <example> <title><function>array_map</function> - ããå¤ãã®é åã使ç¨</title> <programlisting role="php"> +<![CDATA[ function show_Spanish($n, $m) { return "The number $n is called $m in Spanish"; } @@ -647,6 +823,7 @@ // ) // // ) +]]> </programlisting> </example> </para> @@ -664,8 +841,9 @@ </para> <para> <example> - <title><function>array_map</function> - é åã®é åã使ãã</title> + <title>é åã®é åã使ãã</title> <programlisting role="php"> +<![CDATA[ $a = array(1, 2, 3, 4, 5); $b = array("one", "two", "three", "four", "five"); $c = array("uno", "dos", "tres", "cuatro", "cinco"); @@ -712,6 +890,7 @@ // ) // // ) +]]> </programlisting> </example> </para> @@ -734,10 +913,8 @@ <funcdef>array <function>array_merge</function></funcdef> <paramdef>array <parameter>array1</parameter></paramdef> <paramdef>array <parameter>array2</parameter></paramdef> - <paramdef> - <parameter> - <replaceable><optional> ...</optional></replaceable> - </parameter> + <paramdef>array + <parameter><optional> ...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -754,17 +931,19 @@ <example> <title><function>array_merge</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $array1 = array ("color" => "red", 2, 4); $array2 = array ("a", "b", "color" => "green", "shape" => "trapezoid", 4); -array_merge ($array1, $array2); +$result = array_merge ($array1, $array2); +]]> </programlisting> - <para> - è¿ãããé åã¯ãarray("color" => "green", 2, 4, "a", - "b", "shape" => "trapezoid", 4)ã¨ãªãã¾ãã - </para> </example> </para> <para> + è¿ãããé åã¯ã<literal>array("color" => "green", 2, 4, + "a", "b", "shape" => "trapezoid", 4)</literal>ã¨ãªãã¾ãã + </para> + <para> <function>array_merge_recursive</function>ãåç §ä¸ããã </para> </refsect1> @@ -782,10 +961,8 @@ <funcdef>array <function>array_merge_recursive</function></funcdef> <paramdef>array <parameter>array1</parameter></paramdef> <paramdef>array <parameter>array2</parameter></paramdef> - <paramdef> - <parameter> - <replaceable><optional> ...</optional></replaceable> - </parameter> + <paramdef>array + <parameter><optional> ...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -805,17 +982,20 @@ <example> <title><function>array_merge_recursive</function>ã®ä¾</title> <programlisting role="php"> -$ar1 = array("color" => array("favorite" => "red"), 5); -$ar2 = array(10, "color" => array("favorite" => "green", "blue")); -$result = array_merge_recursive($ar1, $ar2); +<![CDATA[ +$ar1 = array ("color" => array ("favorite" => "red"), 5); +$ar2 = array (10, "color" => array ("favorite" => "green", "blue")); +$result = array_merge_recursive ($ar1, $ar2); +]]> </programlisting> - <para> - è¿ãããé åã¯ãarray("color" => array("favorite" => - array("red", "green"), "blue"), 5, 10)ã¨ãªãã¾ãã - </para> </example> </para> <para> + è¿ãããé åã¯ã<literal>array ("color" => array + ("favorite" => array ("red", "green"), "blue"), 5, 10)</literal> + ã¨ãªãã¾ãã + </para> + <para> <function>array_merge</function>ãåç §ä¸ããã </para> </refsect1> @@ -833,14 +1013,13 @@ <funcdef>bool <function>array_multisort</function></funcdef> <paramdef>array <parameter>ar1</parameter></paramdef> <paramdef>mixed - <parameter> - <replaceable><optional>arg</optional></replaceable> - </parameter> + <parameter><optional>arg</optional></parameter> </paramdef> - <paramdef> - <parameter> - <replaceable><optional>...</optional></replaceable> - </parameter> + <paramdef>mixed + <parameter><optional>...</optional></parameter> + </paramdef> + <paramdef>array + <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -893,36 +1072,43 @@ ããã³SORT_REGULARã«ãªã»ãããã¾ãã </para> <para> - æåæã«&true;ã失æããå ´åã« - &false;ãè¿ãã¾ãã + æåæã«&true;ã失æããå ´åã«&false;ãè¿ãã¾ãã </para> - <example> - <title>è¤æ°ã®é åãã½ã¼ããã</title> - <programlisting role="php"> + <para> + <example> + <title>è¤æ°ã®é åãã½ã¼ããã</title> + <programlisting role="php"> +<![CDATA[ $ar1 = array ("10", 100, 100, "a"); $ar2 = array (1, 3, "2", 1); array_multisort ($ar1, $ar2); - </programlisting> - <para> - ãã®ä¾ã§ã¯ãã½ã¼ãã®å¾ã§ãæåã®é åã¯ã10,"a", 100, 100ã¨ãªãã¾ - ãã2çªç®ã®é åã¯ã1, 1, "2", 3ãæãã¾ããæåã®é å(100ããã³ - 100)ã®åãã¨ã³ããªã«å¯¾å¿ãã¦ãã2çªç®ã®é åã®ã¨ã³ããªã¯åæã«ã½ã¼ - ãããã¾ãã - </para> - </example> - - <example> - <title>夿¬¡å ã®é åãã½ã¼ããã</title> - <programlisting role="php"> -$ar = array(array("10", 100, 100, "a"), array(1, 3, "2", 1)); -array_multisort($ar[0], SORT_ASC, SORT_STRING, $ar[1], SORT_NUMERIC, SORT_DESC); - </programlisting> - <para> - ãã®ä¾ã§ã¯ãã½ã¼ããããå¾ãæåã®é åã¯10,100, 100, "a" (æåå - ã¨ãã¦æé ã£Â½ã¼ãããã¦ãã¾ã)ãæãã¦ããã2çªç®ã®é åã¯ã - 1, 3, "2", 1 (æ°å¤ã¨ãã¦éé ã«ã½ã¼ãããã¦ãã¾ã)ã¨ãªã£ã¦ãã¾ãã - </para> - </example> +]]> + </programlisting> + </example> + </para> + <para> + ãã®ä¾ã§ã¯ãã½ã¼ãã®å¾ã§ãæåã®é åã¯ã10,"a", 100, 100ã¨ãªãã¾ + ãã2çªç®ã®é åã¯ã1, 1, "2", 3ãæãã¾ããæåã®é å(100ããã³ + 100)ã®åãã¨ã³ããªã«å¯¾å¿ãã¦ãã2çªç®ã®é åã®ã¨ã³ããªã¯åæã«ã½ã¼ + ãããã¾ãã + </para> + <para> + <example> + <title>夿¬¡å ã®é åãã½ã¼ããã</title> + <programlisting role="php"> +<![CDATA[ +$ar = array (array ("10", 100, 100, "a"), array (1, 3, "2", 1)); +array_multisort ($ar[0], SORT_ASC, SORT_STRING, + $ar[1], SORT_NUMERIC, SORT_DESC); +]]> + </programlisting> + </example> + </para> + <para> + ãã®ä¾ã§ã¯ãã½ã¼ããããå¾ãæåã®é åã¯10,100, 100, "a" (æåå + ã¨ãã¦æé ã§ã½ã¼ãããã¦ãã¾ã)ãæãã¦ããã2çªç®ã®é åã¯ã + 1, 3, "2", 1 (æ°å¤ã¨ãã¦éé ã«ã½ã¼ãããã¦ãã¾ã)ã¨ãªã£ã¦ãã¾ãã + </para> </refsect1> </refentry> @@ -955,6 +1141,7 @@ <example> <title><function>array_pad</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $input = array (12, 10, 9); $result = array_pad ($input, 5, 0); @@ -965,6 +1152,7 @@ $result = array_pad ($input, 2, "noop"); // åããå¦çã¯è¡ããã¾ããã +]]> </programlisting> </example> </para> @@ -990,27 +1178,23 @@ ã¯ãè¦ç´ ä¸ã¤åçããªãã¾ãã<parameter>array</parameter> ã空ã®å ´ åã(ã¾ãã¯ãé åã§ãªãå ´åã)&null;ãè¿ããã¾ãã </para> - <para> - <example> - <title><function>array_pop</function>ã®ä¾</title> - <programlisting role="php"> + <example> + <title><function>array_pop</function>ã®ä¾</title> + <programlisting role="php"> +<![CDATA[ $stack = array ("orange", "apple", "raspberry"); $fruit = array_pop ($stack); - </programlisting> - <para> - ããã«ããã$stackã®è¦ç´ ã¯äºã¤("orange"ããã³ "apple")ã ãã¨ãªãã - $fruit ã¯"raspberry"ã¨ãªãã¾ãã - </para> - </example> +]]> + </programlisting> + </example> + <para> + ããã«ããã<varname>$stack</varname>è¦ç´ ã¯äºã¤("orange"ããã³ + "apple")ã ãã¨ãªãã<varname>$fruit</varname>ã¯"raspberry"ã¨ãªãã¾ãã </para> + &return.falseproblem; <para> <function>array_push</function>,<function>array_shift</function>, <function>array_unshift</function>ãåç §ä¸ããã - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -1027,10 +1211,8 @@ <funcdef>int <function>array_push</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>mixed <parameter>var</parameter></paramdef> - <paramdef> - <parameter> - <replaceable><optional>...</optional></replaceable> - </parameter> + <paramdef>mixed + <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -1041,8 +1223,11 @@ <parameter>array</parameter>ã®é·ãã¯æ¸¡ããã夿°ã®æ°ã ãå¢å ãã¾ãã å<parameter>var</parameter>æ¯ã«ä»¥ä¸ãç¹°ãè¿ããã¨ã¨åã广ãããã¾ãã <programlisting role="php"> +<![CDATA[ $array[] = $var; +]]> </programlisting> + å<parameter>var</parameter>ã§ç¹°ãè¿ããã¾ãã </para> <para> å¦çå¾ã®é åã®ä¸ã®è¦ç´ ã®æ°ãè¿ãã¾ãã @@ -1051,20 +1236,20 @@ <example> <title><function>array_push</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $stack = array (1, 2); -array_push($stack, "+", 3); +array_push ($stack, "+", 3); +]]> </programlisting> </example> - ãã®ä¾ã®çµæã$stackã«ã¯ã4ã¤ã®è¦ç´ 1,2,"+",3ããããã¨ã«ãªãã¾ãã + </para> + <para> + ãã®ä¾ã®çµæã<varname>$stack</varname>ã«ã¯ã4ã¤ã®è¦ç´ 1,2,"+", + 3ããããã¨ã«ãªãã¾ãã </para> <para> <function>array_pop</function>,<function>array_shift</function>, <function>array_unshift</function>ãåç §ä¸ããã - <note> - <para> - ãã®é¢æ°ã¯ã PHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -1081,9 +1266,7 @@ <funcdef>mixed <function>array_rand</function></funcdef> <paramdef>array <parameter>input</parameter></paramdef> <paramdef>int - <parameter> - <replaceable><optional>num_req</optional></replaceable> - </parameter> + <parameter><optional>num_req</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -1109,11 +1292,13 @@ <example> <title><function>array_rand</function>ã®ä¾</title> <programlisting role="php"> -srand((double)microtime() * 10000000); -$input = array("Neo", "Morpheus", "Trinity", "Cypher", "Tank"); -$rand_keys = array_rand($input, 2); +<![CDATA[ +srand ((float) microtime() * 10000000); +$input = array ("Neo", "Morpheus", "Trinity", "Cypher", "Tank"); +$rand_keys = array_rand ($input, 2); print $input[$rand_keys[0]]."\n"; print $input[$rand_keys[1]]."\n"; +]]> </programlisting> </example> </para> @@ -1146,20 +1331,24 @@ <example> <title><function>array_reverse</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $input = array ("php", 4.0, array ("green", "red")); $result = array_reverse ($input); $result_keyed = array_reverse ($input, TRUE); +]]> </programlisting> </example> + </para> + <para> ãã®ä¾ã«ããã¦ã<varname>$result</varname>ã¯ã<literal>array (array ("green", "red"), 4.0, "php")</literal>ã¨ãªãã¾ãããããã <varname>$result2[0]</varname>ã¯ã¾ã <literal>"php"</literal>ã§ãã - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ãã¼ã¿3ã§è¿½å ããã¾ããã - </para> - </note> </para> + <note> + <para> + 2çªç®ã®ãã©ã¡ã¼ã¿ã¯ãPHP 4.0.3ã§è¿½å ããã¾ããã + </para> + </note> </refsect1> </refentry> @@ -1184,17 +1373,17 @@ </funcprototype> </funcsynopsis> <para> - <function>array_reduce</function> applies iteratively the - <parameter>callback</parameter> function to the elements of the - array <parameter>input</parameter>, so as to reduce the array to - a single value. If the optional <parameter>intial</parameter> is - avaliable, it will be used at the beginning of the process, or as - a final result in case the array is empty. + <function>array_reduce</function>ã¯ãé å<parameter>input</parameter> + ã®åè¦ç´ ã«<parameter>callback</parameter>颿°ãç¹°ãè¿ãé©ç¨ãã + é åãä¸ã¤ã®å¤ã«æ¸ããã¾ãããªãã·ã§ã³<parameter>intial</parameter> + ãå©ç¨å¯è½ãªå ´åãå¦çã®æåã§ä½¿ç¨ãããããé åã空ã®å ´åã®æçµçµæ + ã¨ãã¦ä½¿ç¨ããã¾ãã </para> <para> <example> - <title><function>array_reduce</function> example</title> + <title><function>array_reduce</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ function rsum($v, $w) { $v += $w; return $v; @@ -1210,18 +1399,19 @@ $b = array_reduce($a, "rsum"); $c = array_reduce($a, "rmul", 10); $d = array_reduce($x, "rsum", 1); +]]> </programlisting> </example> </para> <para> - This will result in <varname>$b</varname> containing - <literal>15</literal>, <varname>$c</varname> containing - <literal>1200</literal> (= 1*2*3*4*5*10), and - <varname>$d</varname> containing <literal>1</literal>. + ããã«ããã<varname>$b</varname>ã®å¤ã¯<literal>15</literal> + ã¨ãªãã<varname>$c</varname>ã®å¤ã¯ + <literal>1200</literal> (= 1*2*3*4*5*10)ãããã¦ã + <varname>$d</varname>ã®å¤ã¯<literal>1</literal>ã¨ãªãã¾ãã </para> <para> - See also <function>array_filter</function>, - <function>array_map</function>. + <function>array_filter</function>, + <function>array_map</function>ãåç §ä¸ããã </para> </refsect1> </refentry> @@ -1250,22 +1440,19 @@ <example> <title><function>array_shift</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $args = array ("-v", "-f"); $opt = array_shift ($args); +]]> </programlisting> </example> - ããã«ããã$argsã«ã¯ä¸ã¤ã®è¦ç´ "-f"ãæ®ãã$opt㯠- "-v"ã¨ãªãã¾ãã + ããã«ããã<varname>$args</varname>ã«ã¯ä¸ã¤ã®è¦ç´ "-f"ãæ®ãã + <varname>$opt</varname>ã¯"-v"ã¨ãªãã¾ãã </para> <para> <function>array_unshift</function>, <function>array_push</function>, <function>array_pop</function>ãåç §ä¸ããã - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -1283,9 +1470,7 @@ <paramdef>array <parameter>array</parameter></paramdef> <paramdef>int <parameter>offset</parameter></paramdef> <paramdef>int - <parameter> - <replaceable><optional>length</optional></replaceable> - </parameter> + <parameter><optional>length</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -1311,22 +1496,19 @@ <example> <title><function>array_slice</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $input = array ("a", "b", "c", "d", "e"); $output = array_slice ($input, 2); // "c", "d", "e"ãè¿ãã¾ã $output = array_slice ($input, 2, -1); // "c", "d"ãè¿ãã¾ã $output = array_slice ($input, -2, 1); // "d"ãè¿ãã¾ã $output = array_slice ($input, 0, 3); // "a", "b", "c"ãè¿ãã¾ã +]]> </programlisting> </example> </para> <para> <function>array_splice</function>ãåç §ä¸ããã - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -1344,14 +1526,10 @@ <paramdef>array <parameter>input</parameter></paramdef> <paramdef>int <parameter>offset</parameter></paramdef> <paramdef>int - <parameter> - <replaceable><optional>length</optional></replaceable> - </parameter> + <parameter><optional>length</optional></parameter> </paramdef> <paramdef>array - <parameter> - <replaceable><optional>replacement</optional></replaceable> - </parameter> + <parameter><optional>replacement</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -1392,11 +1570,13 @@ <para> 以ä¸ã¯ç価ã¨ãªãã¾ãã <programlisting role="php"> +<![CDATA[ array_push($input, $x, $y) array_splice($input, count($input), 0, array($x, $y)) array_pop($input) array_splice($input, -1) array_shift($input) array_splice($input, 0, 1) array_unshift($input, $x, $y) array_splice($input, 0, 0, array($x, $y)) $a[$x] = $y array_splice($input, $x, 1, $y) +]]> </programlisting> </para> <para> @@ -1406,25 +1586,29 @@ <example> <title><function>array_splice</function>ã®ä¾</title> <programlisting role="php"> -$input = array("red", "green", "blue", "yellow"); - -array_splice($input, 2); // $input ã¯ãarray("red", "green") ã¨ãªãã¾ãã -array_splice($input, 1, -1); // $input ã¯ãarray("red", "yellow") ã¨ãªãã¾ãã -array_splice($input, 1, count($input), "orange"); - // $input ã¯ãarray("red", "orange") ã¨ãªãã¾ãã -array_splice($input, -1, 1, array("black", "maroon")); - // $input ã¯ãarray("red", "green", - // "blue", "black", "maroon") ã¨ãªãã¾ãã +<![CDATA[ +$input = array ("red", "green", "blue", "yellow"); +array_splice ($input, 2); +// $input is now array ("red", "green") + +$input = array ("red", "green", "blue", "yellow"); +array_splice ($input, 1, -1); +// $input is now array ("red", "yellow") + +$input = array ("red", "green", "blue", "yellow"); +array_splice ($input, 1, count($input), "orange"); +// $input is now array ("red", "orange") + +$input = array ("red", "green", "blue", "yellow"); +array_splice ($input, -1, 1, array("black", "maroon")); +// $input is now array ("red", "green", +// "blue", "black", "maroon") +]]> </programlisting> </example> </para> <para> <function>array_slice</function>ãåç §ä¸ããã - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -1452,6 +1636,7 @@ <example> <title><function>array_sum</function> ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $a = array(2,4,6,8); echo "sum(a) = ".array_sum($a)."\n"; // åºå: sum(a) = 20 @@ -1459,9 +1644,16 @@ $b = array("a"=>1.2,"b"=>2.3,"c"=>3.4); echo "sum(b) = ".array_sum($b)."\n"; // åºå: sum(b) = 6.9 +]]> </programlisting> </example> </para> + <note> + <para> + 4.0.6ããåã®ãã¼ã¸ã§ã³ã®PHPã¯ã渡ãããé åèªä½ãä¿®æ£ããæååã + æ°å¤(ããã¯å¤ã«ããããå¤ãã®å ´åã¼ãã¨ãªãã¾ã)ã«å¤æãã¦ãã¾ããã + </para> + </note> </refsect1> </refentry> @@ -1481,21 +1673,69 @@ <para> <function>array_unique</function> ã¯ã <parameter>array</parameter>ãå ¥åã¨ããå¤ã«éè¤ã®ãªãæ°è¦é åã - è¿ãã¾ãããã¼ã¯ä¿æããããã¨ã«æ³¨æãã¦ä¸ããã + è¿ãã¾ãã + </para> + <para> + ãã¼ã¯ä¿æããããã¨ã«æ³¨æãã¦ä¸ããã + <function>array_unique</function>ã¯åå¤ã«é¢ããæåã®ãã¼ãä¿æãã + æ®ãã®ãã¼ãå ¨ã¦ç¡è¦ãã¾ãã </para> + <note> + <simpara> + <literal>(string) $elem1 === (string) $elem2</literal>ã®å ´åã®ã¿ + äºã¤ã®è¦ç´ ã¯çããã¨ã¿ãªããã¾ããè¨ãæããã¨ãæåå表ç¾ã + åãå ´åã¨ãªãã¾ãã + <!-- TODO: example of it... --> + </simpara> + <simpara> + æåã®è¦ç´ ã使ç¨ããã¾ãã + </simpara> + </note> + <warning> + <simpara> + ãã®é¢æ°ã¯ãPHP 4.0.4ã§ã¯ä½¿ç¨ã§ãã¾ãã! + <!-- TODO: when exactly was this broken?... --> + </simpara> + </warning> <para> <example> <title><function>array_unique</function> ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $input = array ("a" => "green", "red", "b" => "green", "blue", "red"); $result = array_unique ($input); +print_r($result); +// åºåã¯æ¬¡ã®ããã«ãªãã¾ã : +//Array +//( +// [a] => green +// [0] => red +// [1] => blue +//) +]]> </programlisting> </example> </para> <para> - ãã®ä¾ã«ããã<varname>$result</varname> ã¯ã - <literal>array ("a" =>"green", "red", "blue");</literal>ãæãã - ãã¨ã«ãªãã¾ãã + <example> + <title><function>array_unique</function>ã¨å</title> + <programlisting role="php"> +<![CDATA[ +$input = array (4,"4","3",4,3,"3"); +$result = array_unique ($input); +var_dump($result); + +/* åºå: +array(2) { + [0]=> + int(4) + [1]=> + string(1) "3" +} +*/ +]]> + </programlisting> + </example> </para> </refsect1> </refentry> @@ -1503,7 +1743,7 @@ <refentry id="function.array-unshift"> <refnamediv> <refname>array_unshift</refname> - <refpurpose> ä¸ã¤ä»¥ä¸ã®è¦ç´ ã é åã® æåã«å ãã </refpurpose> + <refpurpose> ä¸ã¤ä»¥ä¸ã®è¦ç´ ãé åã®æåã«å ãã </refpurpose> </refnamediv> <refsect1> <title>説æ</title> @@ -1512,10 +1752,8 @@ <funcdef>int <function>array_unshift</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>mixed <parameter>var</parameter></paramdef> - <paramdef> - <parameter> - <replaceable><optional>...</optional></replaceable> - </parameter> + <paramdef>mixed + <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -1531,22 +1769,19 @@ <example> <title><function>array_unshift</function>ã®ä¾</title> <programlisting role="php"> -$queue = array("p1", "p3"); -array_unshift($queue, "p4", "p5", "p6"); +<![CDATA[ +$queue = array ("p1", "p3"); +array_unshift ($queue, "p4", "p5", "p6"); +]]> </programlisting> </example> - ãã®ä¾ã«ããã$queue ã®è¦ç´ ã¯æ¬¡ã®5ã¤ã¨ãªãã¾ãã: "p4", "p5", "p6", - "p1", "p3" + ãã®ä¾ã«ããã<varname>$queue</varname>ã®è¦ç´ ã¯æ¬¡ã®5ã¤ã¨ãªãã¾ãã + : "p4", "p5", "p6", "p1", "p3" </para> <para> <function>array_shift</function>, <function>array_push</function>, <function>array_pop</function>ãåç §ä¸ããã - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -1572,15 +1807,37 @@ <example> <title><function>array_values</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $array = array("size" => "XL", "color" => "gold"); array_values($array); // array("XL", "gold")ãè¿ãã¾ã +]]> </programlisting> </example> - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> + </para> + <note> + <para> + ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã以ä¸ã®å®è£ ã¯PHP 3ã§ã + 使ç¨ãããã¨ãå¯è½ã§ãã + <example> + <title> + PHP 3ã¦ã¼ã¶ç¨ã®<function>array_values</function>ã®å®è£ + </title> + <programlisting role="php"> +<![CDATA[ +function array_values ($arr) { + $t = array(); + while (list($k, $v) = each ($arr)) { + $t[] = $v; + } + return $t; +} +]]> + </programlisting> + </example> + </para> + </note> + <para> + <function>array_keys</function>ãåç §ä¸ããã </para> </refsect1> </refentry> @@ -1599,22 +1856,31 @@ <funcdef>int <function>array_walk</function></funcdef> <paramdef>array <parameter>arr</parameter></paramdef> <paramdef>string <parameter>func</parameter></paramdef> - <paramdef>mixed <parameter>userdata</parameter></paramdef> + <paramdef>mixed + <parameter><optional>userdata</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <simpara> <parameter>arr</parameter>ã®åè¦ç´ ã«<parameter>func</parameter> - ã¨ããååã®é¢æ°ãé©ç¨ãã¾ãã + ã¨ããååã®ã¦ã¼ã¶å®ç¾©é¢æ°ãé©ç¨ãã¾ãã <parameter>func</parameter>ã«ã¯ãé åã®å¤ãæåã®å¼æ°ã¨ã㦠渡ãããé åã®ãã¼ã2çªç®ã®ãã©ã¡ã¼ã¿ã¨ãã¦æ¸¡ããã¾ãã <parameter>userdata</parameter>ãæå®ãããå ´åã3çªç®ã®å¼æ°ã¨ã㦠- ã¦ã¼ã¶ã¼é¢æ°ã«æ¸¡ããã¾ãã + ã¦ã¼ã¶ã¼é¢æ°ã«æ¸¡ããã¾ãã<parameter>func</parameter>ã¯ã¦ã¼ã¶å®ç¾©ã® + 颿°ã§ããå¿ è¦ãããããã¼ãã£ããªPHP颿°ã¯ä½¿ç¨ã§ãã¾ããã + ã¤ã¾ãã<function>array_walk</function>ãç´æ¥ + <function>str2lower</function>ã¨çµã¿åããããã¨ã¦ä½¿ç¨ãããã¨ã¯ + ã§ãã¾ãããã¾ãããã®é¢æ°ãç¨ãã¦ã¦ã¼ã¶å®ç¾©é¢æ°ãæ§ç¯ãããã®é¢æ° + ã弿°ã¨ãã¦æ¸¡ãå¿ è¦ãããã¾ãã + </simpara> + ¬e.func-callback; + <simpara> <parameter>func</parameter>ã2ã¤ã¾ãã¯3ã¤ãè¶ ãã弿°ãå¿ è¦ã¨ããå ´åã <parameter>userdata</parameter>ã®æå®ã«ãã£ã¦ã¯ã <function>array_walk</function>ã<parameter>func</parameter> - ãã³ã¼ã«ãã度ã«è¦åãçæããã¾ãã - ãããã®è¦åã¯ã<function>array_walk</function>ã®åã« - '@'ãã¼ã¯ãä»ããã + ãã³ã¼ã«ãã度ã«è¦åãçæããã¾ãããããã®è¦åã¯ã + <function>array_walk</function>ã®åã«'@'ãã¼ã¯ãä»ããã <function>error_reporting</function>ã使ç¨ãããã¨ã«ãã æå¶ããã¾ãã </simpara> @@ -1625,11 +1891,15 @@ 渡ãå¿ è¦ãããã¾ãããã®å ´åãé åã®è¦ç´ ã«å ãã夿´ã¯ãé åèªä½ ã«å¯¾ãã¦è¡ããã¾ãã </para> + <para> + <parameter>func</parameter>ã®ä¸ããé åãä¿®æ£ããã¨äºæ¸¬ã§ããªã + åä½ãå¼ãèµ·ããå¯è½æ§ãããã¾ãã + </para> </note> <note> <para> ãã¼åã³userdataã<parameter>func</parameter>ã«æ¸¡ãå¦çã¯ã - ãã¼ã¸ã§ã³ 4.0ã§è¿½å ããã¾ããã + ãã¼ã¸ã§ã³4.0ã§è¿½å ããã¾ããã </para> <para> PHP 4ã§ã¯ã<function>array_walk</function>ã§é åã®ãªã»ãããããã© @@ -1641,14 +1911,15 @@ <example> <title><function>array_walk</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); - -function test_alter (&$item1, $key, $prefix) { - $item1 = "$prefix: $item1"; + +function test_alter (&$item1, $key, $prefix) { + $item1 = "$prefix: $item1"; } function test_print ($item2, $key) { - echo "$key. $item2<br>\n"; + echo "$key. $item2<br>\n"; } array_walk ($fruits, 'test_print'); @@ -1656,6 +1927,7 @@ array_walk ($fruits, 'test_alter', 'fruit'); reset ($fruits); array_walk ($fruits, 'test_print'); +]]> </programlisting> </example> </para> @@ -1670,7 +1942,7 @@ <refnamediv> <refname>arsort</refname> <refpurpose> - 飿³ãã¼ã¨è¦ç´ ã¨ã®é¢ä¿ãç¶æãã¤ã¤é åãéé ã«ã½ã¼ããã¾ã + 飿³ãã¼ã¨è¦ç´ ã¨ã®é¢ä¿ãç¶æãã¤ã¤é åãéé ã«ã½ã¼ããã </refpurpose> </refnamediv> <refsect1> @@ -1680,9 +1952,7 @@ <funcdef>void <function>arsort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>int - <parameter> - <replaceable><optional>sort_flags</optional></replaceable> - </parameter> + <parameter><optional>sort_flags</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -1690,24 +1960,32 @@ ãã®é¢æ°ã¯ã飿³é åã«ããã¦åé åã®ãã¼ã¨è¦ç´ ã¨ã®é¢ä¿ãç¶æã㤠ã¤ã½ã¼ããè¡ãã¾ãããã®é¢æ°ã¯ã主ã«å®éã®è¦ç´ ã®ä¸¦ã³æ¹ãéè¦ã§ã ã飿³é åãã½ã¼ãããããã«ä½¿ããã¾ãã - <example> - <title><function>arsort</function>ã®ä¾</title> - <programlisting role="php"> + </para> + <example> + <title><function>arsort</function>ã®ä¾</title> + <programlisting role="php"> +<![CDATA[ $fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); arsort ($fruits); -reset($fruits); -while(list($key,$val)=each($fruits)) { +reset ($fruits); +while (list ($key, $val) = each ($fruits)) { echo "$key = $val\n"; } - </programlisting> - </example> - ãã®ä¾ã¯ã以ä¸ã®ããã«åºåããã¾ãã - <computeroutput> -fruits[a] = orange -fruits[d] = lemon -fruits[b] = banana -fruits[c] = apple - </computeroutput> +]]> + </programlisting> + <para> + ãã®ä¾ã¯ã以ä¸ã®ããã«åºåããã¾ãã + <screen> +<![CDATA[ +a = orange +d = lemon +b = banana +c = apple +]]> + </screen> + </para> + </example> + <para> fruitsã¯ã¢ã«ãã¡ãããã®éé ã«ã½ã¼ããããåè¦ç´ ã¨ãã¼ã¨ã®é¢ä¿ã¯ ç¶æããã¾ãã </para> @@ -1727,7 +2005,9 @@ <refentry id="function.asort"> <refnamediv> <refname>asort</refname> - <refpurpose>飿³ãã¼ã¨è¦ç´ ã¨ã®é¢ä¿ãç¶æãã¤ã¤é åãã½ã¼ããã¾ã</refpurpose> + <refpurpose> + 飿³ãã¼ã¨è¦ç´ ã¨ã®é¢ä¿ãç¶æãã¤ã¤é åãã½ã¼ããã + </refpurpose> </refnamediv> <refsect1> <title>説æ</title> @@ -1736,9 +2016,7 @@ <funcdef>void <function>asort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>int - <parameter> - <replaceable><optional>sort_flags</optional></replaceable> - </parameter> + <parameter><optional>sort_flags</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -1746,24 +2024,32 @@ ãã®é¢æ°ã¯ã飿³é åã«ããã¦åé åã®ãã¼ã¨è¦ç´ ã¨ã®é¢ä¿ãç¶æã㤠ã¤é åãã½ã¼ããã¾ãããã®é¢æ°ã¯ã主ã«å®éã®è¦ç´ ã®ä¸¦ã³æ¹ãéè¦ã§ ãã飿³é åãã½ã¼ãããããã«ä½¿ããã¾ãã - <example> - <title><function>asort</function>ã®ä¾</title> - <programlisting role="php"> + </para> + <example> + <title><function>asort</function>ã®ä¾</title> + <programlisting role="php"> +<![CDATA[ $fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); asort ($fruits); -reset($fruits); -while(list($key,$val)=each($fruits)) { - echo "$key = $val\n"; +reset ($fruits); +while (list ($key, $val) = each ($fruits)) { + echo "$key = $val\n"; } - </programlisting> - </example> - ãã®ä¾ã¯ã以ä¸ã®ããã«åºåããã¾ãã - <computeroutput> -fruits[c] = apple -fruits[b] = banana -fruits[d] = lemon -fruits[a] = orange - </computeroutput> +]]> + </programlisting> + <para> + ãã®ä¾ã¯ã以ä¸ã®ããã«åºåããã¾ãã + <screen> +<![CDATA[ +c = apple +b = banana +d = lemon +a = orange +]]> + </screen> + </para> + </example> + <para> fruitsã¯ã¢ã«ãã¡ãããã®æé ã«ã½ã¼ããããåè¦ç´ ã¨ãã¼ã¨ã®é¢ä¿ã¯ ç¶æããã¾ãã </para> @@ -1791,12 +2077,9 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>compact</function></funcdef> - <paramdef><parameter>string varname | array - varnames</parameter></paramdef> - <paramdef> - <parameter> - <replaceable><optional>...</optional></replaceable> - </parameter> + <paramdef>mixed <parameter>varname</parameter></paramdef> + <paramdef>mixed + <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -1820,6 +2103,7 @@ <example> <title><function>compact</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $city = "San Francisco"; $state = "CA"; $event = "SIGGRAPH"; @@ -1827,20 +2111,18 @@ $location_vars = array ("city", "state"); $result = compact ("event", "nothing_here", $location_vars); +]]> </programlisting> <para> - ãã®ä¾ã«ããã$resultã¯ãarray("event" => "SIGGRAPH", "city" - => "San Francisco", "state" => "CA")ã¨ãªãã¾ãã + ãã®ä¾ã«ããã<varname>$result</varname>ã¯ã + <literal>array + ("event" => "SIGGRAPH", "city" => "San Francisco", + "state" => "CA")</literal>ã¨ãªãã¾ãã </para> </example> </para> <para> <function>extract</function>ãåç §ä¸ããã - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -1864,43 +2146,52 @@ ããã¾ããããï¼ã </para> <para> - 夿°ãé åã§ãªãå ´åã¯1ãè¿ãã¾ãã + 夿°ãé åã§ãªãå ´åã¯<literal>1</literal>ãè¿ãã¾ãã + (ä¾å¤: <literal>count(&null;)</literal> ã¯<literal>0</literal>ã¨ç価) </para> + <warning> + <para> + <function>count</function>ã¯ãã»ããããã¦ããªã夿°ã«é¢ãã¦0ãè¿ + ãã¾ããã夿°ã空ã®é åã¨ãã¦åæåããã¦ããå ´åã«ã0ãè¿ãã¾ãã + ãã夿°ãã»ããããã¦ãããã©ããã調ã¹ãã«ã¯ã + <function>isset</function>ã使ç¨ãã¦ãã ããã + </para> + </warning> <para> - 夿°ãã»ããããã¦ããªãå ´åã¯0ãè¿ãã¾ãã - <warning> - <para> - <function>count</function>ã¯ãã»ããããã¦ããªã夿°ã«é¢ãã¦0ãè¿ - ãã¾ããã夿°ã空ã®é åã¨ãã¦åæåããã¦ããå ´åã«ã0ãè¿ãã¾ãã - ãã夿°ãã»ããããã¦ãããã©ããã調ã¹ãã«ã¯ã - <function>isset</function>ã使ç¨ãã¦ãã ããã - </para> - </warning> + é åã®å®è£ ãPHPã§ã®ä½¿ç¨æ³ã«é¢ãã詳細ãªèª¬æã«ã¤ãã¦ã¯ããã¥ã¢ã«ã® + <link linkend="language.types.array">é å</link>ã®ã»ã¯ã·ã§ã³ã + åç §ä¸ããã </para> <para> <example> <title><function>count</function> ã®ä¾</title> <programlisting role="php"> + <!-- TODO: examples about count(null), count(false), count(object).. --> +<![CDATA[ $a[0] = 1; $a[1] = 3; $a[2] = 5; $result = count ($a); -// ä»£å ¥ãããè¦ç´ ã¯3ã§ããã$result 㯠2ã§ã¯ãªã3ã¨ãªã +// $result == 3 -$a[2] = 1; -$a[4] = ""; -$a[6] = 5; -$a[8] = 7; -$a[10] = 11; -$a[12] = ""; -$result = count ($a); -// ä»£å ¥ãããè¦ç´ ã¯4ã¤ãªã®ã§ã$result == 4 ã§ãã +$b[0] = 7; +$b[5] = 9; +$b[10] = 11; +$result = count ($b); +// $result == 3; +]]> </programlisting> </example> </para> + <note> + <para> + <function>sizeof</function>颿°ã¯ã<function>count</function> + ã¸ã®ã¨ã¤ãªã¢ã¹ã§ãã + </para> + </note> <para> - <function>sizeof</function>, <function>isset</function>, - <function>is_array</function>ãåç §ä¸ããã + <function>is_array</function>, <function>isset</function>, + <function>strlen</function>ãåç §ä¸ããã </para> </refsect1> </refentry> @@ -1908,7 +2199,7 @@ <refentry id="function.current"> <refnamediv> <refname>current</refname> - <refpurpose>é åå ã®ç¾å¨ã®è¦ç´ ãè¿ã</refpurpose> + <refpurpose>é åå ã®ã«ã¬ã³ãã®è¦ç´ ãè¿ã</refpurpose> </refnamediv> <refsect1> <title>説æ</title> @@ -1919,7 +2210,7 @@ </funcprototype> </funcsynopsis> <para> - åé åã¯ã"ç¾å¨"ã®è¦ç´ ã¸ã®ãã¤ã³ã¿ãæãã¦ãã¾ãã + åé åã¯ã"ã«ã¬ã³ã"ã®è¦ç´ ã¸ã®ãã¤ã³ã¿ãæãã¦ãã¾ãã ãã®ãã¤ã³ã¿ã¯ããã®é åã®æåã®è¦ç´ ãæãããã«åæåããã¾ãã </para> <para> @@ -1960,7 +2251,7 @@ </funcprototype> </funcsynopsis> <para> - é å<parameter>array</parameter>ãããæ¬¡ã®ãã£hå¤ã®ãã¢ãè¿ãã + é å<parameter>array</parameter>ãããæ¬¡ã®ãã¼ã¨å¤ã®ãã¢ãè¿ãã é åã«ã¼ã½ã«ãé²ãã¾ãããã®ãã¢ã¯ã4ã¤ã®è¦ç´ ãæã¤é åã§ã ããããã®è¦ç´ ã¯<emphasis>0</emphasis>,<emphasis>1</emphasis>, <emphasis>key</emphasis>,<emphasis>value</emphasis>ã¨ãããã¼ãæ @@ -1976,32 +2267,35 @@ <example> <title><function>each</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese"); -$bar = each( $foo ); +$bar = each ($foo); +]]> </programlisting> <para> <literal>$bar</literal>ã¯ãããã§ã¯ä»¥ä¸ã®ãã¼/å¤ã®ãã¢ãä¿æã ã¦ãã¾ãã <itemizedlist spacing="compact"> - <listitem><simpara>0 => 0</simpara></listitem> - <listitem><simpara>1 => 'bob'</simpara></listitem> - <listitem><simpara>key => 0</simpara></listitem> - <listitem><simpara>value => 'bob'</simpara></listitem> + <listitem><simpara>0 => 0</simpara></listitem> + <listitem><simpara>1 => 'bob'</simpara></listitem> + <listitem><simpara>key => 0</simpara></listitem> + <listitem><simpara>value => 'bob'</simpara></listitem> </itemizedlist> - <programlisting role="php"> +<![CDATA[ $foo = array ("Robert" => "Bob", "Seppo" => "Sepi"); $bar = each ($foo); +]]> </programlisting> </para> <para> <literal>$bar</literal>ã¯ããã®æç¹ã§ä»¥ä¸ã®ãã¼/å¤ã®ãã¢ãä¿æ ãã¦ãã¾ãã <itemizedlist spacing="compact"> - <listitem><simpara>0 => 'Robert'</simpara></listitem> - <listitem><simpara>1 => 'Bob'</simpara></listitem> - <listitem><simpara>key => 'Robert'</simpara></listitem> - <listitem><simpara>value => 'Bob'</simpara></listitem> + <listitem><simpara>0 => 'Robert'</simpara></listitem> + <listitem><simpara>1 => 'Bob'</simpara></listitem> + <listitem><simpara>key => 'Robert'</simpara></listitem> + <listitem><simpara>value => 'Bob'</simpara></listitem> </itemizedlist> </para> </example> @@ -2009,24 +2303,27 @@ <para> é常<function>each</function>ã¯ãé åã®èµ°æ»ãã?_ã£k <function>list</function>ã¨å ±ã«ä½¿ç¨ããã¾ããä¾ãã°ã - $HTTP_POST_VARSã®å ´åã¯æ¬¡ã®ãFã«ãªãã¾ãã + $HTTP_POST_VARSã®å ´åã¯æ¬¡ã®ããã«ãªãã¾ãã <example> <title> <function>each</function>ã«ãã$HTTP_POST_VARSãèµ°æ»ãã </title> <programlisting role="php"> -echo "POSTã¡ã½ããã«ããåãæ¸¡ãããå¤ï¼<br>"; +<![CDATA[ +echo "POSTã¡ã½ããã«ããåãæ¸¡ãããå¤ï¼<br>"; reset ($HTTP_POST_VARS); while (list ($key, $val) = each ($HTTP_POST_VARS)) { - echo "$key => $val<br>"; + echo "$key => $val<br>"; } +]]> </programlisting> </example> </para> <para> <function>each</function>ãå®è¡ããå¾ãé åã«ã¼ã½ã«ã¯ã - é åã®æ¬¡ã®è¦ç´ ã«ç§»åã~ããé åã®æçµè¦ç´ ã«ã«ã¼ã½ã«ãããå ´åã¯ã - æçµè¦ç´ ã«ã¨ã©ã¾ãã¾ãã + é åã®æ¬¡ã®è¦ç´ ã«ç§»åãã¾ããé åã®æçµè¦ç´ ã«ã«ã¼ã½ã«ãããå ´åã¯ã + æçµè¦ç´ ã«ã¨ã©ã¾ãã¾ããeachã使ç¨ãã¦é åãèµ°æ»ããã«ã¯ã + <function>reset</function>ã使ç¨ããå¿ è¦ãããã¾ãã </para> <para> <function>key</function>ã<function>list</function>ã @@ -2178,8 +2475,9 @@ <example> <title><function>extract</function>ã®ä¾</title> <programlisting role="php"> -<?php - +<![CDATA[ +<?php + /* $var_array ã¯wddx_deserializeããè¿ãããé åã¨ä»®å®ãã¾ã */ $size = "large"; @@ -2191,21 +2489,26 @@ print "$color, $size, $shape, $wddx_size\n"; ?> +]]> </programlisting> </example> </para> <para> ä¸è¨ã®ä¾ã®çµæã¯ä»¥ä¸ã¨ãªãã¾ãã <programlisting> +<![CDATA[ blue, large, sphere, medium +]]> </programlisting> </para> <para> - EXTR_PREFIX_SAMEãæå®ããããã$sizeã¯ä¸æ¸ããããã$wddx_size - ã使ããã¾ãã + EXTR_PREFIX_SAMEãæå®ããããã<varname>$size</varname>ã¯ä¸æ¸ã + ãããã<varname>$wddx_size</varname>ã使ããã¾ãã EXTR_SKIPãæå®ãããå ´åã$wddx_sizeã¯ä½æããã¾ãããEXTR_OVERWRITE - ã®å ´åã¯ã$sizeã®å¤ã¯"medium"ã¨ãªãã¾ããEXTR_PREFIX_ALLã®å ´å㯠- æ°è¦ã®å¤æ° $wddx_color, $wddx_size, $wddx_shapeã使ããã¾ãã + ã®å ´åã¯ã<varname>$size</varname>ã®å¤ã¯"medium"ã¨ãªãã¾ãã + EXTR_PREFIX_ALLã®å ´åã¯æ°è¦ã®å¤æ°<varname>$wddx_color</varname>, + <varname>$wddx_size</varname>, <varname>$wddx_shape</varname> + ã使ããã¾ãã </para> <para> 飿³é åã使ç¨ããå¿ è¦ããããæ°å¤æ·»åã®é åã«ã¯çµæã¯åºåããã¾ @@ -2237,8 +2540,7 @@ <para> <parameter>haystack</parameter>ã§ <parameter>needle</parameter>ãæ¤ç´¢ããé åã«ããããã£ãå ´åã« - &true;ããã以å¤ã®å ´åã¯ã - &false;ãè¿ãã¾ãã + &true;ããã以å¤ã®å ´åã¯ã&false;ãè¿ãã¾ãã </para> <para> 3çªç®ã®ãã©ã¡ã¼ã¿<parameter>strict</parameter>ã @@ -2246,14 +2548,25 @@ <function>in_array</function>ã¯ã<parameter>haystack</parameter> ã®ä¸ã® <parameter>needle</parameter>ã®åã確èªãã¾ãã </para> + <note> + <para> + <parameter>needle</parameter>ãæååã®å ´åãæ¯è¼ã®éã«å¤§æåå°æå + ã¯åºå¥ããã¾ãã + </para> + </note> <para> <example> <title><function>in_array</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $os = array ("Mac", "NT", "Irix", "Linux"); -if (in_array ("Irix", $os)){ +if (in_array ("Irix", $os)) { print "Got Irix"; } +if (in_array ("mac", $os)) { # in_array()ã¯å¤§æåå°æåãåºå¥ãããã失æ + print "Got mac"; +} +]]> </programlisting> </example> </para> @@ -2261,18 +2574,20 @@ <example> <title>strictãæå®ãã<function>in_array</function>ã®ä¾</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = array('1.10', 12.4, 1.13); if (in_array('12.4', $a, TRUE)) - echo "'12.4' found with strict check\n"; + echo "'12.4' found with strict check\n"; if (in_array(1.13, $a, TRUE)) - echo "1.13 found with strict check\n"; -?> + echo "1.13 found with strict check\n"; +?> -// ãã®ä¾ã¯ä»¥ä¸ã®ãããªåºåã¨ãªãã¾ãã +// 以ä¸ã®ãããªåºåã¨ãªãã¾ãã 1.13 found with strict check +]]> </programlisting> </example> </para> @@ -2296,14 +2611,15 @@ <funcdef>mixed <function>array_search</function></funcdef> <paramdef>mixed <parameter>needle</parameter></paramdef> <paramdef>array <parameter>haystack</parameter></paramdef> - <paramdef>bool <parameter>strict</parameter></paramdef> + <paramdef>bool + <parameter><optional>strict</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> <parameter>haystack</parameter>ã«ãã㦠<parameter>needle</parameter>ãæ¤ç´¢ããé åä¸ã«è¦ä»ãã£ãå ´åã«ã - ã®ãã¼ãè¿ãã¾ããããã§ãªãå ´åã«&false;ãè¿ã - ã¾ãã + ã®ãã¼ãè¿ãã¾ããããã§ãªãå ´åã«&false;ãè¿ãã¾ãã </para> <para> 3çªç®ã®ãã©ã¡ã¼ã¿<parameter>strict</parameter>ã @@ -2312,6 +2628,7 @@ <parameter>haystack</parameter>ã®ä¸ã«ãã <parameter>needle</parameter>ã®åã確èªãã¾ãã </para> + &return.falseproblem; <para> <function>in_array</function>ãåç §ä¸ããã </para> @@ -2366,21 +2683,31 @@ <example> <title><function>krsort</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); krsort ($fruits); reset($fruits); while(list($key,$val)=each($fruits)) { echo "$key -> $val\n"; } +]]> </programlisting> </example> + </para> + <para> ãã®ä¾ã®åºåã¯æ¬¡ã®ããã«ãªãã¾ãã - <computeroutput> -fruits[d] = lemon -fruits[c] = apple -fruits[b] = banana -fruits[a] = orange - </computeroutput> + </para> + <para> + <informalexample> + <programlisting> +<![CDATA[ +d = lemon +c = apple +b = banana +a = orange +]]> + </programlisting> + </informalexample> </para> <para> ãªãã·ã§ã³ã®ãã©ã¡ã¼ã¿<parameter>sort_flags</parameter>ã«ããã½ã¼ @@ -2390,7 +2717,7 @@ <simpara> <function>asort</function>, <function>arsort</function>, <function>ksort</function>, <function>sort</function>, - <function>rsort</function>ãåç §ä¸ããã + <function>natsort</function>, <function>rsort</function>ãåç §ä¸ããã </simpara> </refsect1> </refentry> @@ -2419,28 +2746,37 @@ <example> <title><function>ksort</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); ksort ($fruits); -reset($fruits); -while(list($key,$val)=each($fruits)) { - echo "$key -> $val\n"; +reset ($fruits); +while (list ($key, $val) = each ($fruits)) { + echo "$key = $val\n"; } +]]> </programlisting> </example> + </para> + <para> ãã®ä¾ã§ã¯ä»¥ä¸ã®ããã«åºåãè¡ããã¾ãã - <computeroutput> -fruits[a] = orange -fruits[b] = banana -fruits[c] = apple -fruits[d] = lemon - </computeroutput> + </para> + <para> + <informalexample> + <programlisting> +<![CDATA[ +a = orange +b = banana +c = apple +d = lemon +]]> + </programlisting> + </informalexample> </para> <para> ãªãã·ã§ã³ã®ãã©ã¡ã¼ã¿<parameter>sort_flags</parameter>ã«ããã½ã¼ ãã®åä½ãä¿®æ£å¯è½ã§ãã詳細ã«ã¤ãã¦ã¯ã<function>sort</function> ãåç §ä¸ããã </para> - <simpara> <function>asort</function>, <function>arsort</function>, <function>sort</function>, <function>natsort</function>, @@ -2476,25 +2812,27 @@ <example> <title><function>list</function>ã®ä¾</title> <programlisting role="php"> -<table> - <tr> - <th>徿¥å¡å</th> - <th>給ä¸</th> - </tr> - -<?php - -$result = mysql_query ($conn, "SELECT id, name, salary FROM employees"); -while (list($id, $name, $salary) = mysql_fetch_row($result)) { - print(" <tr>\n". - " <td><a href=\"info.php3?id=$id\">$name</a></td>\n". - " <td>$salary</td>\n". - " </tr>\n"); +<![CDATA[ +<table> + <tr> + <th>社å¡å</th> + <th>給æ</th> + </tr> + +<?php + +$result = mysql_query ("SELECT id, name, salary FROM employees",$conn); +while (list ($id, $name, $salary) = mysql_fetch_row ($result)) { + print (" <tr>\n". + " <td><a href=\"info.php3?id=$id\">$name</a></td>\n". + " <td>$salary</td>\n". + " </tr>\n"); } ?> -</table> +</table> +]]> </programlisting> </example> </para> @@ -2531,8 +2869,9 @@ <example> <title><function>natsort</function>ã®ä¾</title> <programlisting role="php"> -$array1 = $array2 = array ("img12.png","img10.png","img2.png","img1.png"); - +<![CDATA[ +$array1 = $array2 = array ("img12.png", "img10.png", "img2.png", "img1.png"); + sort($array1); echo "Standard sorting\n"; print_r($array1); @@ -2540,6 +2879,7 @@ natsort($array2); echo "\nNatural order sorting\n"; print_r($array2); +]]> </programlisting> </example> </para> @@ -2549,6 +2889,7 @@ <para> <informalexample> <programlisting> +<![CDATA[ Standard sorting Array ( @@ -2566,6 +2907,7 @@ [1] => img10.png [0] => img12.png ) +]]> </programlisting> </informalexample> ããè©³ç´°ãªæ å ±ã«ã¤ãã¦ã¯ãMartin Poolã®<ulink @@ -2733,16 +3075,56 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>range</function></funcdef> - <paramdef>int <parameter>low</parameter></paramdef> - <paramdef>int <parameter>high</parameter></paramdef> + <paramdef>mixed <parameter>low</parameter></paramdef> + <paramdef>mixed <parameter>high</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>range</function>ã¯ã<parameter>low</parameter>ãã <parameter>high</parameter>ã¾ã§ã®æ´æ°ã®é åãè¿ãã¾ãã + low > highã®å ´åãé çªã¯highããlowã¨ãªãã¾ãã </para> + <example> + <title><function>range</function>ã®ä¾</title> + <programlisting role="php"> +<![CDATA[ +foreach(range(0, 9) as $number) { + echo $number; +} +foreach(range('a', 'z') as $letter) { + echo $letter; +} +foreach(range('z', 'a') as $letter) { + echo $letter; +} +]]> + </programlisting> + </example> + <note> + <para> + 4.1.0ããåã®ãã¼ã¸ã§ã³ã§ã¯ã<function>range</function>颿°ã¯ã + æé ã®æ´æ°é åã®ã¿ãçæãã¾ãããæåã·ã¼ã±ã³ã¹åã³éé ã®é å + ã®ãµãã¼ãã4.1.0ã§è¿½å ããã¾ããã + </para> + <example> + <title>ãã¯ãªã¡ã³ãããç¯å²åã³æåã·ã¼ã±ã³ã¹ã®æ¨¡æ¬</title> + <programlisting role="php"> +<![CDATA[ +# ç¯å²ã®é çªãå転ããããã«array_reverseã使ç¨å¯è½ +foreach(array_reverse(range(0,9)) as $number) { + echo $number; +} + +# chr()ãç¨ãã¦æ´æ°ãæåã«å¤æããããã«array_map()ã使ç¨å¯è½ +foreach(array_map('chr', range(ord('a'),ord('z'))) as $character) { + echo $character; +} +]]> + </programlisting> + </example> + </note> <para> - 使ç¨ä¾ã«ã¤ãã¦ã¯ã<function>shuffle</function>ãåç §ä¸ããã + ãã®ä»ã®ä½¿ç¨ä¾ã«ã¤ãã¦ã¯ã<function>shuffle</function>ãåç §ä¸ããã </para> </refsect1> </refentry> @@ -2770,12 +3152,8 @@ <function>reset</function>ã¯ãé åã®æåã®è¦ç´ ã®å¤ãè¿ãã¾ãã </para> <para> - <function>current</function>, - <function>each</function>, - <function>next</function> - <function>prev</function>, - <function>reset</function> - ãåç §ä¸ããã + <function>current</function>, <function>each</function>, + <function>next</function>, <function>prev</function>ãåç §ä¸ããã </para> </refsect1> </refentry> @@ -2803,21 +3181,33 @@ <example> <title><function>rsort</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $fruits = array ("lemon", "orange", "banana", "apple"); rsort ($fruits); -reset($fruits); -while(list($key,$val)=each($fruits)) { - echo "$key -> $val\n"; +reset ($fruits); +while (list ($key, $val) = each ($fruits)) { + echo "$key = $val\n"; } +]]> </programlisting> </example> - ãã®ä¾ã§ã¯ä»¥ä¸ã®ããã«è¡¨ç¤ºãã¾ãã - <computeroutput> -fruits[0] = orange -fruits[1] = lemon -fruits[2] = banana -fruits[3] = apple - </computeroutput> + </para> + <para> + ãã®ä¾ã®åºåã¯ä»¥ä¸ã®ããã«ãªãã¾ãã + </para> + <para> + <informalexample> + <programlisting> +<![CDATA[ +0 = orange +1 = lemon +2 = banana +3 = apple +]]> + </programlisting> + </informalexample> + </para> + <para> fruitsã¯ã¢ã«ãã¡ãããã®éé ã«ã½ã¼ãããã¾ããã </para> <para> @@ -2853,21 +3243,21 @@ <example> <title><function>shuffle</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $numbers = range (1,20); -srand ((double)microtime()*1000000); +srand ((float)microtime()*1000000); shuffle ($numbers); -while (list(, $number) = each ($numbers)) { +while (list (, $number) = each ($numbers)) { echo "$number "; } +]]> </programlisting> </example> </para> <para> <function>arsort</function>,<function>asort</function>, <function>ksort</function>,<function>rsort</function>, - <function>natsort</function>, <function>natcasesort</function>, - <function>sort</function>,<function>usort</function>, - <function>uksort</function>ãåç §ä¸ããã + <function>sort</function>,<function>usort</function>ãåç §ä¸ããã </para> </refsect1> </refentry> @@ -2919,29 +3309,33 @@ <example> <title><function>sort</function>ã®ä¾</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $fruits = array ("lemon", "orange", "banana", "apple"); sort ($fruits); reset ($fruits); -while (list ($key,$val) = each ($fruits)) { - echo "fruits[".$key."] = ".$val; +while (list ($key, $val) = each ($fruits)) { + echo "fruits[".$key."] = ".$val."\n"; } - -?> + +?> +]]> </programlisting> </example> </para> <para> - ãã®ä¾ã§ã¯ä»¥ä¸ã®ããã«è¡¨ç¤ºãã¾ãã + ãã®ä¾ã®åºåã¯ä»¥ä¸ã®ããã«ãªãã¾ãã </para> <para> <informalexample> <programlisting> +<![CDATA[ fruits[0] = apple fruits[1] = banana fruits[2] = lemon fruits[3] = orange +]]> </programlisting> </informalexample> </para> @@ -3013,6 +3407,7 @@ åç §ä¸ããã </para> </note> + ¬e.func-callback; <para> <function>usort</function>, <function>uksort</function>, <function>sort</function>, <function>asort</function>, @@ -3043,10 +3438,11 @@ ãã®é¢æ°ã¯ãã¦ã¼ã¶ã¼å®ç¾©ã®æ¯è¼é¢æ°ãç¨ãã¦é åã®ãã¼ãã½ã¼ããã¾ãã ã½ã¼ããããé åãè¤éãªåºæºã§ã½ã¼ãããå¿ è¦ãããå ´åã«ã¯ã ãã®é¢æ°ã使ãå¿ è¦ãããã¾ãã - - <example> - <title><function>uksort</function>ã®ä¾</title> - <programlisting role="php"> + </para> + <example> + <title><function>uksort</function>ã®ä¾</title> + <programlisting role="php"> +<![CDATA[ function cmp ($a, $b) { if ($a == $b) return 0; return ($a > $b) ? -1 : 1; @@ -3059,21 +3455,30 @@ while (list ($key, $value) = each ($a)) { echo "$key: $value\n"; } - </programlisting> - </example> +]]> + </programlisting> + </example> + <para> ãã®ä¾ã«ããåºåã¯ä»¥ä¸ã®ããã«ãªãã¾ãã - <computeroutput> + </para> + <para> + <informalexample> + <programlisting> +<![CDATA[ 20: twenty 10: ten 4: four 3: three - </computeroutput> +]]> + </programlisting> + </informalexample> </para> + ¬e.func-callback; <para> <function>usort</function>, <function>uasort</function>, <function>sort</function>, <function>asort</function>, <function>arsort</function>, <function>ksort</function>, - <function>rsort</function>, <function>natsort</function> + <function>natsort</function>, <function>rsort</function> ãåç §ä¸ããã </para> </refsect1> @@ -3092,7 +3497,7 @@ <funcprototype> <funcdef>void <function>usort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> - <paramdef>function <parameter>cmp_function</parameter></paramdef> + <paramdef>string <parameter>cmp_function</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -3101,13 +3506,20 @@ ãã®é¢æ°ã使ç¨ããã¹ãã§ãã </para> <para> - æ¯è¼é¢æ°ã¯ãæåã®å¼æ°ãäºçªç®ã®å¼æ°ããå°ãããçããã大ããå ´åã« - ããããã¼ãæªæºãã¼ãã«çãããã¼ããã大ããæ´æ°ãè¿ãã¾ããäºã¤ã® - ã¡ã³ãã¼ã®?è¼çµæãçããã¨ãªã£ãå ´åãã½ã¼ããããé åã®é çªã¯å®ç¾© - ããã¾ããã + æ¯è¼é¢æ°ã¯ãæåã®å¼æ°ã2çªç®ã®å¼æ°ããå°ããããçãããã大ãã + å ´åã«ãããããã¼ãæªæºãã¼ãã«çãããã¼ããã大ããæ´æ°ãè¿ã + å¿ è¦ãããã¾ãã2ã¤ã®ã¡ã³ãã¼ã®æ¯è¼çµæãçããã¨ãªã£ãå ´åã + ã½ã¼ããããé åã®é çªã¯å®ç¾©ããã¾ããã + </para> + <para> + æ¯è¼é¢æ°ã¨ãã¦ãããªãã¸ã§ã¯ãã®ã¡ã³ãã¼é¢æ°ã使ç¨ãããã¨ãå¯è½ã§ãã + 以ä¸ã®ä¾3ãåç §ä¸ããã + </para> + <para> <example> <title><function>usort</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ function cmp ($a, $b) { if ($a == $b) return 0; return ($a > $b) ? -1 : 1; @@ -3120,6 +3532,7 @@ while (list ($key, $value) = each ($a)) { echo "$key: $value\n"; } +]]> </programlisting> </example> </para> @@ -3129,24 +3542,27 @@ <para> <informalexample> <programlisting> +<![CDATA[ 0: 6 1: 5 2: 3 3: 2 4: 1 +]]> </programlisting> </informalexample> </para> <note> <para> ãã¡ããããã®ãããªç°¡åãªä¾ã§ã¯<function>rsort</function>颿° - ã®æ¹ããã©iãfãã¾ãã + ã®æ¹ãããé©å½ã§ãã </para> </note> <para> <example> <title>夿¬¡å é åã使ç¨ãã<function>usort</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ function cmp ($a, $b) { return strcmp($a["fruit"],$b["fruit"]); } @@ -3160,6 +3576,7 @@ while (list ($key, $value) = each ($fruits)) { echo "\$fruits[$key]: " . $value["fruit"] . "\n"; } +]]> </programlisting> </example> </para> @@ -3173,26 +3590,76 @@ <para> <informalexample> <programlisting> +<![CDATA[ $fruits[0]: apples $fruits[1]: grapes $fruits[2]: lemons +]]> </programlisting> </informalexample> </para> <para> - <warning> - <para> - (Solarisã·ã¹ãã ã®ãããª)ããã¤ãã®Cã©ã¤ãã©ãªã«å«ã¾ãã - quicksort颿°ã¯ãæ¯è¼é¢æ°ãé©å½ãªå¤ãè¿ããªãå ´åã«PHPãã¯ã©ã - ã·ã¥ãããå¯è½æ§ãããã¾ãã - </para> - </warning> + <example> + <title> + <function>usort</function>ã§ãªãã¸ã§ã¯ãã®ã¡ã³ã颿°ã使ç¨ããä¾ + </title> + <programlisting role="php"> +<![CDATA[ +class TestObj { + var $name; + + function TestObj($name) + { + $this->name = $name; + } + + /* éçãªæ¯è¼é¢æ°: */ + function cmp_obj($a, $b) + { + $al = strtolower($a->name); + $bl = strtolower($b->name); + if ($al == $bl) return 0; + return ($al > $bl) ? +1 : -1; + } +} + +$a[] = new TestObj("c"); +$a[] = new TestObj("b"); +$a[] = new TestObj("d"); + +uasort($a, array ("TestObj", "cmp_obj")); + +foreach ($a as $item) { + print $item->name."\n"; +} +]]> + </programlisting> + </example> + </para> + <para> + ãã®ä¾ã®åºåã¯ä»¥ä¸ã®ããã«ãªãã¾ãã + </para> + <para> + <informalexample> + <programlisting> +b +c +d + </programlisting> + </informalexample> </para> + <warning> + <para> + (Solarisã·ã¹ãã ã®ãããª)ããã¤ãã®Cã©ã¤ãã©ãªã«å«ã¾ãã + quicksort颿°ã¯ãæ¯è¼é¢æ°ãé©å½ãªå¤ãè¿ããªãå ´åã«PHPãã¯ã©ã + ã·ã¥ãããå¯è½æ§ãããã¾ãã + </para> + </warning> <para> <function>uasort</function>, <function>uksort</function>, <function>sort</function>, <function>asort</function>, <function>arsort</function>, <function>ksort</function>, - <function>rsort</function>, <function>natsort</function> + <function>natsort</function>, <function>rsort</function> ãåç §ä¸ããã </para> </refsect1>
Index: phpdoc/ja/functions/array.xml diff -u phpdoc/ja/functions/array.xml:1.36 phpdoc/ja/functions/array.xml:1.37 --- phpdoc/ja/functions/array.xml:1.36 Wed Dec 12 15:52:43 2001 +++ phpdoc/ja/functions/array.xml Sun Dec 30 20:09:52 2001 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.36 $ --> +<!-- $Revision: 1.37 $ --> <reference id="ref.array"> <title>é å颿°(array)</title> <titleabbrev>Arrays</titleabbrev> @@ -36,7 +36,9 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>array</function></funcdef> - <varargs/> + <paramdef>mixed + <parameter><optional>...</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> @@ -65,11 +67,13 @@ <example> <title><function>array</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $fruits = array ( "fruits" => array("a"=>"orange", "b"=>"banana", "c"=>"apple"), "numbers" => array(1, 2, 3, 4, 5, 6), "holes" => array("first", 5 => "second", "third") ); +]]> </programlisting> </example> </para> @@ -77,13 +81,15 @@ <example> <title><function>array</function> ã«ãããèªåã¤ã³ããã¯ã¹</title> <programlisting role="php"> +<![CDATA[ $array = array( 1, 1, 1, 1, 1, 8=>1, 4=>1, 19, 3=>13); print_r($array); +]]> </programlisting> - </example> - ãã®ä¾ã®åºåã¯æ¬¡ã®ããã«ãªãã¾ãã - <informalexample> - <programlisting> + <para> + ãã®ä¾ã®åºåã¯æ¬¡ã®ããã«ãªãã¾ãã + <screen role="php"> +<![CDATA[ Array ( [0] => 1 @@ -94,8 +100,10 @@ [8] => 1 [9] => 19 ) - </programlisting> - </informalexample> +]]> + </screen> + </para> + </example> ã¤ã³ããã¯ã¹ '3' ã¯äºåº¦å®ç¾©ããã¦ãããå¾ã®å¤ 13 ãä¿æããããã¨ ã«æ³¨æãã¦ä¸ãããã¤ã³ããã¯ã¹ 4 ã¯ã¤ã³ããã¯ã¹ 8 ã®å¾ã«å®ç¾©ããã æ¬¡ã«çæãããã¤ã³ããã¯ã¹(å¤ã¯19)ã¯ãæå¤§ã®ã¤ã³ããã¯ã¹ã 8 ã§ã @@ -106,27 +114,83 @@ <example> <title><function>array</function> ã§1ããå§ã¾ãé åã使</title> <programlisting role="php"> - $firstquarter = array(1 => 'January', 'February', 'March'); - print_r($firstquarter); +<![CDATA[ +$firstquarter = array(1 => 'January', 'February', 'March'); +print_r($firstquarter); +]]> </programlisting> - </example> - ãã®ä¾ã®åºåã¯æ¬¡ã®ããã«ãªãã¾ãã - <informalexample> - <programlisting> + <para> + ãã®ä¾ã®åºåã¯æ¬¡ã®ããã«ãªãã¾ãã + <screen> +<![CDATA[ Array ( - [1] => 'January' - [2] => 'February' - [3] => 'March' + [1] => 'January' + [2] => 'February' + [3] => 'March' ) - </programlisting> - </informalexample> +]]> + </screen> + </para> + </example> </para> <para> - <function>list</function>ãåç §ä¸ããã + <function>array_pad</function>, <function>list</function>, + <function>range</function>ãåç §ä¸ããã </para> </refsect1> </refentry> + + <refentry id="function.array-change-key-case"> + <refnamediv> + <refname>array_change_key_case</refname> + <refpurpose> + é åã®ãã¼ãå ¨ã¦å°æåã¾ãã¯å¤§æåã«ãã¦è¿ã + </refpurpose> + </refnamediv> + <refsect1> + <title>説æ</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>array_change_key_case</function></funcdef> + <paramdef>array <parameter>input</parameter></paramdef> + <paramdef>int + <parameter><optional>case</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>array_change_key_case</function> ã¯ãé å + <parameter>input</parameter>ã®ãã¼ãå ¨ã¦å°æåã¾ãã¯å¤§æåã«ãã¾ãã + 夿´ã¯ããªãã·ã§ã³ã®æå¾ã®ãã©ã¡ã¼ã¿<parameter>case</parameter>ã«ä¾å + ãã¾ããããã«ã¯ãäºã¤ã®å®æ°<constant>CASE_UPPER</constant>ããã³ + <constant>CASE_LOWER</constant>ãæå®å¯è½ã§ããããã©ã«ãã¯ã + <constant>CASE_LOWER</constant>ã§ãããã®é¢æ°ã¯æ°å¤æ·»åã¯ãã®ã¾ã¾ã« + ãã¾ãã + </para> + <example> + <title><function>array_change_key_case</function>ã®ä¾</title> + <programlisting role="php"> +<![CDATA[ +$input_array = array("FirSt" => 1, "SecOnd" => 4); +print_r(array_change_key_case($input_array, CASE_UPPER); +]]> + </programlisting> + <para> + ä¸ã®ããã°ã©ã ã®åºåã¯ä»¥ä¸ã®ããã«ãªãã¾ãã + <screen> +<![CDATA[ +Array +( + [FIRST] => 1 + [SECOND] => 2 +) +]]> + </screen> + </para> + </example> + </refsect1> + </refentry> <refentry id="function.array-chunk"> <refnamediv> @@ -158,18 +222,19 @@ å¯è½ã§ãã&false;ãæå®ããå ´åãè¿ãããåé åã§ã¯ã¼ãããå§ã¾ã æ°ããæ·»åã使ç¨ããã¾ããããã©ã«ãã¯ã&false;ã§ãã </para> - <para> - <example> - <title><function>array_chunk</function> ã®ä¾</title> - <programlisting role="php"> + <example> + <title><function>array_chunk</function> ã®ä¾</title> + <programlisting role="php"> +<![CDATA[ $input_array = array('a', 'b', 'c', 'd', 'e'); print_r(array_chunk($input_array, 2)); print_r(array_chunk($input_array, 2, TRUE)); - </programlisting> - </example> - ä¸ã®ããã°ã©ã ã®åºåã¯ä»¥ä¸ã®ããã«ãªãã¾ãã - <informalexample> - <programlisting> +]]> + </programlisting> + <para> + ä¸ã®ããã°ã©ã ã®åºåã¯ä»¥ä¸ã®ããã«ãªãã¾ãã + <screen> +<![CDATA[ Array ( [0] => Array @@ -210,9 +275,10 @@ ) ) - </programlisting> - </informalexample> - </para> +]]> + </screen> + </para> + </example> </refsect1> </refentry> @@ -239,15 +305,12 @@ <example> <title><function>array_count_values</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $array = array(1, "hello", 1, "world", "hello"); array_count_values($array); // array(1=>2, "hello"=>2, "world"=>1)ãè¿ãã¾ã +]]> </programlisting> </example> - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -265,9 +328,7 @@ <paramdef>array <parameter>array1</parameter></paramdef> <paramdef>array <parameter>array2</parameter></paramdef> <paramdef>array - <parameter> - <replaceable><optional> ...</optional></replaceable> - </parameter> + <parameter><optional> ...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -280,16 +341,33 @@ <example> <title><function>array_diff</function> ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $array1 = array ("a" => "green", "red", "blue"); $array2 = array ("b" => "green", "yellow", "red"); $result = array_diff ($array1, $array2); +]]> </programlisting> </example> </para> <para> ããã«ããã<varname>$result</varname> 㯠- <literal>array ("blue");</literal> ã¨ãªãã¾ãã + <literal>array ("blue");</literal> ã¨ãªãã¾ãã$array1ã«è¤æ°åå¨ + ããå ´åã§ãå ¨ã¦åæ§ã«å¦çããã¾ãã </para> + <note> + <simpara> + äºã¤ã®è¦ç´ ã¯ã<literal>(string) $elem1 === (string) $elem2</literal> + ã®å ´åã®ã¿çããã¨è¦ç´ããã¾ããè¨ãæããã¨ãæåå表ç¾ãåãå ´å㨠+ ãªãã¾ãã + <!-- TODO: example of it... --> + </simpara> + </note> + <warning> + <simpara> + ãã®é¢æ°ã¯ãPHP 4.0.4ã§ã¯åä½ãã¾ãã! + <!-- TODO: when exactly was this broken?... --> + </simpara> + </warning> <para> <function>array_intersect</function>ãåç §ä¸ããã </para> @@ -324,6 +402,7 @@ <example> <title><function>array_filter</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ function odd($var) { return ($var % 2 == 1); } @@ -332,11 +411,12 @@ return ($var % 2 == 0); } -$array1 = array ("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5); +$array1 = array ("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5); $array2 = array (6, 7, 8, 9, 10, 11, 12); $odd_arr = array_filter($array1, "odd"); $even_arr = array_filter($array2, "even"); +]]> </programlisting> </example> </para> @@ -346,6 +426,7 @@ ãã<varname>$even_arr</varname> 㯠<literal>array (6, 8, 10, 12);</literal>ã¨ãªãã¾ãã </para> + ¬e.func-callback; <para> <function>array_map</function>, <function>array_reduce</function>ãåç §ä¸ããã @@ -356,7 +437,7 @@ <refentry id="function.array-flip"> <refnamediv> <refname>array_flip</refname> - <refpurpose>é åã®å¤ãéé ã«ãã</refpurpose> + <refpurpose>é åã®å¤ãå転ã«ãã</refpurpose> </refnamediv> <refsect1> <title>説æ</title> @@ -367,21 +448,45 @@ </funcprototype> </funcsynopsis> <para> - <function>array_flip</function> ã¯ãé åãéé ã«ãã¦è¿ãã¾ãã + <function>array_flip</function> ã¯ãé åãå転ãã¦è¿ãã¾ãã + ããªãã¡ã<parameter>trans</parameter>ã®ãã¼ã¯å¤ã¨ãªãã + <parameter>trans</parameter>ã®å¤ã¯ãã¼ã¨ãªãã¾ãã + </para> + <para> + <parameter>trans</parameter>ã®å¤ã¯æå¹ãªãã¼ãå¿ è¦ã¨ãããã¨ã«æ³¨æã㦠+ ä¸ãããããªãã¡ããã¼ã¯ã<type>integer</type>ã¾ã㯠+ <type>string</type>ã§ããå¿ è¦ãããã¾ããããå¤ãééã£ãåã§ããå ´åã + è¦åãåºåãããåé¡ã®ãã®ãã¼/å¤ã®çµã¯éé ã«ããã¾ããã + </para> + <para> + ããå¤ãè¤æ°ååºç¾ããå ´åãæå¾ã®ãã¼ããã®å¤ã¨ãã¦ä½¿ç¨ããããã®ä»ã® + å¤ã¯å¤±ããã¾ãã + </para> + <para> + <function>array_flip</function>ã¯å¤±æããå ´åã«&false;ãè¿ãã¾ãã </para> <para> <example> <title><function>array_flip</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $trans = array_flip ($trans); $original = strtr ($str, $trans); +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title><function>array_flip</function>ã®ä¾ : è¡çª</title> + <programlisting role="php"> +<![CDATA[ +$trans = array ("a" => 1, "b" => 1, "c" => 2); +$trans = array_flip ($trans); +// ããã§$transã¯æ¬¡ã®ããã«ãªãã¾ã: array(1 => "b", 2 => "c"); +]]> </programlisting> </example> - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -412,6 +517,7 @@ <example> <title><function>array_fill</function> ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $a = array_fill(5, 6, 'banana'); /* @@ -424,6 +530,7 @@ $a[9] = "banana"; $a[10] = "banana"; */ +]]> </programlisting> </example> </para> @@ -443,9 +550,7 @@ <paramdef>array <parameter>array1</parameter></paramdef> <paramdef>array <parameter>array2</parameter></paramdef> <paramdef>array - <parameter> - <replaceable><optional> ...</optional></replaceable> - </parameter> + <parameter><optional> ...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -458,9 +563,11 @@ <example> <title><function>array_intersect</function> ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $array1 = array ("a" => "green", "red", "blue"); $array2 = array ("b" => "green", "yellow", "red"); $result = array_intersect ($array1, $array2); +]]> </programlisting> </example> </para> @@ -468,12 +575,73 @@ ããã«ããã<varname>$result</varname> 㯠<literal>array ("a" => "green", "red");</literal>ã¨ãªãã¾ãã </para> + <note> + <simpara> + äºã¤ã®è¦ç´ ã¯ã + <literal>(string) $elem1 === (string) $elem2</literal>ã®å ´åã®ã¿ + çããã¨ã¿ãªããã¾ããè¨ãæããã¨ãæåå表ç¾ãåãå ´åã¨ãªãã¾ãã + <!-- TODO: example of it... --> + </simpara> + </note> + <warning> + <simpara> + ãã®é¢æ°ã¯PHP 4.0.4ã§ã¯åä½ãã¾ãã! + <!-- TODO: when exactly was this broken?... --> + </simpara> + </warning> <para> <function>array_diff</function>ãåç §ä¸ããã </para> </refsect1> </refentry> + <refentry id="function.array-key-exists"> + <refnamediv> + <refname>array_key_exists</refname> + <refpurpose> + æå®ãããã¼ã¾ãã¯æ·»åãé åã«ãããã©ããã調ã¹ã + </refpurpose> + </refnamediv> + <refsect1> + <title>説æ</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>array_key_exists</function></funcdef> + <paramdef>mixed <parameter>key</parameter></paramdef> + <paramdef>array <parameter>search</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + æå®ãã<parameter>key</parameter>ãé åã«è¨å®ããã¦ããå ´åã + <function>array_key_exists</function>ã¯&true;ãè¿ãã¾ãã + <parameter>key</parameter>ã¯é åæ·»åã¨ãã¦ä½¿ç¨ã§ããå ¨ã¦ã® + å¤ã使ç¨å¯è½ã§ãã + </para> + <para> + <example> + <title><function>array_key_exists</function>ã®ä¾</title> + <programlisting role="php"> +<![CDATA[ +$search_array = array("first" => 1, "second" => 4); +if (array_key_exists("first", $search_array)) { + echo "The 'first' element is in the array"; +} +]]> + </programlisting> + </example> + </para> + <note> + <simpara> + ãã®é¢æ°ã®ååã¯ãPHPãã¼ã¸ã§ã³4.0.6ã§ã¯ + <function>key_exists</function>ã§ãã + </simpara> + </note> + <para> + <function>isset</function>ãåç §ä¸ããã + </para> + </refsect1> + </refentry> + <refentry id="function.array-keys"> <refnamediv> <refname>array_keys</refname> @@ -486,9 +654,7 @@ <funcdef>array <function>array_keys</function></funcdef> <paramdef>array <parameter>input</parameter></paramdef> <paramdef>mixed - <parameter> - <replaceable><optional>search_value</optional></replaceable> - </parameter> + <parameter><optional>search_value</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -505,6 +671,7 @@ <example> <title><function>array_keys</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $array = array(0 => 100, "color" => "red"); array_keys($array); // array(0, "color")ãè¿ãã¾ã @@ -513,6 +680,7 @@ $array = array ("color" => array("blue", "red", "green"), "size" => array("small", "medium", "large")); array_keys ($array); // é å("color", "size") ãè¿ãã¾ã +]]> </programlisting> </example> </para> @@ -525,15 +693,18 @@ PHP 3ã¦ã¼ã¶ç¨ã®<function>array_keys</function>ã®å®è£ </title> <programlisting role="php"> +<![CDATA[ function array_keys ($arr, $term="") { $t = array(); while (list($k,$v) = each($arr)) { - if ($term && $v != $term) + if ($term && $v != $term) { continue; $t[] = $k; } - return $t; + } + return $t; } +]]> </programlisting> </example> </para> @@ -547,7 +718,9 @@ <refentry id="function.array-map"> <refnamediv> <refname>array_map</refname> - <refpurpose>æå®ããé åã®è¦ç´ ã«ã³ã¼ã«ããã¯é¢æ°ãé©ç¨ãã</refpurpose> + <refpurpose> + æå®ããé åã®è¦ç´ ã«ã³ã¼ã«ããã¯é¢æ°ãé©ç¨ãã + </refpurpose> </refnamediv> <refsect1> <title>説æ</title> @@ -572,12 +745,14 @@ <example> <title><function>array_map</function> ã®ä¾</title> <programlisting role="php"> +<![CDATA[ function cube($n) { return $n*$n*$n; } $a = array(1, 2, 3, 4, 5); $b = array_map("cube", $a); +]]> </programlisting> </example> </para> @@ -589,6 +764,7 @@ <example> <title><function>array_map</function> - ããå¤ãã®é åã使ç¨</title> <programlisting role="php"> +<![CDATA[ function show_Spanish($n, $m) { return "The number $n is called $m in Spanish"; } @@ -647,6 +823,7 @@ // ) // // ) +]]> </programlisting> </example> </para> @@ -664,8 +841,9 @@ </para> <para> <example> - <title><function>array_map</function> - é åã®é åã使ãã</title> + <title>é åã®é åã使ãã</title> <programlisting role="php"> +<![CDATA[ $a = array(1, 2, 3, 4, 5); $b = array("one", "two", "three", "four", "five"); $c = array("uno", "dos", "tres", "cuatro", "cinco"); @@ -712,6 +890,7 @@ // ) // // ) +]]> </programlisting> </example> </para> @@ -734,10 +913,8 @@ <funcdef>array <function>array_merge</function></funcdef> <paramdef>array <parameter>array1</parameter></paramdef> <paramdef>array <parameter>array2</parameter></paramdef> - <paramdef> - <parameter> - <replaceable><optional> ...</optional></replaceable> - </parameter> + <paramdef>array + <parameter><optional> ...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -754,17 +931,19 @@ <example> <title><function>array_merge</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $array1 = array ("color" => "red", 2, 4); $array2 = array ("a", "b", "color" => "green", "shape" => "trapezoid", 4); -array_merge ($array1, $array2); +$result = array_merge ($array1, $array2); +]]> </programlisting> - <para> - è¿ãããé åã¯ãarray("color" => "green", 2, 4, "a", - "b", "shape" => "trapezoid", 4)ã¨ãªãã¾ãã - </para> </example> </para> <para> + è¿ãããé åã¯ã<literal>array("color" => "green", 2, 4, + "a", "b", "shape" => "trapezoid", 4)</literal>ã¨ãªãã¾ãã + </para> + <para> <function>array_merge_recursive</function>ãåç §ä¸ããã </para> </refsect1> @@ -782,10 +961,8 @@ <funcdef>array <function>array_merge_recursive</function></funcdef> <paramdef>array <parameter>array1</parameter></paramdef> <paramdef>array <parameter>array2</parameter></paramdef> - <paramdef> - <parameter> - <replaceable><optional> ...</optional></replaceable> - </parameter> + <paramdef>array + <parameter><optional> ...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -805,17 +982,20 @@ <example> <title><function>array_merge_recursive</function>ã®ä¾</title> <programlisting role="php"> -$ar1 = array("color" => array("favorite" => "red"), 5); -$ar2 = array(10, "color" => array("favorite" => "green", "blue")); -$result = array_merge_recursive($ar1, $ar2); +<![CDATA[ +$ar1 = array ("color" => array ("favorite" => "red"), 5); +$ar2 = array (10, "color" => array ("favorite" => "green", "blue")); +$result = array_merge_recursive ($ar1, $ar2); +]]> </programlisting> - <para> - è¿ãããé åã¯ãarray("color" => array("favorite" => - array("red", "green"), "blue"), 5, 10)ã¨ãªãã¾ãã - </para> </example> </para> <para> + è¿ãããé åã¯ã<literal>array ("color" => array + ("favorite" => array ("red", "green"), "blue"), 5, 10)</literal> + ã¨ãªãã¾ãã + </para> + <para> <function>array_merge</function>ãåç §ä¸ããã </para> </refsect1> @@ -833,14 +1013,13 @@ <funcdef>bool <function>array_multisort</function></funcdef> <paramdef>array <parameter>ar1</parameter></paramdef> <paramdef>mixed - <parameter> - <replaceable><optional>arg</optional></replaceable> - </parameter> + <parameter><optional>arg</optional></parameter> </paramdef> - <paramdef> - <parameter> - <replaceable><optional>...</optional></replaceable> - </parameter> + <paramdef>mixed + <parameter><optional>...</optional></parameter> + </paramdef> + <paramdef>array + <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -893,36 +1072,43 @@ ããã³SORT_REGULARã«ãªã»ãããã¾ãã </para> <para> - æåæã«&true;ã失æããå ´åã« - &false;ãè¿ãã¾ãã + æåæã«&true;ã失æããå ´åã«&false;ãè¿ãã¾ãã </para> - <example> - <title>è¤æ°ã®é åãã½ã¼ããã</title> - <programlisting role="php"> + <para> + <example> + <title>è¤æ°ã®é åãã½ã¼ããã</title> + <programlisting role="php"> +<![CDATA[ $ar1 = array ("10", 100, 100, "a"); $ar2 = array (1, 3, "2", 1); array_multisort ($ar1, $ar2); - </programlisting> - <para> - ãã®ä¾ã§ã¯ãã½ã¼ãã®å¾ã§ãæåã®é åã¯ã10,"a", 100, 100ã¨ãªãã¾ - ãã2çªç®ã®é åã¯ã1, 1, "2", 3ãæãã¾ããæåã®é å(100ããã³ - 100)ã®åãã¨ã³ããªã«å¯¾å¿ãã¦ãã2çªç®ã®é åã®ã¨ã³ããªã¯åæã«ã½ã¼ - ãããã¾ãã - </para> - </example> - - <example> - <title>夿¬¡å ã®é åãã½ã¼ããã</title> - <programlisting role="php"> -$ar = array(array("10", 100, 100, "a"), array(1, 3, "2", 1)); -array_multisort($ar[0], SORT_ASC, SORT_STRING, $ar[1], SORT_NUMERIC, SORT_DESC); - </programlisting> - <para> - ãã®ä¾ã§ã¯ãã½ã¼ããããå¾ãæåã®é åã¯10,100, 100, "a" (æåå - ã¨ãã¦æé ã£Â½ã¼ãããã¦ãã¾ã)ãæãã¦ããã2çªç®ã®é åã¯ã - 1, 3, "2", 1 (æ°å¤ã¨ãã¦éé ã«ã½ã¼ãããã¦ãã¾ã)ã¨ãªã£ã¦ãã¾ãã - </para> - </example> +]]> + </programlisting> + </example> + </para> + <para> + ãã®ä¾ã§ã¯ãã½ã¼ãã®å¾ã§ãæåã®é åã¯ã10,"a", 100, 100ã¨ãªãã¾ + ãã2çªç®ã®é åã¯ã1, 1, "2", 3ãæãã¾ããæåã®é å(100ããã³ + 100)ã®åãã¨ã³ããªã«å¯¾å¿ãã¦ãã2çªç®ã®é åã®ã¨ã³ããªã¯åæã«ã½ã¼ + ãããã¾ãã + </para> + <para> + <example> + <title>夿¬¡å ã®é åãã½ã¼ããã</title> + <programlisting role="php"> +<![CDATA[ +$ar = array (array ("10", 100, 100, "a"), array (1, 3, "2", 1)); +array_multisort ($ar[0], SORT_ASC, SORT_STRING, + $ar[1], SORT_NUMERIC, SORT_DESC); +]]> + </programlisting> + </example> + </para> + <para> + ãã®ä¾ã§ã¯ãã½ã¼ããããå¾ãæåã®é åã¯10,100, 100, "a" (æåå + ã¨ãã¦æé ã§ã½ã¼ãããã¦ãã¾ã)ãæãã¦ããã2çªç®ã®é åã¯ã + 1, 3, "2", 1 (æ°å¤ã¨ãã¦éé ã«ã½ã¼ãããã¦ãã¾ã)ã¨ãªã£ã¦ãã¾ãã + </para> </refsect1> </refentry> @@ -955,6 +1141,7 @@ <example> <title><function>array_pad</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $input = array (12, 10, 9); $result = array_pad ($input, 5, 0); @@ -965,6 +1152,7 @@ $result = array_pad ($input, 2, "noop"); // åããå¦çã¯è¡ããã¾ããã +]]> </programlisting> </example> </para> @@ -990,27 +1178,23 @@ ã¯ãè¦ç´ ä¸ã¤åçããªãã¾ãã<parameter>array</parameter> ã空ã®å ´ åã(ã¾ãã¯ãé åã§ãªãå ´åã)&null;ãè¿ããã¾ãã </para> - <para> - <example> - <title><function>array_pop</function>ã®ä¾</title> - <programlisting role="php"> + <example> + <title><function>array_pop</function>ã®ä¾</title> + <programlisting role="php"> +<![CDATA[ $stack = array ("orange", "apple", "raspberry"); $fruit = array_pop ($stack); - </programlisting> - <para> - ããã«ããã$stackã®è¦ç´ ã¯äºã¤("orange"ããã³ "apple")ã ãã¨ãªãã - $fruit ã¯"raspberry"ã¨ãªãã¾ãã - </para> - </example> +]]> + </programlisting> + </example> + <para> + ããã«ããã<varname>$stack</varname>è¦ç´ ã¯äºã¤("orange"ããã³ + "apple")ã ãã¨ãªãã<varname>$fruit</varname>ã¯"raspberry"ã¨ãªãã¾ãã </para> + &return.falseproblem; <para> <function>array_push</function>,<function>array_shift</function>, <function>array_unshift</function>ãåç §ä¸ããã - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -1027,10 +1211,8 @@ <funcdef>int <function>array_push</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>mixed <parameter>var</parameter></paramdef> - <paramdef> - <parameter> - <replaceable><optional>...</optional></replaceable> - </parameter> + <paramdef>mixed + <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -1041,8 +1223,11 @@ <parameter>array</parameter>ã®é·ãã¯æ¸¡ããã夿°ã®æ°ã ãå¢å ãã¾ãã å<parameter>var</parameter>æ¯ã«ä»¥ä¸ãç¹°ãè¿ããã¨ã¨åã广ãããã¾ãã <programlisting role="php"> +<![CDATA[ $array[] = $var; +]]> </programlisting> + å<parameter>var</parameter>ã§ç¹°ãè¿ããã¾ãã </para> <para> å¦çå¾ã®é åã®ä¸ã®è¦ç´ ã®æ°ãè¿ãã¾ãã @@ -1051,20 +1236,20 @@ <example> <title><function>array_push</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $stack = array (1, 2); -array_push($stack, "+", 3); +array_push ($stack, "+", 3); +]]> </programlisting> </example> - ãã®ä¾ã®çµæã$stackã«ã¯ã4ã¤ã®è¦ç´ 1,2,"+",3ããããã¨ã«ãªãã¾ãã + </para> + <para> + ãã®ä¾ã®çµæã<varname>$stack</varname>ã«ã¯ã4ã¤ã®è¦ç´ 1,2,"+", + 3ããããã¨ã«ãªãã¾ãã </para> <para> <function>array_pop</function>,<function>array_shift</function>, <function>array_unshift</function>ãåç §ä¸ããã - <note> - <para> - ãã®é¢æ°ã¯ã PHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -1081,9 +1266,7 @@ <funcdef>mixed <function>array_rand</function></funcdef> <paramdef>array <parameter>input</parameter></paramdef> <paramdef>int - <parameter> - <replaceable><optional>num_req</optional></replaceable> - </parameter> + <parameter><optional>num_req</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -1109,11 +1292,13 @@ <example> <title><function>array_rand</function>ã®ä¾</title> <programlisting role="php"> -srand((double)microtime() * 10000000); -$input = array("Neo", "Morpheus", "Trinity", "Cypher", "Tank"); -$rand_keys = array_rand($input, 2); +<![CDATA[ +srand ((float) microtime() * 10000000); +$input = array ("Neo", "Morpheus", "Trinity", "Cypher", "Tank"); +$rand_keys = array_rand ($input, 2); print $input[$rand_keys[0]]."\n"; print $input[$rand_keys[1]]."\n"; +]]> </programlisting> </example> </para> @@ -1146,20 +1331,24 @@ <example> <title><function>array_reverse</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $input = array ("php", 4.0, array ("green", "red")); $result = array_reverse ($input); $result_keyed = array_reverse ($input, TRUE); +]]> </programlisting> </example> + </para> + <para> ãã®ä¾ã«ããã¦ã<varname>$result</varname>ã¯ã<literal>array (array ("green", "red"), 4.0, "php")</literal>ã¨ãªãã¾ãããããã <varname>$result2[0]</varname>ã¯ã¾ã <literal>"php"</literal>ã§ãã - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ãã¼ã¿3ã§è¿½å ããã¾ããã - </para> - </note> </para> + <note> + <para> + 2çªç®ã®ãã©ã¡ã¼ã¿ã¯ãPHP 4.0.3ã§è¿½å ããã¾ããã + </para> + </note> </refsect1> </refentry> @@ -1184,17 +1373,17 @@ </funcprototype> </funcsynopsis> <para> - <function>array_reduce</function> applies iteratively the - <parameter>callback</parameter> function to the elements of the - array <parameter>input</parameter>, so as to reduce the array to - a single value. If the optional <parameter>intial</parameter> is - avaliable, it will be used at the beginning of the process, or as - a final result in case the array is empty. + <function>array_reduce</function>ã¯ãé å<parameter>input</parameter> + ã®åè¦ç´ ã«<parameter>callback</parameter>颿°ãç¹°ãè¿ãé©ç¨ãã + é åãä¸ã¤ã®å¤ã«æ¸ããã¾ãããªãã·ã§ã³<parameter>intial</parameter> + ãå©ç¨å¯è½ãªå ´åãå¦çã®æåã§ä½¿ç¨ãããããé åã空ã®å ´åã®æçµçµæ + ã¨ãã¦ä½¿ç¨ããã¾ãã </para> <para> <example> - <title><function>array_reduce</function> example</title> + <title><function>array_reduce</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ function rsum($v, $w) { $v += $w; return $v; @@ -1210,18 +1399,19 @@ $b = array_reduce($a, "rsum"); $c = array_reduce($a, "rmul", 10); $d = array_reduce($x, "rsum", 1); +]]> </programlisting> </example> </para> <para> - This will result in <varname>$b</varname> containing - <literal>15</literal>, <varname>$c</varname> containing - <literal>1200</literal> (= 1*2*3*4*5*10), and - <varname>$d</varname> containing <literal>1</literal>. + ããã«ããã<varname>$b</varname>ã®å¤ã¯<literal>15</literal> + ã¨ãªãã<varname>$c</varname>ã®å¤ã¯ + <literal>1200</literal> (= 1*2*3*4*5*10)ãããã¦ã + <varname>$d</varname>ã®å¤ã¯<literal>1</literal>ã¨ãªãã¾ãã </para> <para> - See also <function>array_filter</function>, - <function>array_map</function>. + <function>array_filter</function>, + <function>array_map</function>ãåç §ä¸ããã </para> </refsect1> </refentry> @@ -1250,22 +1440,19 @@ <example> <title><function>array_shift</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $args = array ("-v", "-f"); $opt = array_shift ($args); +]]> </programlisting> </example> - ããã«ããã$argsã«ã¯ä¸ã¤ã®è¦ç´ "-f"ãæ®ãã$opt㯠- "-v"ã¨ãªãã¾ãã + ããã«ããã<varname>$args</varname>ã«ã¯ä¸ã¤ã®è¦ç´ "-f"ãæ®ãã + <varname>$opt</varname>ã¯"-v"ã¨ãªãã¾ãã </para> <para> <function>array_unshift</function>, <function>array_push</function>, <function>array_pop</function>ãåç §ä¸ããã - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -1283,9 +1470,7 @@ <paramdef>array <parameter>array</parameter></paramdef> <paramdef>int <parameter>offset</parameter></paramdef> <paramdef>int - <parameter> - <replaceable><optional>length</optional></replaceable> - </parameter> + <parameter><optional>length</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -1311,22 +1496,19 @@ <example> <title><function>array_slice</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $input = array ("a", "b", "c", "d", "e"); $output = array_slice ($input, 2); // "c", "d", "e"ãè¿ãã¾ã $output = array_slice ($input, 2, -1); // "c", "d"ãè¿ãã¾ã $output = array_slice ($input, -2, 1); // "d"ãè¿ãã¾ã $output = array_slice ($input, 0, 3); // "a", "b", "c"ãè¿ãã¾ã +]]> </programlisting> </example> </para> <para> <function>array_splice</function>ãåç §ä¸ããã - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -1344,14 +1526,10 @@ <paramdef>array <parameter>input</parameter></paramdef> <paramdef>int <parameter>offset</parameter></paramdef> <paramdef>int - <parameter> - <replaceable><optional>length</optional></replaceable> - </parameter> + <parameter><optional>length</optional></parameter> </paramdef> <paramdef>array - <parameter> - <replaceable><optional>replacement</optional></replaceable> - </parameter> + <parameter><optional>replacement</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -1392,11 +1570,13 @@ <para> 以ä¸ã¯ç価ã¨ãªãã¾ãã <programlisting role="php"> +<![CDATA[ array_push($input, $x, $y) array_splice($input, count($input), 0, array($x, $y)) array_pop($input) array_splice($input, -1) array_shift($input) array_splice($input, 0, 1) array_unshift($input, $x, $y) array_splice($input, 0, 0, array($x, $y)) $a[$x] = $y array_splice($input, $x, 1, $y) +]]> </programlisting> </para> <para> @@ -1406,25 +1586,29 @@ <example> <title><function>array_splice</function>ã®ä¾</title> <programlisting role="php"> -$input = array("red", "green", "blue", "yellow"); - -array_splice($input, 2); // $input ã¯ãarray("red", "green") ã¨ãªãã¾ãã -array_splice($input, 1, -1); // $input ã¯ãarray("red", "yellow") ã¨ãªãã¾ãã -array_splice($input, 1, count($input), "orange"); - // $input ã¯ãarray("red", "orange") ã¨ãªãã¾ãã -array_splice($input, -1, 1, array("black", "maroon")); - // $input ã¯ãarray("red", "green", - // "blue", "black", "maroon") ã¨ãªãã¾ãã +<![CDATA[ +$input = array ("red", "green", "blue", "yellow"); +array_splice ($input, 2); +// $input is now array ("red", "green") + +$input = array ("red", "green", "blue", "yellow"); +array_splice ($input, 1, -1); +// $input is now array ("red", "yellow") + +$input = array ("red", "green", "blue", "yellow"); +array_splice ($input, 1, count($input), "orange"); +// $input is now array ("red", "orange") + +$input = array ("red", "green", "blue", "yellow"); +array_splice ($input, -1, 1, array("black", "maroon")); +// $input is now array ("red", "green", +// "blue", "black", "maroon") +]]> </programlisting> </example> </para> <para> <function>array_slice</function>ãåç §ä¸ããã - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -1452,6 +1636,7 @@ <example> <title><function>array_sum</function> ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $a = array(2,4,6,8); echo "sum(a) = ".array_sum($a)."\n"; // åºå: sum(a) = 20 @@ -1459,9 +1644,16 @@ $b = array("a"=>1.2,"b"=>2.3,"c"=>3.4); echo "sum(b) = ".array_sum($b)."\n"; // åºå: sum(b) = 6.9 +]]> </programlisting> </example> </para> + <note> + <para> + 4.0.6ããåã®ãã¼ã¸ã§ã³ã®PHPã¯ã渡ãããé åèªä½ãä¿®æ£ããæååã + æ°å¤(ããã¯å¤ã«ããããå¤ãã®å ´åã¼ãã¨ãªãã¾ã)ã«å¤æãã¦ãã¾ããã + </para> + </note> </refsect1> </refentry> @@ -1481,21 +1673,69 @@ <para> <function>array_unique</function> ã¯ã <parameter>array</parameter>ãå ¥åã¨ããå¤ã«éè¤ã®ãªãæ°è¦é åã - è¿ãã¾ãããã¼ã¯ä¿æããããã¨ã«æ³¨æãã¦ä¸ããã + è¿ãã¾ãã + </para> + <para> + ãã¼ã¯ä¿æããããã¨ã«æ³¨æãã¦ä¸ããã + <function>array_unique</function>ã¯åå¤ã«é¢ããæåã®ãã¼ãä¿æãã + æ®ãã®ãã¼ãå ¨ã¦ç¡è¦ãã¾ãã </para> + <note> + <simpara> + <literal>(string) $elem1 === (string) $elem2</literal>ã®å ´åã®ã¿ + äºã¤ã®è¦ç´ ã¯çããã¨ã¿ãªããã¾ããè¨ãæããã¨ãæåå表ç¾ã + åãå ´åã¨ãªãã¾ãã + <!-- TODO: example of it... --> + </simpara> + <simpara> + æåã®è¦ç´ ã使ç¨ããã¾ãã + </simpara> + </note> + <warning> + <simpara> + ãã®é¢æ°ã¯ãPHP 4.0.4ã§ã¯ä½¿ç¨ã§ãã¾ãã! + <!-- TODO: when exactly was this broken?... --> + </simpara> + </warning> <para> <example> <title><function>array_unique</function> ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $input = array ("a" => "green", "red", "b" => "green", "blue", "red"); $result = array_unique ($input); +print_r($result); +// åºåã¯æ¬¡ã®ããã«ãªãã¾ã : +//Array +//( +// [a] => green +// [0] => red +// [1] => blue +//) +]]> </programlisting> </example> </para> <para> - ãã®ä¾ã«ããã<varname>$result</varname> ã¯ã - <literal>array ("a" =>"green", "red", "blue");</literal>ãæãã - ãã¨ã«ãªãã¾ãã + <example> + <title><function>array_unique</function>ã¨å</title> + <programlisting role="php"> +<![CDATA[ +$input = array (4,"4","3",4,3,"3"); +$result = array_unique ($input); +var_dump($result); + +/* åºå: +array(2) { + [0]=> + int(4) + [1]=> + string(1) "3" +} +*/ +]]> + </programlisting> + </example> </para> </refsect1> </refentry> @@ -1503,7 +1743,7 @@ <refentry id="function.array-unshift"> <refnamediv> <refname>array_unshift</refname> - <refpurpose> ä¸ã¤ä»¥ä¸ã®è¦ç´ ã é åã® æåã«å ãã </refpurpose> + <refpurpose> ä¸ã¤ä»¥ä¸ã®è¦ç´ ãé åã®æåã«å ãã </refpurpose> </refnamediv> <refsect1> <title>説æ</title> @@ -1512,10 +1752,8 @@ <funcdef>int <function>array_unshift</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>mixed <parameter>var</parameter></paramdef> - <paramdef> - <parameter> - <replaceable><optional>...</optional></replaceable> - </parameter> + <paramdef>mixed + <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -1531,22 +1769,19 @@ <example> <title><function>array_unshift</function>ã®ä¾</title> <programlisting role="php"> -$queue = array("p1", "p3"); -array_unshift($queue, "p4", "p5", "p6"); +<![CDATA[ +$queue = array ("p1", "p3"); +array_unshift ($queue, "p4", "p5", "p6"); +]]> </programlisting> </example> - ãã®ä¾ã«ããã$queue ã®è¦ç´ ã¯æ¬¡ã®5ã¤ã¨ãªãã¾ãã: "p4", "p5", "p6", - "p1", "p3" + ãã®ä¾ã«ããã<varname>$queue</varname>ã®è¦ç´ ã¯æ¬¡ã®5ã¤ã¨ãªãã¾ãã + : "p4", "p5", "p6", "p1", "p3" </para> <para> <function>array_shift</function>, <function>array_push</function>, <function>array_pop</function>ãåç §ä¸ããã - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -1572,15 +1807,37 @@ <example> <title><function>array_values</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $array = array("size" => "XL", "color" => "gold"); array_values($array); // array("XL", "gold")ãè¿ãã¾ã +]]> </programlisting> </example> - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> + </para> + <note> + <para> + ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã以ä¸ã®å®è£ ã¯PHP 3ã§ã + 使ç¨ãããã¨ãå¯è½ã§ãã + <example> + <title> + PHP 3ã¦ã¼ã¶ç¨ã®<function>array_values</function>ã®å®è£ + </title> + <programlisting role="php"> +<![CDATA[ +function array_values ($arr) { + $t = array(); + while (list($k, $v) = each ($arr)) { + $t[] = $v; + } + return $t; +} +]]> + </programlisting> + </example> + </para> + </note> + <para> + <function>array_keys</function>ãåç §ä¸ããã </para> </refsect1> </refentry> @@ -1599,22 +1856,31 @@ <funcdef>int <function>array_walk</function></funcdef> <paramdef>array <parameter>arr</parameter></paramdef> <paramdef>string <parameter>func</parameter></paramdef> - <paramdef>mixed <parameter>userdata</parameter></paramdef> + <paramdef>mixed + <parameter><optional>userdata</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <simpara> <parameter>arr</parameter>ã®åè¦ç´ ã«<parameter>func</parameter> - ã¨ããååã®é¢æ°ãé©ç¨ãã¾ãã + ã¨ããååã®ã¦ã¼ã¶å®ç¾©é¢æ°ãé©ç¨ãã¾ãã <parameter>func</parameter>ã«ã¯ãé åã®å¤ãæåã®å¼æ°ã¨ã㦠渡ãããé åã®ãã¼ã2çªç®ã®ãã©ã¡ã¼ã¿ã¨ãã¦æ¸¡ããã¾ãã <parameter>userdata</parameter>ãæå®ãããå ´åã3çªç®ã®å¼æ°ã¨ã㦠- ã¦ã¼ã¶ã¼é¢æ°ã«æ¸¡ããã¾ãã + ã¦ã¼ã¶ã¼é¢æ°ã«æ¸¡ããã¾ãã<parameter>func</parameter>ã¯ã¦ã¼ã¶å®ç¾©ã® + 颿°ã§ããå¿ è¦ãããããã¼ãã£ããªPHP颿°ã¯ä½¿ç¨ã§ãã¾ããã + ã¤ã¾ãã<function>array_walk</function>ãç´æ¥ + <function>str2lower</function>ã¨çµã¿åããããã¨ã¦ä½¿ç¨ãããã¨ã¯ + ã§ãã¾ãããã¾ãããã®é¢æ°ãç¨ãã¦ã¦ã¼ã¶å®ç¾©é¢æ°ãæ§ç¯ãããã®é¢æ° + ã弿°ã¨ãã¦æ¸¡ãå¿ è¦ãããã¾ãã + </simpara> + ¬e.func-callback; + <simpara> <parameter>func</parameter>ã2ã¤ã¾ãã¯3ã¤ãè¶ ãã弿°ãå¿ è¦ã¨ããå ´åã <parameter>userdata</parameter>ã®æå®ã«ãã£ã¦ã¯ã <function>array_walk</function>ã<parameter>func</parameter> - ãã³ã¼ã«ãã度ã«è¦åãçæããã¾ãã - ãããã®è¦åã¯ã<function>array_walk</function>ã®åã« - '@'ãã¼ã¯ãä»ããã + ãã³ã¼ã«ãã度ã«è¦åãçæããã¾ãããããã®è¦åã¯ã + <function>array_walk</function>ã®åã«'@'ãã¼ã¯ãä»ããã <function>error_reporting</function>ã使ç¨ãããã¨ã«ãã æå¶ããã¾ãã </simpara> @@ -1625,11 +1891,15 @@ 渡ãå¿ è¦ãããã¾ãããã®å ´åãé åã®è¦ç´ ã«å ãã夿´ã¯ãé åèªä½ ã«å¯¾ãã¦è¡ããã¾ãã </para> + <para> + <parameter>func</parameter>ã®ä¸ããé åãä¿®æ£ããã¨äºæ¸¬ã§ããªã + åä½ãå¼ãèµ·ããå¯è½æ§ãããã¾ãã + </para> </note> <note> <para> ãã¼åã³userdataã<parameter>func</parameter>ã«æ¸¡ãå¦çã¯ã - ãã¼ã¸ã§ã³ 4.0ã§è¿½å ããã¾ããã + ãã¼ã¸ã§ã³4.0ã§è¿½å ããã¾ããã </para> <para> PHP 4ã§ã¯ã<function>array_walk</function>ã§é åã®ãªã»ãããããã© @@ -1641,14 +1911,15 @@ <example> <title><function>array_walk</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); - -function test_alter (&$item1, $key, $prefix) { - $item1 = "$prefix: $item1"; + +function test_alter (&$item1, $key, $prefix) { + $item1 = "$prefix: $item1"; } function test_print ($item2, $key) { - echo "$key. $item2<br>\n"; + echo "$key. $item2<br>\n"; } array_walk ($fruits, 'test_print'); @@ -1656,6 +1927,7 @@ array_walk ($fruits, 'test_alter', 'fruit'); reset ($fruits); array_walk ($fruits, 'test_print'); +]]> </programlisting> </example> </para> @@ -1670,7 +1942,7 @@ <refnamediv> <refname>arsort</refname> <refpurpose> - 飿³ãã¼ã¨è¦ç´ ã¨ã®é¢ä¿ãç¶æãã¤ã¤é åãéé ã«ã½ã¼ããã¾ã + 飿³ãã¼ã¨è¦ç´ ã¨ã®é¢ä¿ãç¶æãã¤ã¤é åãéé ã«ã½ã¼ããã </refpurpose> </refnamediv> <refsect1> @@ -1680,9 +1952,7 @@ <funcdef>void <function>arsort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>int - <parameter> - <replaceable><optional>sort_flags</optional></replaceable> - </parameter> + <parameter><optional>sort_flags</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -1690,24 +1960,32 @@ ãã®é¢æ°ã¯ã飿³é åã«ããã¦åé åã®ãã¼ã¨è¦ç´ ã¨ã®é¢ä¿ãç¶æã㤠ã¤ã½ã¼ããè¡ãã¾ãããã®é¢æ°ã¯ã主ã«å®éã®è¦ç´ ã®ä¸¦ã³æ¹ãéè¦ã§ã ã飿³é åãã½ã¼ãããããã«ä½¿ããã¾ãã - <example> - <title><function>arsort</function>ã®ä¾</title> - <programlisting role="php"> + </para> + <example> + <title><function>arsort</function>ã®ä¾</title> + <programlisting role="php"> +<![CDATA[ $fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); arsort ($fruits); -reset($fruits); -while(list($key,$val)=each($fruits)) { +reset ($fruits); +while (list ($key, $val) = each ($fruits)) { echo "$key = $val\n"; } - </programlisting> - </example> - ãã®ä¾ã¯ã以ä¸ã®ããã«åºåããã¾ãã - <computeroutput> -fruits[a] = orange -fruits[d] = lemon -fruits[b] = banana -fruits[c] = apple - </computeroutput> +]]> + </programlisting> + <para> + ãã®ä¾ã¯ã以ä¸ã®ããã«åºåããã¾ãã + <screen> +<![CDATA[ +a = orange +d = lemon +b = banana +c = apple +]]> + </screen> + </para> + </example> + <para> fruitsã¯ã¢ã«ãã¡ãããã®éé ã«ã½ã¼ããããåè¦ç´ ã¨ãã¼ã¨ã®é¢ä¿ã¯ ç¶æããã¾ãã </para> @@ -1727,7 +2005,9 @@ <refentry id="function.asort"> <refnamediv> <refname>asort</refname> - <refpurpose>飿³ãã¼ã¨è¦ç´ ã¨ã®é¢ä¿ãç¶æãã¤ã¤é åãã½ã¼ããã¾ã</refpurpose> + <refpurpose> + 飿³ãã¼ã¨è¦ç´ ã¨ã®é¢ä¿ãç¶æãã¤ã¤é åãã½ã¼ããã + </refpurpose> </refnamediv> <refsect1> <title>説æ</title> @@ -1736,9 +2016,7 @@ <funcdef>void <function>asort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>int - <parameter> - <replaceable><optional>sort_flags</optional></replaceable> - </parameter> + <parameter><optional>sort_flags</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -1746,24 +2024,32 @@ ãã®é¢æ°ã¯ã飿³é åã«ããã¦åé åã®ãã¼ã¨è¦ç´ ã¨ã®é¢ä¿ãç¶æã㤠ã¤é åãã½ã¼ããã¾ãããã®é¢æ°ã¯ã主ã«å®éã®è¦ç´ ã®ä¸¦ã³æ¹ãéè¦ã§ ãã飿³é åãã½ã¼ãããããã«ä½¿ããã¾ãã - <example> - <title><function>asort</function>ã®ä¾</title> - <programlisting role="php"> + </para> + <example> + <title><function>asort</function>ã®ä¾</title> + <programlisting role="php"> +<![CDATA[ $fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); asort ($fruits); -reset($fruits); -while(list($key,$val)=each($fruits)) { - echo "$key = $val\n"; +reset ($fruits); +while (list ($key, $val) = each ($fruits)) { + echo "$key = $val\n"; } - </programlisting> - </example> - ãã®ä¾ã¯ã以ä¸ã®ããã«åºåããã¾ãã - <computeroutput> -fruits[c] = apple -fruits[b] = banana -fruits[d] = lemon -fruits[a] = orange - </computeroutput> +]]> + </programlisting> + <para> + ãã®ä¾ã¯ã以ä¸ã®ããã«åºåããã¾ãã + <screen> +<![CDATA[ +c = apple +b = banana +d = lemon +a = orange +]]> + </screen> + </para> + </example> + <para> fruitsã¯ã¢ã«ãã¡ãããã®æé ã«ã½ã¼ããããåè¦ç´ ã¨ãã¼ã¨ã®é¢ä¿ã¯ ç¶æããã¾ãã </para> @@ -1791,12 +2077,9 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>compact</function></funcdef> - <paramdef><parameter>string varname | array - varnames</parameter></paramdef> - <paramdef> - <parameter> - <replaceable><optional>...</optional></replaceable> - </parameter> + <paramdef>mixed <parameter>varname</parameter></paramdef> + <paramdef>mixed + <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> @@ -1820,6 +2103,7 @@ <example> <title><function>compact</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $city = "San Francisco"; $state = "CA"; $event = "SIGGRAPH"; @@ -1827,20 +2111,18 @@ $location_vars = array ("city", "state"); $result = compact ("event", "nothing_here", $location_vars); +]]> </programlisting> <para> - ãã®ä¾ã«ããã$resultã¯ãarray("event" => "SIGGRAPH", "city" - => "San Francisco", "state" => "CA")ã¨ãªãã¾ãã + ãã®ä¾ã«ããã<varname>$result</varname>ã¯ã + <literal>array + ("event" => "SIGGRAPH", "city" => "San Francisco", + "state" => "CA")</literal>ã¨ãªãã¾ãã </para> </example> </para> <para> <function>extract</function>ãåç §ä¸ããã - <note> - <para> - ãã®é¢æ°ã¯ãPHP 4.0ã§è¿½å ããã¾ããã - </para> - </note> </para> </refsect1> </refentry> @@ -1864,43 +2146,52 @@ ããã¾ããããï¼ã </para> <para> - 夿°ãé åã§ãªãå ´åã¯1ãè¿ãã¾ãã + 夿°ãé åã§ãªãå ´åã¯<literal>1</literal>ãè¿ãã¾ãã + (ä¾å¤: <literal>count(&null;)</literal> ã¯<literal>0</literal>ã¨ç価) </para> + <warning> + <para> + <function>count</function>ã¯ãã»ããããã¦ããªã夿°ã«é¢ãã¦0ãè¿ + ãã¾ããã夿°ã空ã®é åã¨ãã¦åæåããã¦ããå ´åã«ã0ãè¿ãã¾ãã + ãã夿°ãã»ããããã¦ãããã©ããã調ã¹ãã«ã¯ã + <function>isset</function>ã使ç¨ãã¦ãã ããã + </para> + </warning> <para> - 夿°ãã»ããããã¦ããªãå ´åã¯0ãè¿ãã¾ãã - <warning> - <para> - <function>count</function>ã¯ãã»ããããã¦ããªã夿°ã«é¢ãã¦0ãè¿ - ãã¾ããã夿°ã空ã®é åã¨ãã¦åæåããã¦ããå ´åã«ã0ãè¿ãã¾ãã - ãã夿°ãã»ããããã¦ãããã©ããã調ã¹ãã«ã¯ã - <function>isset</function>ã使ç¨ãã¦ãã ããã - </para> - </warning> + é åã®å®è£ ãPHPã§ã®ä½¿ç¨æ³ã«é¢ãã詳細ãªèª¬æã«ã¤ãã¦ã¯ããã¥ã¢ã«ã® + <link linkend="language.types.array">é å</link>ã®ã»ã¯ã·ã§ã³ã + åç §ä¸ããã </para> <para> <example> <title><function>count</function> ã®ä¾</title> <programlisting role="php"> + <!-- TODO: examples about count(null), count(false), count(object).. --> +<![CDATA[ $a[0] = 1; $a[1] = 3; $a[2] = 5; $result = count ($a); -// ä»£å ¥ãããè¦ç´ ã¯3ã§ããã$result 㯠2ã§ã¯ãªã3ã¨ãªã +// $result == 3 -$a[2] = 1; -$a[4] = ""; -$a[6] = 5; -$a[8] = 7; -$a[10] = 11; -$a[12] = ""; -$result = count ($a); -// ä»£å ¥ãããè¦ç´ ã¯4ã¤ãªã®ã§ã$result == 4 ã§ãã +$b[0] = 7; +$b[5] = 9; +$b[10] = 11; +$result = count ($b); +// $result == 3; +]]> </programlisting> </example> </para> + <note> + <para> + <function>sizeof</function>颿°ã¯ã<function>count</function> + ã¸ã®ã¨ã¤ãªã¢ã¹ã§ãã + </para> + </note> <para> - <function>sizeof</function>, <function>isset</function>, - <function>is_array</function>ãåç §ä¸ããã + <function>is_array</function>, <function>isset</function>, + <function>strlen</function>ãåç §ä¸ããã </para> </refsect1> </refentry> @@ -1908,7 +2199,7 @@ <refentry id="function.current"> <refnamediv> <refname>current</refname> - <refpurpose>é åå ã®ç¾å¨ã®è¦ç´ ãè¿ã</refpurpose> + <refpurpose>é åå ã®ã«ã¬ã³ãã®è¦ç´ ãè¿ã</refpurpose> </refnamediv> <refsect1> <title>説æ</title> @@ -1919,7 +2210,7 @@ </funcprototype> </funcsynopsis> <para> - åé åã¯ã"ç¾å¨"ã®è¦ç´ ã¸ã®ãã¤ã³ã¿ãæãã¦ãã¾ãã + åé åã¯ã"ã«ã¬ã³ã"ã®è¦ç´ ã¸ã®ãã¤ã³ã¿ãæãã¦ãã¾ãã ãã®ãã¤ã³ã¿ã¯ããã®é åã®æåã®è¦ç´ ãæãããã«åæåããã¾ãã </para> <para> @@ -1960,7 +2251,7 @@ </funcprototype> </funcsynopsis> <para> - é å<parameter>array</parameter>ãããæ¬¡ã®ãã£hå¤ã®ãã¢ãè¿ãã + é å<parameter>array</parameter>ãããæ¬¡ã®ãã¼ã¨å¤ã®ãã¢ãè¿ãã é åã«ã¼ã½ã«ãé²ãã¾ãããã®ãã¢ã¯ã4ã¤ã®è¦ç´ ãæã¤é åã§ã ããããã®è¦ç´ ã¯<emphasis>0</emphasis>,<emphasis>1</emphasis>, <emphasis>key</emphasis>,<emphasis>value</emphasis>ã¨ãããã¼ãæ @@ -1976,32 +2267,35 @@ <example> <title><function>each</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese"); -$bar = each( $foo ); +$bar = each ($foo); +]]> </programlisting> <para> <literal>$bar</literal>ã¯ãããã§ã¯ä»¥ä¸ã®ãã¼/å¤ã®ãã¢ãä¿æã ã¦ãã¾ãã <itemizedlist spacing="compact"> - <listitem><simpara>0 => 0</simpara></listitem> - <listitem><simpara>1 => 'bob'</simpara></listitem> - <listitem><simpara>key => 0</simpara></listitem> - <listitem><simpara>value => 'bob'</simpara></listitem> + <listitem><simpara>0 => 0</simpara></listitem> + <listitem><simpara>1 => 'bob'</simpara></listitem> + <listitem><simpara>key => 0</simpara></listitem> + <listitem><simpara>value => 'bob'</simpara></listitem> </itemizedlist> - <programlisting role="php"> +<![CDATA[ $foo = array ("Robert" => "Bob", "Seppo" => "Sepi"); $bar = each ($foo); +]]> </programlisting> </para> <para> <literal>$bar</literal>ã¯ããã®æç¹ã§ä»¥ä¸ã®ãã¼/å¤ã®ãã¢ãä¿æ ãã¦ãã¾ãã <itemizedlist spacing="compact"> - <listitem><simpara>0 => 'Robert'</simpara></listitem> - <listitem><simpara>1 => 'Bob'</simpara></listitem> - <listitem><simpara>key => 'Robert'</simpara></listitem> - <listitem><simpara>value => 'Bob'</simpara></listitem> + <listitem><simpara>0 => 'Robert'</simpara></listitem> + <listitem><simpara>1 => 'Bob'</simpara></listitem> + <listitem><simpara>key => 'Robert'</simpara></listitem> + <listitem><simpara>value => 'Bob'</simpara></listitem> </itemizedlist> </para> </example> @@ -2009,24 +2303,27 @@ <para> é常<function>each</function>ã¯ãé åã®èµ°æ»ãã?_ã£k <function>list</function>ã¨å ±ã«ä½¿ç¨ããã¾ããä¾ãã°ã - $HTTP_POST_VARSã®å ´åã¯æ¬¡ã®ãFã«ãªãã¾ãã + $HTTP_POST_VARSã®å ´åã¯æ¬¡ã®ããã«ãªãã¾ãã <example> <title> <function>each</function>ã«ãã$HTTP_POST_VARSãèµ°æ»ãã </title> <programlisting role="php"> -echo "POSTã¡ã½ããã«ããåãæ¸¡ãããå¤ï¼<br>"; +<![CDATA[ +echo "POSTã¡ã½ããã«ããåãæ¸¡ãããå¤ï¼<br>"; reset ($HTTP_POST_VARS); while (list ($key, $val) = each ($HTTP_POST_VARS)) { - echo "$key => $val<br>"; + echo "$key => $val<br>"; } +]]> </programlisting> </example> </para> <para> <function>each</function>ãå®è¡ããå¾ãé åã«ã¼ã½ã«ã¯ã - é åã®æ¬¡ã®è¦ç´ ã«ç§»åã~ããé åã®æçµè¦ç´ ã«ã«ã¼ã½ã«ãããå ´åã¯ã - æçµè¦ç´ ã«ã¨ã©ã¾ãã¾ãã + é åã®æ¬¡ã®è¦ç´ ã«ç§»åãã¾ããé åã®æçµè¦ç´ ã«ã«ã¼ã½ã«ãããå ´åã¯ã + æçµè¦ç´ ã«ã¨ã©ã¾ãã¾ããeachã使ç¨ãã¦é åãèµ°æ»ããã«ã¯ã + <function>reset</function>ã使ç¨ããå¿ è¦ãããã¾ãã </para> <para> <function>key</function>ã<function>list</function>ã @@ -2178,8 +2475,9 @@ <example> <title><function>extract</function>ã®ä¾</title> <programlisting role="php"> -<?php - +<![CDATA[ +<?php + /* $var_array ã¯wddx_deserializeããè¿ãããé åã¨ä»®å®ãã¾ã */ $size = "large"; @@ -2191,21 +2489,26 @@ print "$color, $size, $shape, $wddx_size\n"; ?> +]]> </programlisting> </example> </para> <para> ä¸è¨ã®ä¾ã®çµæã¯ä»¥ä¸ã¨ãªãã¾ãã <programlisting> +<![CDATA[ blue, large, sphere, medium +]]> </programlisting> </para> <para> - EXTR_PREFIX_SAMEãæå®ããããã$sizeã¯ä¸æ¸ããããã$wddx_size - ã使ããã¾ãã + EXTR_PREFIX_SAMEãæå®ããããã<varname>$size</varname>ã¯ä¸æ¸ã + ãããã<varname>$wddx_size</varname>ã使ããã¾ãã EXTR_SKIPãæå®ãããå ´åã$wddx_sizeã¯ä½æããã¾ãããEXTR_OVERWRITE - ã®å ´åã¯ã$sizeã®å¤ã¯"medium"ã¨ãªãã¾ããEXTR_PREFIX_ALLã®å ´å㯠- æ°è¦ã®å¤æ° $wddx_color, $wddx_size, $wddx_shapeã使ããã¾ãã + ã®å ´åã¯ã<varname>$size</varname>ã®å¤ã¯"medium"ã¨ãªãã¾ãã + EXTR_PREFIX_ALLã®å ´åã¯æ°è¦ã®å¤æ°<varname>$wddx_color</varname>, + <varname>$wddx_size</varname>, <varname>$wddx_shape</varname> + ã使ããã¾ãã </para> <para> 飿³é åã使ç¨ããå¿ è¦ããããæ°å¤æ·»åã®é åã«ã¯çµæã¯åºåããã¾ @@ -2237,8 +2540,7 @@ <para> <parameter>haystack</parameter>ã§ <parameter>needle</parameter>ãæ¤ç´¢ããé åã«ããããã£ãå ´åã« - &true;ããã以å¤ã®å ´åã¯ã - &false;ãè¿ãã¾ãã + &true;ããã以å¤ã®å ´åã¯ã&false;ãè¿ãã¾ãã </para> <para> 3çªç®ã®ãã©ã¡ã¼ã¿<parameter>strict</parameter>ã @@ -2246,14 +2548,25 @@ <function>in_array</function>ã¯ã<parameter>haystack</parameter> ã®ä¸ã® <parameter>needle</parameter>ã®åã確èªãã¾ãã </para> + <note> + <para> + <parameter>needle</parameter>ãæååã®å ´åãæ¯è¼ã®éã«å¤§æåå°æå + ã¯åºå¥ããã¾ãã + </para> + </note> <para> <example> <title><function>in_array</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $os = array ("Mac", "NT", "Irix", "Linux"); -if (in_array ("Irix", $os)){ +if (in_array ("Irix", $os)) { print "Got Irix"; } +if (in_array ("mac", $os)) { # in_array()ã¯å¤§æåå°æåãåºå¥ãããã失æ + print "Got mac"; +} +]]> </programlisting> </example> </para> @@ -2261,18 +2574,20 @@ <example> <title>strictãæå®ãã<function>in_array</function>ã®ä¾</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = array('1.10', 12.4, 1.13); if (in_array('12.4', $a, TRUE)) - echo "'12.4' found with strict check\n"; + echo "'12.4' found with strict check\n"; if (in_array(1.13, $a, TRUE)) - echo "1.13 found with strict check\n"; -?> + echo "1.13 found with strict check\n"; +?> -// ãã®ä¾ã¯ä»¥ä¸ã®ãããªåºåã¨ãªãã¾ãã +// 以ä¸ã®ãããªåºåã¨ãªãã¾ãã 1.13 found with strict check +]]> </programlisting> </example> </para> @@ -2296,14 +2611,15 @@ <funcdef>mixed <function>array_search</function></funcdef> <paramdef>mixed <parameter>needle</parameter></paramdef> <paramdef>array <parameter>haystack</parameter></paramdef> - <paramdef>bool <parameter>strict</parameter></paramdef> + <paramdef>bool + <parameter><optional>strict</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> <parameter>haystack</parameter>ã«ãã㦠<parameter>needle</parameter>ãæ¤ç´¢ããé åä¸ã«è¦ä»ãã£ãå ´åã«ã - ã®ãã¼ãè¿ãã¾ããããã§ãªãå ´åã«&false;ãè¿ã - ã¾ãã + ã®ãã¼ãè¿ãã¾ããããã§ãªãå ´åã«&false;ãè¿ãã¾ãã </para> <para> 3çªç®ã®ãã©ã¡ã¼ã¿<parameter>strict</parameter>ã @@ -2312,6 +2628,7 @@ <parameter>haystack</parameter>ã®ä¸ã«ãã <parameter>needle</parameter>ã®åã確èªãã¾ãã </para> + &return.falseproblem; <para> <function>in_array</function>ãåç §ä¸ããã </para> @@ -2366,21 +2683,31 @@ <example> <title><function>krsort</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); krsort ($fruits); reset($fruits); while(list($key,$val)=each($fruits)) { echo "$key -> $val\n"; } +]]> </programlisting> </example> + </para> + <para> ãã®ä¾ã®åºåã¯æ¬¡ã®ããã«ãªãã¾ãã - <computeroutput> -fruits[d] = lemon -fruits[c] = apple -fruits[b] = banana -fruits[a] = orange - </computeroutput> + </para> + <para> + <informalexample> + <programlisting> +<![CDATA[ +d = lemon +c = apple +b = banana +a = orange +]]> + </programlisting> + </informalexample> </para> <para> ãªãã·ã§ã³ã®ãã©ã¡ã¼ã¿<parameter>sort_flags</parameter>ã«ããã½ã¼ @@ -2390,7 +2717,7 @@ <simpara> <function>asort</function>, <function>arsort</function>, <function>ksort</function>, <function>sort</function>, - <function>rsort</function>ãåç §ä¸ããã + <function>natsort</function>, <function>rsort</function>ãåç §ä¸ããã </simpara> </refsect1> </refentry> @@ -2419,28 +2746,37 @@ <example> <title><function>ksort</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); ksort ($fruits); -reset($fruits); -while(list($key,$val)=each($fruits)) { - echo "$key -> $val\n"; +reset ($fruits); +while (list ($key, $val) = each ($fruits)) { + echo "$key = $val\n"; } +]]> </programlisting> </example> + </para> + <para> ãã®ä¾ã§ã¯ä»¥ä¸ã®ããã«åºåãè¡ããã¾ãã - <computeroutput> -fruits[a] = orange -fruits[b] = banana -fruits[c] = apple -fruits[d] = lemon - </computeroutput> + </para> + <para> + <informalexample> + <programlisting> +<![CDATA[ +a = orange +b = banana +c = apple +d = lemon +]]> + </programlisting> + </informalexample> </para> <para> ãªãã·ã§ã³ã®ãã©ã¡ã¼ã¿<parameter>sort_flags</parameter>ã«ããã½ã¼ ãã®åä½ãä¿®æ£å¯è½ã§ãã詳細ã«ã¤ãã¦ã¯ã<function>sort</function> ãåç §ä¸ããã </para> - <simpara> <function>asort</function>, <function>arsort</function>, <function>sort</function>, <function>natsort</function>, @@ -2476,25 +2812,27 @@ <example> <title><function>list</function>ã®ä¾</title> <programlisting role="php"> -<table> - <tr> - <th>徿¥å¡å</th> - <th>給ä¸</th> - </tr> - -<?php - -$result = mysql_query ($conn, "SELECT id, name, salary FROM employees"); -while (list($id, $name, $salary) = mysql_fetch_row($result)) { - print(" <tr>\n". - " <td><a href=\"info.php3?id=$id\">$name</a></td>\n". - " <td>$salary</td>\n". - " </tr>\n"); +<![CDATA[ +<table> + <tr> + <th>社å¡å</th> + <th>給æ</th> + </tr> + +<?php + +$result = mysql_query ("SELECT id, name, salary FROM employees",$conn); +while (list ($id, $name, $salary) = mysql_fetch_row ($result)) { + print (" <tr>\n". + " <td><a href=\"info.php3?id=$id\">$name</a></td>\n". + " <td>$salary</td>\n". + " </tr>\n"); } ?> -</table> +</table> +]]> </programlisting> </example> </para> @@ -2531,8 +2869,9 @@ <example> <title><function>natsort</function>ã®ä¾</title> <programlisting role="php"> -$array1 = $array2 = array ("img12.png","img10.png","img2.png","img1.png"); - +<![CDATA[ +$array1 = $array2 = array ("img12.png", "img10.png", "img2.png", "img1.png"); + sort($array1); echo "Standard sorting\n"; print_r($array1); @@ -2540,6 +2879,7 @@ natsort($array2); echo "\nNatural order sorting\n"; print_r($array2); +]]> </programlisting> </example> </para> @@ -2549,6 +2889,7 @@ <para> <informalexample> <programlisting> +<![CDATA[ Standard sorting Array ( @@ -2566,6 +2907,7 @@ [1] => img10.png [0] => img12.png ) +]]> </programlisting> </informalexample> ããè©³ç´°ãªæ å ±ã«ã¤ãã¦ã¯ãMartin Poolã®<ulink @@ -2733,16 +3075,56 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>range</function></funcdef> - <paramdef>int <parameter>low</parameter></paramdef> - <paramdef>int <parameter>high</parameter></paramdef> + <paramdef>mixed <parameter>low</parameter></paramdef> + <paramdef>mixed <parameter>high</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>range</function>ã¯ã<parameter>low</parameter>ãã <parameter>high</parameter>ã¾ã§ã®æ´æ°ã®é åãè¿ãã¾ãã + low > highã®å ´åãé çªã¯highããlowã¨ãªãã¾ãã </para> + <example> + <title><function>range</function>ã®ä¾</title> + <programlisting role="php"> +<![CDATA[ +foreach(range(0, 9) as $number) { + echo $number; +} +foreach(range('a', 'z') as $letter) { + echo $letter; +} +foreach(range('z', 'a') as $letter) { + echo $letter; +} +]]> + </programlisting> + </example> + <note> + <para> + 4.1.0ããåã®ãã¼ã¸ã§ã³ã§ã¯ã<function>range</function>颿°ã¯ã + æé ã®æ´æ°é åã®ã¿ãçæãã¾ãããæåã·ã¼ã±ã³ã¹åã³éé ã®é å + ã®ãµãã¼ãã4.1.0ã§è¿½å ããã¾ããã + </para> + <example> + <title>ãã¯ãªã¡ã³ãããç¯å²åã³æåã·ã¼ã±ã³ã¹ã®æ¨¡æ¬</title> + <programlisting role="php"> +<![CDATA[ +# ç¯å²ã®é çªãå転ããããã«array_reverseã使ç¨å¯è½ +foreach(array_reverse(range(0,9)) as $number) { + echo $number; +} + +# chr()ãç¨ãã¦æ´æ°ãæåã«å¤æããããã«array_map()ã使ç¨å¯è½ +foreach(array_map('chr', range(ord('a'),ord('z'))) as $character) { + echo $character; +} +]]> + </programlisting> + </example> + </note> <para> - 使ç¨ä¾ã«ã¤ãã¦ã¯ã<function>shuffle</function>ãåç §ä¸ããã + ãã®ä»ã®ä½¿ç¨ä¾ã«ã¤ãã¦ã¯ã<function>shuffle</function>ãåç §ä¸ããã </para> </refsect1> </refentry> @@ -2770,12 +3152,8 @@ <function>reset</function>ã¯ãé åã®æåã®è¦ç´ ã®å¤ãè¿ãã¾ãã </para> <para> - <function>current</function>, - <function>each</function>, - <function>next</function> - <function>prev</function>, - <function>reset</function> - ãåç §ä¸ããã + <function>current</function>, <function>each</function>, + <function>next</function>, <function>prev</function>ãåç §ä¸ããã </para> </refsect1> </refentry> @@ -2803,21 +3181,33 @@ <example> <title><function>rsort</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $fruits = array ("lemon", "orange", "banana", "apple"); rsort ($fruits); -reset($fruits); -while(list($key,$val)=each($fruits)) { - echo "$key -> $val\n"; +reset ($fruits); +while (list ($key, $val) = each ($fruits)) { + echo "$key = $val\n"; } +]]> </programlisting> </example> - ãã®ä¾ã§ã¯ä»¥ä¸ã®ããã«è¡¨ç¤ºãã¾ãã - <computeroutput> -fruits[0] = orange -fruits[1] = lemon -fruits[2] = banana -fruits[3] = apple - </computeroutput> + </para> + <para> + ãã®ä¾ã®åºåã¯ä»¥ä¸ã®ããã«ãªãã¾ãã + </para> + <para> + <informalexample> + <programlisting> +<![CDATA[ +0 = orange +1 = lemon +2 = banana +3 = apple +]]> + </programlisting> + </informalexample> + </para> + <para> fruitsã¯ã¢ã«ãã¡ãããã®éé ã«ã½ã¼ãããã¾ããã </para> <para> @@ -2853,21 +3243,21 @@ <example> <title><function>shuffle</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ $numbers = range (1,20); -srand ((double)microtime()*1000000); +srand ((float)microtime()*1000000); shuffle ($numbers); -while (list(, $number) = each ($numbers)) { +while (list (, $number) = each ($numbers)) { echo "$number "; } +]]> </programlisting> </example> </para> <para> <function>arsort</function>,<function>asort</function>, <function>ksort</function>,<function>rsort</function>, - <function>natsort</function>, <function>natcasesort</function>, - <function>sort</function>,<function>usort</function>, - <function>uksort</function>ãåç §ä¸ããã + <function>sort</function>,<function>usort</function>ãåç §ä¸ããã </para> </refsect1> </refentry> @@ -2919,29 +3309,33 @@ <example> <title><function>sort</function>ã®ä¾</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $fruits = array ("lemon", "orange", "banana", "apple"); sort ($fruits); reset ($fruits); -while (list ($key,$val) = each ($fruits)) { - echo "fruits[".$key."] = ".$val; +while (list ($key, $val) = each ($fruits)) { + echo "fruits[".$key."] = ".$val."\n"; } - -?> + +?> +]]> </programlisting> </example> </para> <para> - ãã®ä¾ã§ã¯ä»¥ä¸ã®ããã«è¡¨ç¤ºãã¾ãã + ãã®ä¾ã®åºåã¯ä»¥ä¸ã®ããã«ãªãã¾ãã </para> <para> <informalexample> <programlisting> +<![CDATA[ fruits[0] = apple fruits[1] = banana fruits[2] = lemon fruits[3] = orange +]]> </programlisting> </informalexample> </para> @@ -3013,6 +3407,7 @@ åç §ä¸ããã </para> </note> + ¬e.func-callback; <para> <function>usort</function>, <function>uksort</function>, <function>sort</function>, <function>asort</function>, @@ -3043,10 +3438,11 @@ ãã®é¢æ°ã¯ãã¦ã¼ã¶ã¼å®ç¾©ã®æ¯è¼é¢æ°ãç¨ãã¦é åã®ãã¼ãã½ã¼ããã¾ãã ã½ã¼ããããé åãè¤éãªåºæºã§ã½ã¼ãããå¿ è¦ãããå ´åã«ã¯ã ãã®é¢æ°ã使ãå¿ è¦ãããã¾ãã - - <example> - <title><function>uksort</function>ã®ä¾</title> - <programlisting role="php"> + </para> + <example> + <title><function>uksort</function>ã®ä¾</title> + <programlisting role="php"> +<![CDATA[ function cmp ($a, $b) { if ($a == $b) return 0; return ($a > $b) ? -1 : 1; @@ -3059,21 +3455,30 @@ while (list ($key, $value) = each ($a)) { echo "$key: $value\n"; } - </programlisting> - </example> +]]> + </programlisting> + </example> + <para> ãã®ä¾ã«ããåºåã¯ä»¥ä¸ã®ããã«ãªãã¾ãã - <computeroutput> + </para> + <para> + <informalexample> + <programlisting> +<![CDATA[ 20: twenty 10: ten 4: four 3: three - </computeroutput> +]]> + </programlisting> + </informalexample> </para> + ¬e.func-callback; <para> <function>usort</function>, <function>uasort</function>, <function>sort</function>, <function>asort</function>, <function>arsort</function>, <function>ksort</function>, - <function>rsort</function>, <function>natsort</function> + <function>natsort</function>, <function>rsort</function> ãåç §ä¸ããã </para> </refsect1> @@ -3092,7 +3497,7 @@ <funcprototype> <funcdef>void <function>usort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> - <paramdef>function <parameter>cmp_function</parameter></paramdef> + <paramdef>string <parameter>cmp_function</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -3101,13 +3506,20 @@ ãã®é¢æ°ã使ç¨ããã¹ãã§ãã </para> <para> - æ¯è¼é¢æ°ã¯ãæåã®å¼æ°ãäºçªç®ã®å¼æ°ããå°ãããçããã大ããå ´åã« - ããããã¼ãæªæºãã¼ãã«çãããã¼ããã大ããæ´æ°ãè¿ãã¾ããäºã¤ã® - ã¡ã³ãã¼ã®?è¼çµæãçããã¨ãªã£ãå ´åãã½ã¼ããããé åã®é çªã¯å®ç¾© - ããã¾ããã + æ¯è¼é¢æ°ã¯ãæåã®å¼æ°ã2çªç®ã®å¼æ°ããå°ããããçãããã大ãã + å ´åã«ãããããã¼ãæªæºãã¼ãã«çãããã¼ããã大ããæ´æ°ãè¿ã + å¿ è¦ãããã¾ãã2ã¤ã®ã¡ã³ãã¼ã®æ¯è¼çµæãçããã¨ãªã£ãå ´åã + ã½ã¼ããããé åã®é çªã¯å®ç¾©ããã¾ããã + </para> + <para> + æ¯è¼é¢æ°ã¨ãã¦ãããªãã¸ã§ã¯ãã®ã¡ã³ãã¼é¢æ°ã使ç¨ãããã¨ãå¯è½ã§ãã + 以ä¸ã®ä¾3ãåç §ä¸ããã + </para> + <para> <example> <title><function>usort</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ function cmp ($a, $b) { if ($a == $b) return 0; return ($a > $b) ? -1 : 1; @@ -3120,6 +3532,7 @@ while (list ($key, $value) = each ($a)) { echo "$key: $value\n"; } +]]> </programlisting> </example> </para> @@ -3129,24 +3542,27 @@ <para> <informalexample> <programlisting> +<![CDATA[ 0: 6 1: 5 2: 3 3: 2 4: 1 +]]> </programlisting> </informalexample> </para> <note> <para> ãã¡ããããã®ãããªç°¡åãªä¾ã§ã¯<function>rsort</function>颿° - ã®æ¹ããã©iãfãã¾ãã + ã®æ¹ãããé©å½ã§ãã </para> </note> <para> <example> <title>夿¬¡å é åã使ç¨ãã<function>usort</function>ã®ä¾</title> <programlisting role="php"> +<![CDATA[ function cmp ($a, $b) { return strcmp($a["fruit"],$b["fruit"]); } @@ -3160,6 +3576,7 @@ while (list ($key, $value) = each ($fruits)) { echo "\$fruits[$key]: " . $value["fruit"] . "\n"; } +]]> </programlisting> </example> </para> @@ -3173,26 +3590,76 @@ <para> <informalexample> <programlisting> +<![CDATA[ $fruits[0]: apples $fruits[1]: grapes $fruits[2]: lemons +]]> </programlisting> </informalexample> </para> <para> - <warning> - <para> - (Solarisã·ã¹ãã ã®ãããª)ããã¤ãã®Cã©ã¤ãã©ãªã«å«ã¾ãã - quicksort颿°ã¯ãæ¯è¼é¢æ°ãé©å½ãªå¤ãè¿ããªãå ´åã«PHPãã¯ã©ã - ã·ã¥ãããå¯è½æ§ãããã¾ãã - </para> - </warning> + <example> + <title> + <function>usort</function>ã§ãªãã¸ã§ã¯ãã®ã¡ã³ã颿°ã使ç¨ããä¾ + </title> + <programlisting role="php"> +<![CDATA[ +class TestObj { + var $name; + + function TestObj($name) + { + $this->name = $name; + } + + /* éçãªæ¯è¼é¢æ°: */ + function cmp_obj($a, $b) + { + $al = strtolower($a->name); + $bl = strtolower($b->name); + if ($al == $bl) return 0; + return ($al > $bl) ? +1 : -1; + } +} + +$a[] = new TestObj("c"); +$a[] = new TestObj("b"); +$a[] = new TestObj("d"); + +uasort($a, array ("TestObj", "cmp_obj")); + +foreach ($a as $item) { + print $item->name."\n"; +} +]]> + </programlisting> + </example> + </para> + <para> + ãã®ä¾ã®åºåã¯ä»¥ä¸ã®ããã«ãªãã¾ãã + </para> + <para> + <informalexample> + <programlisting> +b +c +d + </programlisting> + </informalexample> </para> + <warning> + <para> + (Solarisã·ã¹ãã ã®ãããª)ããã¤ãã®Cã©ã¤ãã©ãªã«å«ã¾ãã + quicksort颿°ã¯ãæ¯è¼é¢æ°ãé©å½ãªå¤ãè¿ããªãå ´åã«PHPãã¯ã©ã + ã·ã¥ãããå¯è½æ§ãããã¾ãã + </para> + </warning> <para> <function>uasort</function>, <function>uksort</function>, <function>sort</function>, <function>asort</function>, <function>arsort</function>, <function>ksort</function>, - <function>rsort</function>, <function>natsort</function> + <function>natsort</function>, <function>rsort</function> ãåç §ä¸ããã </para> </refsect1>