 |
 |
 |
 |
|
|
Date: 07/02/00
- Next message: Egon Schmid: "[PHP-DOC] cvs: phpdoc /it/functions array.xml"
- Previous message: eschmid+sic <email protected>: "Re: [PHP-DOC] suggestion about functions"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
hirokawa Sun Jul 2 01:58:03 2000 EDT
Modified files:
/phpdoc/en/functions array.xml
/phpdoc/ja/functions array.xml i18n.xml strings.xml
/phpdoc/ja/language control-structures.xml
Log:
some cosmetic changes.
Index: phpdoc/en/functions/array.xml
diff -u phpdoc/en/functions/array.xml:1.8 phpdoc/en/functions/array.xml:1.9
--- phpdoc/en/functions/array.xml:1.8 Fri Jun 30 14:44:08 2000
+++ phpdoc/en/functions/array.xml Sun Jul 2 01:58:02 2000
@@ -1895,7 +1895,7 @@
sorted array is undefined.
<example>
<title><function>usort</function> example</title>
- <programlisting>
+ <programlisting role="php">
function cmp ($a, $b) {
if ($a == $b) return 0;
return ($a > $b) ? -1 : 1;
Index: phpdoc/ja/functions/array.xml
diff -u phpdoc/ja/functions/array.xml:1.3 phpdoc/ja/functions/array.xml:1.4
--- phpdoc/ja/functions/array.xml:1.3 Sat Jun 24 00:38:44 2000
+++ phpdoc/ja/functions/array.xml Sun Jul 2 01:58:02 2000
@@ -1,4 +1,3 @@
-
<reference id="ref.array">
<title>配列関数</title>
<titleabbrev>Arrays</titleabbrev>
@@ -16,38 +15,37 @@
<varargs/>
</funcprototype>
</funcsynopsis>
- <para>
- パラメータの配列を返します。パラメータには、<literal>=>
- </literal>演算子によりインデックスを与えることもできます。
-
- <note>
<para>
- <function>array</function> は、実際にはリテラル配列を表現するための
- 言語構成要素であり、通常の関数ではありません。
+ パラメータの配列を返します。パラメータには、
+ <literal>=></literal>演算子によりインデックスを指定することもできます。
+ <note>
+ <para>
+ <function>array</function>は、実際にはリテラル配列を表現するための
+ 言語構成要素であり、通常の関数ではありません。
+ </para>
+ </note>
</para>
- </note></para>
-
<para>
- 以下の例では、2 次元配列の生成方法、連想配列のキーの指定方法、
- および通常の配列において添字番号をスキップし、それに続く
- 要素にアクセスする方法についてご紹介しています。
-
+ 以下の例では、2 次元配列の生成方法、連想配列のキーの指定方法、
+ および通常の配列において添字番号をスキップし、それに続く
+ 要素にアクセスする方法についてご紹介しています。
<example>
- <title><function>array</function> の例</title>
- <programlisting>
-$fruits = array(
- "fruits" => array("a"=>"orange","b"=>"banana","c"=>"apple"),
+ <title><function>array</function>の例</title>
+ <programlisting role="php">
+$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>
-
+ </programlisting>
+ </example>
+ </para>
<para>
- <function>list</function> も参照下さい。</para>
+ <function>list</function>も参照下さい。
+ </para>
</refsect1>
</refentry>
-
<refentry id="function.array-count-values">
<refnamediv>
<refname>array_count_values</refname>
@@ -61,64 +59,62 @@
<paramdef>array <parameter>input</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>array_count_values</function> は、
- 配列 <parameter>input</parameter> の値をキーとし、
- <parameter>input</parameter> におけるその値の出現回数を値とした
- 配列を返します。</para>
-
+ <function>array_count_values</function>は、
+ 配列<parameter>input</parameter>の値をキーとし、
+ <parameter>input</parameter>におけるその値の出現回数を値とした
+ 配列を返します。
+ </para>
<para>
<example>
- <title><function>array_count_values</function> の例</title>
- <programlisting>
-$array = array(1,"hello",1,"world","hello");
-array_count_values($array); // array(1=>2, "hello"=>2, "world"=>1) を返します
+ <title><function>array_count_values</function>の例</title>
+ <programlisting role="php">
+$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>
+ <note>
+ <para>
+ この関数は、PHP 4.0で追加されました。
+ </para>
+ </note>
+ </para>
</refsect1>
</refentry>
- <refentry id="function.array-flip">
- <refnamediv>
- <refname>array_flip</refname>
- <refpurpose>配列の値を逆順にする</refpurpose>
- </refnamediv>
- <refsect1>
- <title>説明</title>
- <funcsynopsis>
+ <refentry id="function.array-flip">
+ <refnamediv>
+ <refname>array_flip</refname>
+ <refpurpose>配列の値を逆順にする</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
<funcprototype>
- <funcdef>array <function>array_flip</function></funcdef>
- <paramdef>array <parameter>trans</parameter></paramdef>
+ <funcdef>array <function>array_flip</function></funcdef>
+ <paramdef>array <parameter>trans</parameter></paramdef>
</funcprototype>
- </funcsynopsis>
-
- <para>
- <function>array_flip</function> は、配列を逆順にして返します。
- </para>
- <para>
- <example>
- <title><function>array_flip</function> の例</title>
- <programlisting role="php">
- $trans = array_flip ($trans);
- $original = strtr ($str, $trans);
- </programlisting>
- </example>
-
- <note>
- <para>
- この関数は、PHP 4.0 で追加されました。
- </para>
- </note></para>
-
- </refsect1>
- </refentry>
-
+ </funcsynopsis>
+ <para>
+ <function>array_flip</function> は、配列を逆順にして返します。
+ </para>
+ <para>
+ <example>
+ <title><function>array_flip</function>の例</title>
+ <programlisting role="php">
+$trans = array_flip ($trans);
+$original = strtr ($str, $trans);
+ </programlisting>
+ </example>
+ <note>
+ <para>
+ この関数は、PHP 4.0で追加されました。
+ </para>
+ </note>
+ </para>
+ </refsect1>
+ </refentry>
+
<refentry id="function.array-keys">
<refnamediv>
<refname>array_keys</refname>
@@ -131,39 +127,41 @@
<funcdef>array <function>array_keys</function></funcdef>
<paramdef>array <parameter>input</parameter></paramdef>
<paramdef>mixed
- <parameter><optional>search_value</optional></parameter></paramdef>
+ <parameter>
+ <optional>search_value</optional>
+ </parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>array_keys</function> は、配列 <parameter>input</parameter> から
- 全てのキー(数値および文字列)を返します。</para>
-
+ <function>array_keys</function>は、配列<parameter>input</parameter>から
+ 全てのキー(数値および文字列)を返します。
+ </para>
<para>
- オプション <parameter>search_value</parameter> が指定された場合、
+ オプション<parameter>search_value</parameter>が指定された場合、
指定した値に関するキーのみが返されます。指定されない場合は、
- <parameter>input</parameter> から全てのキーが返されます。</para>
-
- <para>
+ <parameter>input</parameter>から全てのキーが返されます。
+ </para>
+ <para>
<example>
- <title><function>array_keys</function> の例</title>
- <programlisting>
+ <title><function>array_keys</function>の例</title>
+ <programlisting role="php">
$array = array(0 => 100, "color" => "red");
-array_keys($array); // array(0, "color") を返します
+array_keys($array); // array(0, "color")を返します
</programlisting>
- </example></para>
-
+ </example>
+ </para>
<para>
<function>array_values</function>も参照下さい。
-
- <note>
- <para>
- この関数は、PHP 4.0 で追加されました。 </para>
- </note></para>
+ <note>
+ <para>
+ この関数は、PHP 4.0で追加されました。
+ </para>
+ </note>
+ </para>
</refsect1>
</refentry>
-
<refentry id="function.array-merge">
<refnamediv>
<refname>array_merge</refname>
@@ -181,86 +179,82 @@
</paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>array_merge</function> は、前の配列の後ろに配列を追加することに
- より、二つ以上の配列の要素をマージし、得られた配列を返します。</para>
-
+ <function>array_merge</function>は、前の配列の後ろに配列を追加することに
+ より、二つ以上の配列の要素をマージし、得られた配列を返します。
+ </para>
<para>
- 入力配列が同じキー文字列を有していた場合、そのキーに関する後に指定された
- 値が、前の値を上書きします。しかし、配列が同じ添字番号を有していても
- 値は加算されるため、このようなことは起きません。</para>
-
+ 入力配列が同じキー文字列を有していた場合、そのキーに関する後に指定された
+ 値が、前の値を上書きします。しかし、配列が同じ添字番号を有していても
+ 値は加算されるため、このようなことは起きません。
+ </para>
<para>
<example>
- <title><function>array_merge</function> の例</title>
- <programlisting>
-$array1 = array("color" => "red", 2, 4);
-$array2 = array("a", "b", "color" => "green", "shape" => "trapezoid");
-array_merge($array1, $array2);
+ <title><function>array_merge</function>の例</title>
+ <programlisting role="php">
+$array1 = array ("color" => "red", 2, 4);
+$array2 = array ("a", "b", "color" => "green", "shape" => "trapezoid", 4);
+array_merge ($array1, $array2);
</programlisting>
<para>
- 返される配列は、array("color" => "green", 2, 4, "a",
- "b", "shape" => "trapezoid")
- となります。</para>
+ 返される配列は、array("color" => "green", 2, 4, "a",
+ "b", "shape" => "trapezoid", 4)となります。
+ </para>
</example>
-
- <note>
- <para>
- この関数は、PHP 4.0 で追加されました。 </para>
- </note></para>
- </refsect1>
- </refentry>
-
- <refentry id="function.array-pad">
- <refnamediv>
- <refname>array_pad</refname>
- <refpurpose>Pad array to the specified length with a value</refpurpose>
- </refnamediv>
- <refsect1>
- <title>説明</title>
- <funcsynopsis>
+ <note>
+ <para>
+ この関数は、PHP 4.0で追加されました。
+ </para>
+ </note>
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.array-pad">
+ <refnamediv>
+ <refname>array_pad</refname>
+ <refpurpose>指定長、指定した値で配列を埋める</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
<funcprototype>
- <funcdef>array <function>array_pad</function></funcdef>
- <paramdef>array <parameter>input</parameter></paramdef>
- <paramdef>int <parameter>pad_size</parameter></paramdef>
- <paramdef>mixed <parameter>pad_value</parameter></paramdef>
+ <funcdef>array <function>array_pad</function></funcdef>
+ <paramdef>array <parameter>input</parameter></paramdef>
+ <paramdef>int <parameter>pad_size</parameter></paramdef>
+ <paramdef>mixed <parameter>pad_value</parameter></paramdef>
</funcprototype>
- </funcsynopsis>
-
- <para>
- <function>array_pad</function> は、
- <parameter>pad_size</parameter> で指定した長さだけ値
- <parameter>pad_value</parameter> をうめて
- <parameter>input</parameter> のコピーを返します。
- <parameter>pad_size</parameter> が正の場合、配列の右側が埋められます。
- 負の場合、配列の左側が埋められます。
- <parameter>pad_size</parameter> の絶対値が
- <parameter>input</parameter> の長さ以下の場合、埋める処理は
- 行われません。
- </para>
-
- <para>
- <example>
- <title><function>array_pad</function> の例</title>
- <programlisting>
- $input = array(12, 10, 9);
+ </funcsynopsis>
+ <para>
+ <function>array_pad</function>は、<parameter>pad_size</parameter>
+ で指定した長さだけ値<parameter>pad_value</parameter>をうめて
+ <parameter>input</parameter>のコピーを返します。
+ <parameter>pad_size</parameter>が正の場合、配列の右側が埋められます。
+ 負の場合、配列の左側が埋められます。
+ <parameter>pad_size</parameter>の絶対値が
+ <parameter>input</parameter>の長さ以下の場合、埋める処理は
+ 行われません。
+ </para>
+ <para>
+ <example>
+ <title><function>array_pad</function>の例</title>
+ <programlisting role="php">
+$input = array (12, 10, 9);
- $result = array_pad($input, 5, 0);
- // 結果は、array(12, 10, 9, 0, 0) です。
+$result = array_pad ($input, 5, 0);
+// 結果は、array(12, 10, 9, 0, 0) です。
- $result = array_pad($input, -7, -1);
- // 結果は、array(-1, -1, -1, -1, 12, 10, 9) です。
+$result = array_pad ($input, -7, -1);
+// 結果は、array(-1, -1, -1, -1, 12, 10, 9) です。
- $result = array_pad($input, 2, "noop");
- // 埋める処理は行われません。
- </programlisting>
- </example>
- </para>
+$result = array_pad ($input, 2, "noop");
+// 埋める処理は行われません。
+ </programlisting>
+ </example>
+ </para>
</refsect1>
</refentry>
-
<refentry id="function.array-pop">
<refnamediv>
<refname>array_pop</refname>
@@ -274,37 +268,36 @@
<paramdef>array <parameter>array</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>array_pop</function> は配列<parameter>array</parameter>の
- 最後の値を取り出して返します。配列<parameter>array</parameter>は、
- 要素一つ分短くなります。</para>
-
+ <function>array_pop</function>は配列<parameter>array</parameter>の
+ 最後の値を取り出して返します。配列<parameter>array</parameter>は、
+ 要素一つ分短くなります。
+ </para>
<para>
<example>
- <title><function>array_pop</function> の例</title>
- <programlisting>
-$stack = array("orange", "apple", "raspberry");
-$fruit = array_pop($stack);
+ <title><function>array_pop</function>の例</title>
+ <programlisting role="php">
+$stack = array ("orange", "apple", "raspberry");
+$fruit = array_pop ($stack);
</programlisting>
<para>
- これにより、$stack の要素は二つ("orange"および "apple")だけとなり、
- $fruit は "raspberry" となります。</para>
- </example></para>
-
+ これにより、$stackの要素は二つ("orange"および "apple")だけとなり、
+ $fruit は"raspberry"となります。
+ </para>
+ </example>
+ </para>
<para>
- <function>array_push</function>,
- <function>array_shift</function>,
- <function>array_unshift</function> も参照下さい。
-
- <note>
- <para>
- この関数は、PHP 4.0 で追加されました。</para>
- </note></para>
+ <function>array_push</function>,<function>array_shift</function>,
+ <function>array_unshift</function>も参照下さい。
+ <note>
+ <para>
+ この関数は、PHP 4.0で追加されました。
+ </para>
+ </note>
+ </para>
</refsect1>
</refentry>
-
<refentry id="function.array-push">
<refnamediv>
<refname>array_push</refname>
@@ -317,43 +310,43 @@
<funcdef>int <function>array_push</function></funcdef>
<paramdef>array <parameter>array</parameter></paramdef>
<paramdef>mixed <parameter>var</parameter></paramdef>
- <paramdef><parameter><optional>...</optional></parameter></paramdef>
+ <paramdef>
+ <parameter><optional>...</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>array_push</function> は
- <parameter>array</parameter> をスタックとして処理し、渡された変数を
- <parameter>array</parameter> の最後に加えます。配列
- <parameter>array</parameter>の長さは渡された変数の数だけ増加します。
- 各 <parameter>var</parameter> 毎に以下を繰り返すことと同じ効果があります。
- <programlisting>
+ <function>array_push</function>は、<parameter>array</parameter>
+ をスタックとして処理し、渡された変数を
+ <parameter>array</parameter>の最後に加えます。配列
+ <parameter>array</parameter>の長さは渡された変数の数だけ増加します。
+ 各<parameter>var</parameter>毎に以下を繰り返すことと同じ効果があります。
+ <programlisting role="php">
$array[] = $var;
</programlisting>
- </para>
-
+ </para>
<para>
- 処理後の配列の中の要素の数を返します。</para>
-
+ 処理後の配列の中の要素の数を返します。
+ </para>
<para>
<example>
- <title><function>array_push</function> の例</title>
- <programlisting>
-$stack = array(1, 2);
+ <title><function>array_push</function>の例</title>
+ <programlisting role="php">
+$stack = array (1, 2);
array_push($stack, "+", 3);
</programlisting>
</example>
- この例の結果、$stack には、4つの要素 1,2,"+",3 があることになります。</para>
-
+ この例の結果、$stackには、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>
+ <function>array_pop</function>,<function>array_shift</function>,
+ <function>array_unshift</function>も参照下さい。
+ <note>
+ <para>
+ この関数は、 PHP 4.0で追加されました。
+ </para>
+ </note>
+ </para>
</refsect1>
</refentry>
@@ -370,27 +363,26 @@
<paramdef>array <parameter>array</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>array_reverse</function> は、<parameter>array</parameter> を
- 引数とし、要素の順番を逆にした新しい配列を返します。</para>
-
+ <function>array_reverse</function>は、<parameter>array</parameter>
+ を引数とし、要素の順番を逆にした新しい配列を返します。
+ </para>
<para>
<example>
- <title><function>array_reverse</function> の例</title>
- <programlisting>
-$input = array("php", 4.0, array("green", "red"));
-$result = array_reverse($input);
+ <title><function>array_reverse</function>の例</title>
+ <programlisting role="php">
+$input = array ("php", 4.0, array ("green", "red"));
+$result = array_reverse ($input);
</programlisting>
</example>
-
この例において、$result は array(array("green", "red"), 4.0, "php")
となります。
-
<note>
<para>
- この関数は、 PHP 4.0 β3で追加されました。</para>
- </note></para>
+ この関数は、PHP 4.0ベータ3で追加されました。
+ </para>
+ </note>
+ </para>
</refsect1>
</refentry>
@@ -407,36 +399,35 @@
<paramdef>array <parameter>array</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>array_shift</function> は、<parameter>array</parameter>
- の最初の値を取り出して返します。配列 <parameter>array</parameter>は、
- 要素一つ分だけ短くなり、全ての要素は前にずれます。</para>
-
+ <function>array_shift</function>は、<parameter>array</parameter>
+ の最初の値を取り出して返します。配列 <parameter>array</parameter>は、
+ 要素一つ分だけ短くなり、全ての要素は前にずれます。
+ </para>
<para>
<example>
- <title><function>array_shift</function> の例</title>
- <programlisting>
-$args = array("-v", "-f");
-$opt = array_shift($args);
+ <title><function>array_shift</function>の例</title>
+ <programlisting role="php">
+$args = array ("-v", "-f");
+$opt = array_shift ($args);
</programlisting>
</example>
- これにより、$args には一つの要素 "-f" が残り、$opt は
- "-v" となります。</para>
-
+ これにより、$argsには一つの要素"-f"が残り、$optは
+ "-v"となります。
+ </para>
<para>
<function>array_unshift</function>,
<function>array_push</function>,
- <function>array_pop</function> も参照下さい。
-
- <note>
- <para>
- この関数は、PHP 4.0 で追加されました。</para>
- </note></para>
+ <function>array_pop</function>も参照下さい。
+ <note>
+ <para>
+ この関数は、PHP 4.0で追加されました。
+ </para>
+ </note>
+ </para>
</refsect1>
</refentry>
-
<refentry id="function.array-slice">
<refnamediv>
<refname>array_slice</refname>
@@ -456,45 +447,45 @@
</paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>array_slice</function> は、<parameter>array</parameter>
- からパラメータ <parameter>offset</parameter> および
- <parameter>length</parameter> で指定された連続する要素を返します。</para>
-
+ <function>array_slice</function>は、<parameter>array</parameter>
+ からパラメータ <parameter>offset</parameter>および
+ <parameter>length</parameter>で指定された連続する要素を返します。
+ </para>
<para>
- <parameter>offset</parameter> が正の場合、要素位置の計算は、
- 配列<parameter>array</parameter>の offset から始められます。
- <parameter>offset</parameter> が負の場合、要素位置の計算は
- <parameter>array</parameter> の最後から行われます。</para>
-
+ <parameter>offset</parameter>が正の場合、要素位置の計算は、
+ 配列<parameter>array</parameter>のoffsetから始められます。
+ <parameter>offset</parameter>が負の場合、要素位置の計算は
+ <parameter>array</parameter>の最後から行われます。
+ </para>
<para>
- <parameter>length</parameter> が指定され、正の場合、
- 連続する複数の要素が返されます。<parameter>length</parameter>が
- 指定され、負の場合、配列の末尾から連続する複数の要素が返されます。
- 省略された場合、 <parameter>offset</parameter> から配列の最後まで
- の全ての要素が返されます。</para>
-
+ <parameter>length</parameter>が指定され、正の場合、
+ 連続する複数の要素が返されます。<parameter>length</parameter>が
+ 指定され、負の場合、配列の末尾から連続する複数の要素が返されます。
+ 省略された場合、 <parameter>offset</parameter>から配列の最後まで
+ の全ての要素が返されます。
+ </para>
<para>
<example>
- <title><function>array_slice</function> の例</title>
- <programlisting>
-$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" を返します
+ <title><function>array_slice</function>の例</title>
+ <programlisting role="php">
+$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>
-
+ </example>
+ </para>
<para>
- <function>array_splice</function> も参照下さい。
-
- <note>
- <para>
- この関数は、PHP 4.0 で追加されました。</para>
- </note></para>
+ <function>array_splice</function>も参照下さい。
+ <note>
+ <para>
+ この関数は、PHP 4.0で追加されました。
+ </para>
+ </note>
+ </para>
</refsect1>
</refentry>
@@ -514,83 +505,86 @@
<parameter><optional>length</optional></parameter>
</paramdef>
<paramdef>array
- <parameter><optional>replacement</optional></parameter></paramdef>
+ <parameter>
+ <optional>replacement</optional>
+ </parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>array_splice</function> は、配列<parameter>input</parameter>から
- <parameter>offset</parameter> および <parameter>length</parameter> で
- 指定された要素を削除し、配列 <parameter>replacement</parameter> が
- 指定されたこの要素で置換します。</para>
-
+ <function>array_splice</function>は、配列<parameter>input</parameter>
+ から<parameter>offset</parameter>および<parameter>length</parameter>で
+ 指定された要素を削除し、配列<parameter>replacement</parameter>が
+ 指定されたこの要素で置換します。
+ </para>
<para>
- <parameter>offset</parameter> が正の場合、削除される部分は
- 配列 <parameter>input</parameter> の最初から指定オフセットの位置
- からとなります。
- <parameter>offset</parameter> が負の場合、削除される部分は、
- <parameter>input</parameter> の末尾から数えた位置からとなります。</para>
-
+ <parameter>offset</parameter>が正の場合、削除される部分は
+ 配列<parameter>input</parameter>の最初から指定オフセットの位置
+ からとなります。
+ <parameter>offset</parameter>が負の場合、削除される部分は、
+ <parameter>input</parameter>の末尾から数えた位置からとなります。
+ </para>
<para>
- <parameter>length</parameter> が省略された場合、
- <parameter>offset</parameter> から配列の最後までが全て削除されます。
- <parameter>length</parameter> が指定され、正の場合、複数の要素が
- 削除されます。
- <parameter>length</parameter> が指定され、負の場合、削除される
- 部分は配列の末尾から複数の要素となります。
- ヒント: <parameter>replacement</parameter>も指定した場合に
- <parameter>offset</parameter>から配列の最後まで全てを削除するには、
- <parameter>length</parameter> を求めるために <literal>count($input)
- </literal> を使用して下さい。</para>
-
+ <parameter>length</parameter>が省略された場合、
+ <parameter>offset</parameter>から配列の最後までが全て削除されます。
+ <parameter>length</parameter>が指定され、正の場合、複数の要素が
+ 削除されます。
+ <parameter>length</parameter>が指定され、負の場合、削除される
+ 部分は配列の末尾から複数の要素となります。
+ ヒント: <parameter>replacement</parameter>も指定した場合に
+ <parameter>offset</parameter>から配列の最後まで全てを削除するには、
+ <parameter>length</parameter>を求めるために<literal>count($input)
+ </literal>を用して下さい。
+ </para>
<para>
- 配列 <parameter>replacement</parameter> が指定された場合、
- 削除された要素は、この配列の要素で置換されます。
- <parameter>offset</parameter> および <parameter>length</parameter> で
- 何も削除しないと指定した場合、配列 <parameter>replacement</parameter> の
- 要素は<parameter>offset</parameter>で指定された位置に挿入されます。
- ヒント: replacement に一つしか要素がない場合、要素そのものが配列でない限り、
- <literal>array()</literal> で括る必要はありません。</para>
-
+ 配列<parameter>replacement</parameter>が指定された場合、
+ 削除された要素は、この配列の要素で置換されます。
+ <parameter>offset</parameter>および<parameter>length</parameter>で
+ 何も削除しないと指定した場合、配列<parameter>replacement</parameter>の
+ 要素は<parameter>offset</parameter>で指定された位置に挿入されます。
+ ヒント:replacementに一つしか要素がない場合、要素そのものが配列でない限り、
+ <literal>array()</literal>で括る必要はありません。
+ </para>
<para>
以下は等価となります。
- <programlisting>
+ <programlisting role="php">
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>
-
+ </programlisting>
+ </para>
<para>
- 削除された要素からなる配列を返します。</para>
-
+ 削除された要素からなる配列を返します。
+ </para>
<para>
<example>
- <title><function>array_splice</function> の例</title>
- <programlisting>
+ <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, count($input), "orange");
+ // $input は、array("red", "orange") となります。
array_splice($input, -1, 1, array("black", "maroon"));
// $input は、array("red", "green",
// "blue", "black", "maroon") となります。
</programlisting>
- </example></para>
-
+ </example>
+ </para>
<para>
- <function>array_slice</function> も参照下さい。
-
- <note>
- <para>
- この関数は、PHP 4.0 で追加されました。 </para>
- </note></para>
+ <function>array_slice</function>も参照下さい。
+ <note>
+ <para>
+ この関数は、PHP 4.0で追加されました。
+ </para>
+ </note>
+ </para>
</refsect1>
</refentry>
-
<refentry id="function.array-unshift">
<refnamediv>
<refname>array_unshift</refname>
@@ -603,43 +597,45 @@
<funcdef>int <function>array_unshift</function></funcdef>
<paramdef>array <parameter>array</parameter></paramdef>
<paramdef>mixed <parameter>var</parameter></paramdef>
- <paramdef><parameter><optional>...</optional></parameter></paramdef>
+ <paramdef>
+ <parameter>
+ <optional>...</optional>
+ </parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>array_unshift</function> は、<parameter>array</parameter>
- の先頭に渡された要素を加えます。リストの要素は全体として加えられるため、
- 加えられた要素の順番は変わらないことに注意してください。</para>
-
+ <function>array_unshift</function>は、<parameter>array</parameter>
+ の先頭に渡された要素を加えます。リストの要素は全体として加えられるため、
+ 加えられた要素の順番は変わらないことに注意してください。
+ </para>
<para>
- 処理後の
- <parameter>array</parameter> の要素の数を返します。</para>
-
+ 処理後の<parameter>array</parameter>の要素の数を返します。
+ </para>
<para>
<example>
- <title><function>array_unshift</function> の例</title>
- <programlisting>
+ <title><function>array_unshift</function>の例</title>
+ <programlisting role="php">
$queue = array("p1", "p3");
array_unshift($queue, "p4", "p5", "p6");
</programlisting>
</example>
この例により、$queue の要素は次の5つとなります。: "p4", "p5", "p6",
- "p1", "p3" </para>
-
- <para>
+ "p1", "p3"
+ </para>
+ <para>
<function>array_shift</function>,
<function>array_push</function>,
- <function>array_pop</function> も参照下さい。
-
- <note>
- <para>
- この関数は、PHP 4.0 で追加されました。 </para>
- </note></para>
+ <function>array_pop</function>も参照下さい。
+ <note>
+ <para>
+ この関数は、PHP 4.0で追加されました。
+ </para>
+ </note>
+ </para>
</refsect1>
</refentry>
-
<refentry id="function.array-values">
<refnamediv>
<refname>array_values</refname>
@@ -653,111 +649,113 @@
<paramdef>array <parameter>input</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>array_values</function> は、配列 <parameter>input</parameter>
- から全ての値を返します。</para>
-
+ <function>array_values</function>は、配列<parameter>input</parameter>
+ から全ての値を返します。
+ </para>
<para>
<example>
- <title><function>array_values</function> の例</title>
- <programlisting>
+ <title><function>array_values</function>の例</title>
+ <programlisting role="php">
$array = array("size" => "XL", "color" => "gold");
-array_values($array); // array("XL", "gold") を返します
+array_values($array); // array("XL", "gold")を返します
</programlisting>
</example>
-
<note>
<para>
- この関数は、PHP 4.0 で追加されました。 </para>
- </note></para>
+ この関数は、PHP 4.0で追加されました。
+ </para>
+ </note>
+ </para>
</refsect1>
</refentry>
- <refentry id="function.array-walk">
- <refnamediv>
- <refname>array_walk</refname>
- <refpurpose>
+ <refentry id="function.array-walk">
+ <refnamediv>
+ <refname>array_walk</refname>
+ <refpurpose>
配列の各メンバーにユーザー関数を適用する。
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>説明</title>
- <funcsynopsis>
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
<funcprototype>
- <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>
+ <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>
</funcprototype>
- </funcsynopsis>
-
- <simpara>
- <parameter>arr</parameter> の各要素に <parameter>func</parameter>
+ </funcsynopsis>
+ <simpara>
+ <parameter>arr</parameter>の各要素に<parameter>func</parameter>
という名前の関数を適用します。
- <parameter>func</parameter> には、配列の値が最初の引数として
+ <parameter>func</parameter>には、配列の値が最初の引数として
渡され、配列のキーが2番目のパラメータとして渡されます。
- <parameter>userdata</parameter> が指定された場合、3番目の引数として
+ <parameter>userdata</parameter>が指定された場合、3番目の引数として
ユーザー関数に渡されます。
-
- <parameter>func</parameter> が2つまたは3つを超える引数を必要とする場合、
- <parameter>userdata</parameter> の指定によっては、
- <function>array_walk</function> が <parameter>func</parameter>
- をコールする度に警告が生成されます。
- これらの警告は、<function>array_walk</function> の前に
- '@' マークを付けるか
- <function>error_reporting</function> を使用することにより
- 抑制されます。</simpara>
-
+ <parameter>func</parameter>が2つまたは3つを超える引数を必要とする場合、
+ <parameter>userdata</parameter>の指定によっては、
+ <function>array_walk</function>が<parameter>func</parameter>
+ をコールする度に警告が生成されます。
+ これらの警告は、<function>array_walk</function>の前に
+ '@'マークを付けるか
+ <function>error_reporting</function>を使用することにより
+ 抑制されます。
+ </simpara>
<note>
<para>
- <parameter>func</parameter> により配列の値そのものを変更する必要
- がある場合、<parameter>func</parameter> の最初の引数は参照として
+ <parameter>func</parameter>により配列の値そのものを変更する必要
+ がある場合、<parameter>func</parameter>の最初の引数は参照として
渡す必要があります。この場合、配列の要素に加えた変更は、配列自体
に対して行われます。
</para>
</note>
-
<note>
<para>
- キー及び userdata を<parameter>func</parameter> に渡す処理は、
- バージョン 4.0 で追加されました。</para>
- </note>
-
+ キー及びuserdataを<parameter>func</parameter>に渡す処理は、
+ バージョン 4.0で追加されました。
+ </para>
<para>
- <example>
- <title><function>array_walk</function> の例</title>
- <programlisting>
-$fruits = array("d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple");
+ PHP 4では、<function>array_walk</function>で配列のリセットがデフォ
+ ルトで行われないため、<function>reset</function>をコールする必要
+ があります。
+ </para>
+ </note>
+ <para>
+ <example>
+ <title><function>array_walk</function>の例</title>
+ <programlisting role="php">
+$fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple");
-function test_alter( &$item1, $key, $prefix ) {
+function test_alter (&$item1, $key, $prefix) {
$item1 = "$prefix: $item1";
}
-function test_print( $item2, $key ) {
+function test_print ($item2, $key) {
echo "$key. $item2<br>\n";
}
+
+array_walk ($fruits, 'test_print');
+reset ($fruits);
+array_walk ($fruits, 'test_alter', 'fruit');
+reset ($fruits);
+array_walk ($fruits, 'test_print');
+ </programlisting>
+ </example>
+ </para>
+ <simpara>
+ <function>each</function>および<function>list</function>
+ も参照下さい。
+ </simpara>
+ </refsect1>
+ </refentry>
-array_walk( $fruits, 'test_print' );
-array_walk( $fruits, 'test_alter' , 'fruit' );
-array_walk( $fruits, 'test_print' );
- </programlisting>
- </example></para>
-
- <simpara>
- <function>each</function> および <function>list</function>
- も参照下さい。</simpara>
-
- </refsect1>
- </refentry>
-
-
-
<refentry id="function.arsort">
<refnamediv>
<refname>arsort</refname>
<refpurpose>
- 連想キーと要素との関係を維持しつつ配列を逆順にソートします
+ 連想キーと要素との関係を維持しつつ配列を逆順にソートします
</refpurpose>
</refnamediv>
<refsect1>
@@ -769,33 +767,35 @@
</funcprototype>
</funcsynopsis>
<para>
- この関数は、
- 連想配列において各配列のキーと要素との関係を維持しつつ
- ソートを行います。
- この関数は、主に実際の要素の並び方が重要である連想配列をソートするために
- 使われます。
- <example>
- <title><function>arsort</function> の例</title>
- <programlisting>
-$fruits = array("d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple");
-arsort($fruits);
-for(reset($fruits); $key = key($fruits); next($fruits)) {
- echo "fruits[$key] = ".$fruits[$key]."\n";
+ この関数は、連想配列において各配列のキーと要素との関係を維持しつ
+ つソートを行います。この関数は、主に実際の要素の並び方が重要であ
+ る連想配列をソートするために使われます。
+ <example>
+ <title><function>arsort</function>の例</title>
+ <programlisting role="php">
+$fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple");
+arsort ($fruits);
+reset($fruits);
+while(list($key,$val)=each($fruits)) {
+ echo "$key = $val\n";
}
-</programlisting></example>
+ </programlisting>
+ </example>
この例は、以下のように出力されます。
<computeroutput>
fruits[a] = orange
fruits[d] = lemon
fruits[b] = banana
fruits[c] = apple
-</computeroutput>
- fruits はアルファベットの逆順にソートされ、各要素とキーとの関係は
- 維持されます。</para>
+ </computeroutput>
+ fruitsはアルファベットの逆順にソートされ、各要素とキーとの関係は
+ 維持されます。
+ </para>
<para>
<function>asort</function>, <function>rsort</function>,
<function>ksort</function>, <function>sort</function>
- も参照下さい。</para>
+ も参照下さい。
+ </para>
</refsect1>
</refentry>
@@ -813,32 +813,34 @@
</funcprototype>
</funcsynopsis>
<para>
- この関数は、連想配列において各配列のキーと要素との関係を維持しつつ配列を
- ソートします。
- この関数は、主に実際の要素の並び方が重要である連想配列をソートするために
- 使われます。
- <example>
- <title><function>asort</function> の例</title>
- <programlisting>
-$fruits = array("d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple");
-asort($fruits);
-for(reset($fruits); $key = key($fruits); next($fruits)) {
- echo "fruits[$key] = ".$fruits[$key]."\n";
+ この関数は、連想配列において各配列のキーと要素との関係を維持しつ
+ つ配列をソートします。この関数は、主に実際の要素の並び方が重要で
+ ある連想配列をソートするために使われます。
+ <example>
+ <title><function>asort</function>の例</title>
+ <programlisting role="php">
+$fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple");
+asort ($fruits);
+reset($fruits);
+while(list($key,$val)=each($fruits)) {
+ echo "$key = $val\n";
}
-</programlisting></example>
+ </programlisting>
+ </example>
この例は、以下のように出力されます。
<computeroutput>
fruits[c] = apple
fruits[b] = banana
fruits[d] = lemon
fruits[a] = orange
-</computeroutput>
- fruits はアルファベットの昇順にソートされ、各要素とキーとの関係は
- 維持されます。</para>
+ </computeroutput>
+ fruitsはアルファベットの昇順にソートされ、各要素とキーとの関係は
+ 維持されます。
+ </para>
<para>
<function>arsort</function>, <function>rsort</function>,
- <function>ksort</function>, <function>sort</function> も
- 参照下さい。</para>
+ <function>ksort</function>, <function>sort</function>も参照下さい。
+ </para>
</refsect1>
</refentry>
@@ -847,7 +849,7 @@
<refname>compact</refname>
<refpurpose>
変数名とその値から配列を作成する
- </refpurpose>
+ </refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
@@ -855,50 +857,51 @@
<funcprototype>
<funcdef>array <function>compact</function></funcdef>
<paramdef><parameter>string varname | array
- varnames</parameter></paramdef>
- <paramdef><parameter><optional>...</optional></parameter></paramdef>
+ varnames</parameter></paramdef>
+ <paramdef>
+ <parameter><optional>...</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>compact</function> がとるパラメータの数は可変です。
- 各パラメータは、変数名を値とする文字列か、変数名の配列のどちらかとする
- ことができます。配列は、変数名を値とする別の配列を持つことができます。
- <function>compact</function> はこれを再帰的に処理します。</para>
-
+ <function>compact</function>がとるパラメータの数は可変です。
+ 各パラメータは、変数名を値とする文字列か、変数名の配列のどちらかとする
+ ことができます。配列は、変数名を値とする別の配列を持つことができます。
+ <function>compact</function>はこれを再帰的に処理します。
+ </para>
<para>
- 各引数について、<function>compact</function>は現在のシンボルテーブル
- においてその名前を有する変数を探し、変数名がキー、変数の値がそのキー
- に関する値となるように追加します。
- 端的に言うと、 <function>extract</function> の逆の動作をします。
- 追加された全ての変数を値とする出力配列を返します。</para>
-
+ 各引数について、<function>compact</function>は現在のシンボルテーブル
+ においてその名前を有する変数を探し、変数名がキー、変数の値がそのキー
+ に関する値となるように追加します。
+ 端的に言うと、<function>extract</function>の逆の動作をします。
+ 追加された全ての変数を値とする出力配列を返します。
+ </para>
<para>
<example>
- <title><function>compact</function> の例</title>
- <programlisting>
+ <title><function>compact</function>の例</title>
+ <programlisting role="php">
$city = "San Francisco";
$state = "CA";
$event = "SIGGRAPH";
-$location_vars = array("city", "state");
+$location_vars = array ("city", "state");
-$result = compact("event", $location_vars);
+$result = compact ("event", $location_vars);
</programlisting>
-
<para>
- この例により $result は、array("event" => "SIGGRAPH", "city"
- => "San Francisco", "state" => "CA")
- となります。</para>
- </example></para>
-
+ この例により、$resultは、array("event" => "SIGGRAPH", "city"
+ => "San Francisco", "state" => "CA")となります。
+ </para>
+ </example>
+ </para>
<para>
- <function>extract</function> も参照下さい。
-
- <note>
- <para>
- この関数は、PHP 4.0 で追加されました。 </para>
- </note></para>
+ <function>extract</function>も参照下さい。
+ <note>
+ <para>
+ この関数は、PHP 4.0で追加されました。
+ </para>
+ </note>
+ </para>
</refsect1>
</refentry>
@@ -916,25 +919,28 @@
</funcprototype>
</funcsynopsis>
<para>
- <parameter>var</parameter> に含まれる要素の数を返します。
- 通常、<parameter>var</parameter> は配列です（他のものには、1 つの要素しか
- ありませんから）。</para>
+ <parameter>var</parameter>に含まれる要素の数を返します。
+ 通常、<parameter>var</parameter>は配列です（他のものには、1つの要素しか
+ ありませんから）。
+ </para>
<para>
- 変数が配列でない場合は 1 を返します。</para>
+ 変数が配列でない場合は1を返します。
+ </para>
<para>
- 変数がセットされていない場合は 0 を返します。
- <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>
+ </para>
<para>
<function>sizeof</function>, <function>isset</function>,
- <function>is_array</function>
- も参照下さい。</para>
+ <function>is_array</function>も参照下さい。
+ </para>
</refsect1>
</refentry>
@@ -952,37 +958,37 @@
</funcprototype>
</funcsynopsis>
<para>
- 各配列は、"現在"の要素へのポインタを有しています。
- このポインタは、その配列の最初の要素を指すように初期化されます。</para>
-
+ 各配列は、"現在"の要素へのポインタを有しています。
+ このポインタは、その配列の最初の要素を指すように初期化されます。
+ </para>
<para>
- <function>current</function> 関数は、単に内部ポインタが現在
- 指している配列要素を返します。この関数は、ポインタを全く移動
- しません。内部ポインタが最終要素の次を指していた場合、
- <function>current</function> は false を返します。
-
- <warning>
- <para>
- 配列中に空の要素 (0 または 空の文字列 "")がある場合、
- この関数はこれらの要素について FALSE を返します。
- 現在の要素が値 0 または配列の終わりを通過したのか
- を決定することができないのです。
- 配列を正しく順番に処理するには、
- <function>each</function> を使用して下さい。</para>
- </warning></para>
-
+ <function>current</function>関数は、単に内部ポインタが現在
+ 指している配列要素を返します。この関数は、ポインタを全く移動
+ しません。内部ポインタが最終要素の次を指していた場合、
+ <function>current</function>はfalseを返します。
+ <warning>
+ <para>
+ 配列中に空の要素(0または空の文字列"")がある場合、この関数はこれ
+ らの要素についてfalseを返します。現在の要素が値0または配列の終
+ わりを通過したのかを決定することができないのです。配列を正しく
+ 順番に処理するには、<function>each</function>を使用して下さい。
+ </para>
+ </warning>
+ </para>
<para>
<function>end</function>, <function>next</function>,
- <function>prev</function>, <function>reset</function> も
- 参照下さい。</para>
+ <function>prev</function>, <function>reset</function>も
+ 参照下さい。
+ </para>
</refsect1>
</refentry>
-
<refentry id="function.each">
<refnamediv>
<refname>each</refname>
- <refpurpose>配列から、次のキーと値のペアを返す</refpurpose>
+ <refpurpose>
+ 配列から、次のキーと値のペアを返す
+ </refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
@@ -993,32 +999,28 @@
</funcprototype>
</funcsynopsis>
<para>
- 配列 <parameter>array</parameter> から、次のキーと値のペア
- を返し、配列カーソルを進めます。このペアは、4 つの要素を持つ配列で、
- それぞれの要素は <emphasis>0</emphasis>,
- <emphasis>1</emphasis>, <emphasis>key</emphasis>, および
- <emphasis>value</emphasis> というキーを有しています。
- 要素 <emphasis>0</emphasis> と
- <emphasis>key</emphasis> の各々は配列要素のキー名称を保持しており、
- <emphasis>1</emphasis> と <emphasis>value</emphasis> の各々は
- そのデータを保持しています。</para>
-
- <para>
- 配列の内部ポインタが、配列の最終要素以降を指す場合、
- <function>each</function> は FALSE を返します。</para>
-
+ 配列<parameter>array</parameter>から、次のキーと値のペアを返し、
+ 配列カーソルを進めます。このペアは、4つの要素を持つ配列で、
+ それぞれの要素は<emphasis>0</emphasis>,<emphasis>1</emphasis>,
+ <emphasis>key</emphasis>,<emphasis>value</emphasis>というキーを有
+ しています。要素 <emphasis>0</emphasis>と<emphasis>key</emphasis>
+ の各々は配列要素のキー名称を保持しており、<emphasis>1</emphasis>
+ と<emphasis>value</emphasis>の各々はそのデータを保持しています。
+ </para>
+ <para>
+ 配列の内部ポインタが、配列の最終要素以降を指す場合、
+ <function>each</function>はfalseを返します。
+ </para>
<para>
<example>
- <title><function>each</function> の例</title>
- <programlisting>
+ <title><function>each</function>の例</title>
+ <programlisting role="php">
$foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese");
$bar = each( $foo );
</programlisting>
-
<para>
- <literal>$bar</literal> は、ここでは以下のキー/値の
- ペアを保持しています。
-
+ <literal>$bar</literal>は、ここでは以下のキー/値のペアを保持し
+ ています。
<itemizedlist spacing="compact">
<listitem><simpara>0 => 0</simpara></listitem>
<listitem><simpara>1 => 'bob'</simpara></listitem>
@@ -1026,61 +1028,59 @@
<listitem><simpara>value => 'bob'</simpara></listitem>
</itemizedlist>
- <programlisting>
-$foo = array( "Robert" => "Bob", "Seppo" => "Sepi" );
-$bar = each( $foo );
- </programlisting></para>
-
+ <programlisting role="php">
+$foo = array ("Robert" => "Bob", "Seppo" => "Sepi");
+$bar = each ($foo);
+ </programlisting>
+ </para>
<para>
- <literal>$bar</literal> は、この時点で以下のキー/値の
- ペアを保持しています。
-
+ <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>
- </itemizedlist></para>
-
- </example></para>
-
-
+ </itemizedlist>
+ </para>
+ </example>
+ </para>
<para>
- 通常 <function>each</function> は、配列の走査をするために
- <function>list</function> と共に使用されます。例えば、
- $HTTP_POST_VARS の場合は次のようになります。
-
+ 通常<function>each</function>は、配列の走査をするために
+ <function>list</function>と共に使用されます。例えば、
+ $HTTP_POST_VARSの場合は次のようになります。
<example>
<title>
- <function>each</function> により $HTTP_POST_VARS を走査する
+ <function>each</function>により$HTTP_POST_VARSを走査する
</title>
- <programlisting>
-echo "POST メソッドにより受け渡された値：<br>";
-reset($HTTP_POST_VARS);
-while (list($key, $val) = each($HTTP_POST_VARS)) {
+ <programlisting role="php">
+echo "POSTメソッドにより受け渡された値：<br>";
+reset ($HTTP_POST_VARS);
+while (list ($key, $val) = each ($HTTP_POST_VARS)) {
echo "$key => $val<br>";
}
</programlisting>
- </example></para>
-
+ </example>
+ </para>
<para>
- <function>each</function> を実行した後、配列カーソルは、
- 配列の次の要素に移動します。配列の最終要素にカーソルがある場合は、
- 最終要素にとどまります。</para>
-
+ <function>each</function>を実行した後、配列カーソルは、
+ 配列の次の要素に移動します。配列の最終要素にカーソルがある場合は、
+ 最終要素にとどまります。
+ </para>
<para>
<function>key</function>、<function>list</function>、
<function>current</function>、<function>reset</function>、
- <function>next</function>、<function>prev</function> も参照下さい。</para>
-
+ <function>next</function>、<function>prev</function>も参照下さい。
+ </para>
</refsect1>
</refentry>
-
<refentry id="function.end">
<refnamediv>
<refname>end</refname>
- <refpurpose>配列の内部ポインタを最終要素にセットする</refpurpose>
+ <refpurpose>
+ 配列の内部ポインタを最終要素にセットする
+ </refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
@@ -1091,166 +1091,176 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>end</function> は <parameter>array</parameter> の
- 内部ポインタを最後の要素まで進めます。</para>
+ <function>end</function>は<parameter>array</parameter>の内部ポイ
+ ンタを最後の要素まで進めます。
+ </para>
<para>
- 参照：
<function>current</function>, <function>each</function>,
- <function>end</function>
- <function>next</function> , <function>reset</function></para>
+ <function>end</function>, <function>next</function> ,
+ <function>reset</function>も参照下さい。
+ </para>
</refsect1>
</refentry>
- <refentry id="function.extract">
- <refnamediv>
- <refname>extract</refname>
- <refpurpose>配列からシンボルテーブルに変数をインポートする</refpurpose>
- </refnamediv>
- <refsect1>
- <title>説明</title>
- <funcsynopsis>
+ <refentry id="function.extract">
+ <refnamediv>
+ <refname>extract</refname>
+ <refpurpose>
+ 配列からシンボルテーブルに変数をインポートする
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
<funcprototype>
- <funcdef>void <function>extract</function></funcdef>
- <paramdef>array <parameter>var_array</parameter></paramdef>
- <paramdef>int
- <parameter><optional>extract_type</optional></parameter>
- </paramdef>
- <paramdef>string
- <parameter><optional>prefix</optional></parameter>
- </paramdef>
+ <funcdef>void <function>extract</function></funcdef>
+ <paramdef>array <parameter>var_array</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>extract_type</optional></parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter><optional>prefix</optional></parameter>
+ </paramdef>
</funcprototype>
- </funcsynopsis>
- <para>
- この関数は、配列から現在のシンボルテーブルに変数をインポートする
- ために使用されます。この関数は連想配列<parameter>var_array</parameter>
- を引数とし、そのキーを変数名、値を変数の値として処理します。
- 各キー/値の組に関して、<parameter>extract_type</parameter> および
- <parameter>prefix</parameter> パラメータに基づき
- 現在のシンボルテーブルに変数を一つ作成します。</para>
- <para>
- <function>extract</function> は存在する変数との衝突を確認します。
- 衝突時の対処法は、<parameter>extract_type</parameter>で定義されます。
- これは以下の値のどれかとなります。
- <variablelist>
- <varlistentry>
- <term>EXTR_OVERWRITE</term>
- <listitem>
- <simpara>
- 衝突があった場合、存在する変数が上書きされます。
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>EXTR_SKIP</term>
- <listitem>
- <simpara>
- 衝突があった場合、存在する変数は上書きされません。
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>EXTR_PREFIX_SAME</term>
- <listitem>
- <simpara>
- 衝突があった場合、<parameter>prefix</parameter>を前につけた
- 新しい変数となります。
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>EXTR_PREFIX_ALL</term>
- <listitem>
- <simpara>
- 全ての変数の