mirror of
https://github.com/php/doc-ja.git
synced 2026-03-24 07:02:08 +01:00
1617 lines
44 KiB
XML
1617 lines
44 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: 3061900171d4ae84d532571bfd6eda823726dad4 Maintainer: takagi Status: ready -->
|
|
<!-- CREDITS: hirokawa,shimooka,mumumu -->
|
|
<sect1 xml:id="language.types.array">
|
|
<title>配列</title>
|
|
|
|
<para>
|
|
全ての配列関数の一覧は、<link linkend="ref.array">配列関数</link>
|
|
を参照ください。
|
|
</para>
|
|
|
|
<para>
|
|
PHP の配列は、実際には順番付けられたマップです。マップは型の一種で、
|
|
<emphasis>値</emphasis>を<emphasis>キー</emphasis>に関連付けます。
|
|
この型は、さまざまな使い道にあわせて最適化されます。
|
|
配列としてだけでなく、リスト (ベクター)、
|
|
ハッシュテーブル (マップの実装の一つ)、辞書、コレクション、スタック、
|
|
キュー等として使用することが可能です。
|
|
PHP の配列には他の PHP 配列を値として保持することができるため、
|
|
非常に簡単にツリー構造を表現することが可能です。
|
|
</para>
|
|
|
|
<para>
|
|
これらのデータ構造に関する説明は本マニュアルの範囲を超えるので省略しますが、
|
|
各々について、少なくとも一つは例を示します。
|
|
この分野は広範囲にまたがり、さまざまな文献が存在します。
|
|
より詳細な情報については、それらの文献を参照ください。
|
|
</para>
|
|
|
|
<sect2 xml:id="language.types.array.syntax">
|
|
<title>構文</title>
|
|
|
|
<sect3 xml:id="language.types.array.syntax.array-func">
|
|
<title><function>array</function> で指定</title>
|
|
|
|
<para>
|
|
配列(<type>array</type>)は、言語に組み込まれた
|
|
<function>array</function> で作成することが可能です。この構造は、
|
|
特定の数のカンマで区切られた
|
|
<literal><replaceable>key</replaceable> => <replaceable
|
|
>value</replaceable></literal> の組を引数とします。
|
|
</para>
|
|
|
|
<synopsis>
|
|
array(
|
|
<optional><replaceable>key</replaceable> => </optional><replaceable>value</replaceable>,
|
|
<optional><replaceable>key2</replaceable> => </optional><replaceable>value2</replaceable>,
|
|
<optional><replaceable>key3</replaceable> => </optional><replaceable>value3</replaceable>,
|
|
...
|
|
)</synopsis>
|
|
<!-- Do not fix the whitespace for the synopsis end element. A limitation of PhD prevents proper trimming -->
|
|
|
|
<para>
|
|
最後の要素のあとのカンマは、書いても書かなくてもかまいません。
|
|
配列を一行で定義する場合は、ふつうは最後のカンマを省略します。つまり、
|
|
<literal>array(1, 2)</literal> のほうが
|
|
<literal>array(1, 2, )</literal> よりおすすめだということです。
|
|
しかし複数行で定義する場合は、最後のカンマをつけることが一般的です。
|
|
そうしておけば、配列の最後に要素を追加するのが容易になるからです。
|
|
</para>
|
|
|
|
<note>
|
|
<para>
|
|
<literal>array()</literal> を <literal>[]</literal>
|
|
で置き換えることが出来る、配列の短縮構文も使えます。
|
|
</para>
|
|
</note>
|
|
|
|
<example>
|
|
<title>シンプルな配列定義</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$array1 = array(
|
|
"foo" => "bar",
|
|
"bar" => "foo",
|
|
);
|
|
|
|
// 配列の短縮構文
|
|
$array2 = [
|
|
"foo" => "bar",
|
|
"bar" => "foo",
|
|
];
|
|
|
|
var_dump($array1, $array2);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
<para>
|
|
<varname>key</varname> は、<type>int</type> または
|
|
<type>string</type>です。
|
|
<replaceable>value</replaceable> には任意の型を指定できます。
|
|
</para>
|
|
|
|
<para xml:id="language.types.array.key-casts">
|
|
さらに、次のような <replaceable>key</replaceable> のキャストが発生します。
|
|
<itemizedlist>
|
|
<listitem>
|
|
<simpara>
|
|
10 進数の <type>int</type> として妥当な形式の <type>String</type> は、
|
|
数値の前に <literal>+</literal> 記号がついていない限り、
|
|
<type>int</type> 型にキャストされます。
|
|
つまり、キーに <literal>"8"</literal> を指定すると、実際には
|
|
<literal>8</literal> として格納されるということです。一方 <literal>"08"</literal>
|
|
はキャストされません。これは十進数として妥当な形式ではないからです。
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<type>float</type>s もまた <type>int</type> にキャストされます。つまり、
|
|
小数部分は切り捨てられるということです。たとえばキーに <literal>8.7</literal> を指定すると、実際には
|
|
<literal>8</literal> として格納されます。
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<type>bool</type> も <type>int</type> にキャストされます。つまり、
|
|
キーに &true; を指定すると実際には <literal>1</literal> に格納され、
|
|
同様にキーを &false; とすると実際には <literal>0</literal> となります。
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<type>Null</type> は空文字列にキャストされます。つまり、キーに
|
|
<literal>null</literal> を指定すると、実際には <literal>""</literal> として格納されます。
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<type>array</type> や <type>object</type> は、キーとして<emphasis>使えません</emphasis>。
|
|
キーとして使おうとすると <literal>Illegal offset type</literal> という警告が発生します。
|
|
</simpara>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
|
|
<para>
|
|
配列の宣言時に同じキーで複数の要素を指定すると、
|
|
最後に指定したものがそれまでの値を上書きします。
|
|
</para>
|
|
|
|
<example>
|
|
<title>型のキャストと値の上書きの例</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$array = array(
|
|
1 => "a",
|
|
"1" => "b",
|
|
1.5 => "c",
|
|
true => "d",
|
|
);
|
|
var_dump($array);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs;
|
|
<screen>
|
|
<![CDATA[
|
|
array(1) {
|
|
[1]=>
|
|
string(1) "d"
|
|
}
|
|
]]>
|
|
</screen>
|
|
<para>
|
|
上の例では、すべてのキーが <literal>1</literal> にキャストされます。
|
|
そして後から指定した値がどんどん前の値を上書きしていき、最終的には最後に代入された
|
|
<literal>"d"</literal> だけが残ります。
|
|
</para>
|
|
</example>
|
|
|
|
<para>
|
|
PHP においては添字配列と連想配列の間に違いはなく、配列型は 1 つだけで、
|
|
同じ配列で整数のインデックスと文字列のインデックスを同時に使えます。
|
|
</para>
|
|
|
|
<example>
|
|
<title>整数と文字列のキーの混在例</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$array = array(
|
|
"foo" => "bar",
|
|
"bar" => "foo",
|
|
100 => -100,
|
|
-100 => 100,
|
|
);
|
|
var_dump($array);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs;
|
|
<screen>
|
|
<![CDATA[
|
|
array(4) {
|
|
["foo"]=>
|
|
string(3) "bar"
|
|
["bar"]=>
|
|
string(3) "foo"
|
|
[100]=>
|
|
int(-100)
|
|
[-100]=>
|
|
int(100)
|
|
}
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
|
|
<para>
|
|
<replaceable>key</replaceable> はオプションです。省略した場合、PHP
|
|
はこれまでに使われた整数のキーの中で最大のものに 1 を加えた値を使います。
|
|
</para>
|
|
|
|
<example>
|
|
<title>数値添字配列でキーを省略する例</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$array = array("foo", "bar", "hello", "world");
|
|
var_dump($array);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs;
|
|
<screen>
|
|
<![CDATA[
|
|
array(4) {
|
|
[0]=>
|
|
string(3) "foo"
|
|
[1]=>
|
|
string(3) "bar"
|
|
[2]=>
|
|
string(5) "hello"
|
|
[3]=>
|
|
string(5) "world"
|
|
}
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
|
|
<para>
|
|
一部の要素にだけキーを指定することもできます。
|
|
</para>
|
|
|
|
<example>
|
|
<title>一部の要素にだけキーを指定する例</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$array = array(
|
|
"a",
|
|
"b",
|
|
6 => "c",
|
|
"d",
|
|
);
|
|
var_dump($array);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs;
|
|
<screen>
|
|
<![CDATA[
|
|
array(4) {
|
|
[0]=>
|
|
string(1) "a"
|
|
[1]=>
|
|
string(1) "b"
|
|
[6]=>
|
|
string(1) "c"
|
|
[7]=>
|
|
string(1) "d"
|
|
}
|
|
]]>
|
|
</screen>
|
|
<para>
|
|
ごらんの通り、最後の値である <literal>"d"</literal> のキーは
|
|
<literal>7</literal> となります。それまでにキーとして使われた最大の整数が
|
|
<literal>6</literal> だからです。
|
|
</para>
|
|
</example>
|
|
|
|
<example>
|
|
<title>複雑な型のキャストと上書きの例</title>
|
|
<para>
|
|
以下の例は、型のキャストされた時と、要素が上書きされる時の全ての場合を示しています。
|
|
</para>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$array = array(
|
|
1 => 'a',
|
|
'1' => 'b', // 値 "a" は "b" で上書きされます。
|
|
1.5 => 'c', // 値 "b" は "c" で上書きされます。
|
|
-1 => 'd',
|
|
'01' => 'e', // この値は数値形式の文字列ではないので、キー1を上書きしません
|
|
'1.5' => 'f', // この値は数値形式の文字列ではないので、キー1を上書きしません
|
|
true => 'g', // 値 "c" は "g" で上書きされます。
|
|
false => 'h',
|
|
'' => 'i',
|
|
null => 'j', // 値 "i" は "j" で上書きされます。
|
|
'k', // 値 "k" にはキー2が割り当てられます。なぜなら、これより前のキーの最大値は1だからです。
|
|
2 => 'l', // 値 "k" は "l" で上書きされます。
|
|
);
|
|
|
|
var_dump($array);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs;
|
|
<screen>
|
|
<![CDATA[
|
|
array(7) {
|
|
[1]=>
|
|
string(1) "g"
|
|
[-1]=>
|
|
string(1) "d"
|
|
["01"]=>
|
|
string(1) "e"
|
|
["1.5"]=>
|
|
string(1) "f"
|
|
[0]=>
|
|
string(1) "h"
|
|
[""]=>
|
|
string(1) "j"
|
|
[2]=>
|
|
string(1) "l"
|
|
}
|
|
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
|
|
<example>
|
|
<title>負のインデックスの例</title>
|
|
<simpara>
|
|
負の整数キー <literal>n</literal> を代入すると、PHP は次のキーを <literal>n+1</literal> に代入します。
|
|
</simpara>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$array = [];
|
|
|
|
$array[-5] = 1;
|
|
$array[] = 2;
|
|
|
|
var_dump($array);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs;
|
|
<screen>
|
|
<![CDATA[
|
|
array(2) {
|
|
[-5]=>
|
|
int(1)
|
|
[-4]=>
|
|
int(2)
|
|
}
|
|
]]>
|
|
</screen>
|
|
|
|
<warning>
|
|
<simpara>
|
|
PHP 8.3.0 より前のバージョンでは、負の整数キー <literal>n</literal> を代入すると、
|
|
次のキーは <literal>0</literal> に代入されていました。
|
|
そのため、前の例は次のように出力されていました:
|
|
</simpara>
|
|
<informalexample>
|
|
<screen>
|
|
<![CDATA[
|
|
array(2) {
|
|
[-5]=>
|
|
int(1)
|
|
[0]=>
|
|
int(2)
|
|
}
|
|
]]>
|
|
</screen>
|
|
</informalexample>
|
|
</warning>
|
|
</example>
|
|
</sect3>
|
|
|
|
<sect3 xml:id="language.types.array.syntax.accessing">
|
|
<title>角括弧構文による配列要素へのアクセス</title>
|
|
|
|
<para>
|
|
配列の要素へのアクセスには <literal>array[key]</literal> 構文を使います。
|
|
</para>
|
|
|
|
<example>
|
|
<title>配列の要素へのアクセス</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$array = array(
|
|
"foo" => "bar",
|
|
42 => 24,
|
|
"multi" => array(
|
|
"dimensional" => array(
|
|
"array" => "foo"
|
|
)
|
|
)
|
|
);
|
|
|
|
var_dump($array["foo"]);
|
|
var_dump($array[42]);
|
|
var_dump($array["multi"]["dimensional"]["array"]);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs;
|
|
<screen>
|
|
<![CDATA[
|
|
string(3) "bar"
|
|
int(24)
|
|
string(3) "foo"
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
|
|
<note>
|
|
<para>
|
|
PHP 8.0.0 より前のバージョンでは、
|
|
配列の要素にアクセスするときに、
|
|
角括弧と波括弧がどちらも同じ意味で使えていました。
|
|
(つまり、この例で <literal>$array[42]</literal> と <literal>$array{42}</literal>
|
|
は同じものを表しているということです)。
|
|
波括弧で配列にアクセスする文法は、
|
|
PHP 7.4.0 以降は非推奨になり、
|
|
PHP 8.0.0 以降はサポートされなくなっています。
|
|
</para>
|
|
</note>
|
|
|
|
<example>
|
|
<title>配列のデリファレンス</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
function getArray() {
|
|
return array(1, 2, 3);
|
|
}
|
|
|
|
$secondElement = getArray()[1];
|
|
|
|
var_dump($secondElement);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
<note>
|
|
<para>
|
|
配列に定義されていないキーへアクセスしたときの挙動は、
|
|
未定義の変数にアクセスしたときと同じです。
|
|
つまり、<constant>E_WARNING</constant> レベルの警告
|
|
(PHP 8.0.0 より前のバージョンでは <constant>E_NOTICE</constant>)
|
|
が発生し、結果が &null; になります。
|
|
</para>
|
|
</note>
|
|
<note>
|
|
<para>
|
|
配列で文字列以外のスカラー値をデリファレンスした場合は、
|
|
返される結果は &null; となります。
|
|
PHP 7.4.0 より前のバージョンでは、何もエラーは発生しませんでした。
|
|
PHP 7.4.0 以降では、<constant>E_NOTICE</constant> が発生します。
|
|
PHP 8.0.0 以降では、<constant>E_WARNING</constant> が発生します。
|
|
</para>
|
|
</note>
|
|
</sect3>
|
|
|
|
<sect3 xml:id="language.types.array.syntax.modifying">
|
|
<title>角括弧構文で作成/修正</title>
|
|
|
|
<para>
|
|
明示的に値を設定することにより、既存の配列を修正することも可能です。
|
|
</para>
|
|
|
|
<para>
|
|
これは、角括弧の中にキーを指定し、配列に値を代入することにより行います。
|
|
キーを省略することも可能です。この場合、空の角括弧
|
|
("<literal>[]</literal>") の変数名として追加してください。
|
|
</para>
|
|
|
|
<synopsis>
|
|
$arr[<replaceable>key</replaceable>] = <replaceable>value</replaceable>;
|
|
$arr[] = <replaceable>value</replaceable>;
|
|
// <replaceable>key</replaceable> は <type>string</type> または
|
|
// <type>int</type>のどちらかです。
|
|
// <replaceable>value</replaceable> の型は、何でもかまいません。
|
|
</synopsis>
|
|
|
|
<para>
|
|
<varname>$arr</varname> がまだ存在しない場合、
|
|
あるいは &null; や &false; に設定されている場合は、
|
|
新しく配列を作成します。
|
|
つまり、これは配列を作成する方法のひとつでもあります。
|
|
とはいえ、この方法を使うことはおすすめしません。なぜなら、既に
|
|
<varname>$arr</varname> に何らかの値
|
|
(リクエスト変数からの文字列など) が入っている場合にはその値がそのまま残り、
|
|
<literal>[]</literal> が実際には
|
|
<link linkend="language.types.string.substr">文字列アクセス演算子</link>
|
|
を表してしまうからです。
|
|
変数を初期化するときには、直接代入するほうがよいでしょう。
|
|
</para>
|
|
<note>
|
|
<simpara>
|
|
PHP 7.1.0 以降では、文字列に空のインデックス演算子を適用すると
|
|
致命的なエラーが発生するようになりました。
|
|
これまでのバージョンではエラーにならず、文字列が配列に変換されていました。
|
|
</simpara>
|
|
</note>
|
|
<note>
|
|
<simpara>
|
|
PHP 8.1.0 以降では、
|
|
&false; に設定している値から新しく配列を作成することは推奨されません。
|
|
&null; や未定義の値から配列を新しく作成することはまだ許可されています。
|
|
</simpara>
|
|
</note>
|
|
|
|
<para>
|
|
ある値を変更するには、
|
|
新しい値に値を代入します。特定のキー/値の組を削除したい場合には、
|
|
<function>unset</function> を使用する必要があります。
|
|
</para>
|
|
|
|
<example>
|
|
<title>角括弧と配列の使用</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$arr = array(5 => 1, 12 => 2);
|
|
|
|
$arr[] = 56; // このスクリプトのこの位置に記述した場合、
|
|
// $arr[13] = 56; と同じです
|
|
|
|
$arr["x"] = 42; // キー"x"の新しい要素を配列に追加します
|
|
|
|
unset($arr[5]); // 配列から要素を削除します
|
|
|
|
var_dump($arr);
|
|
|
|
unset($arr); // 配列全体を削除します
|
|
|
|
var_dump($arr);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
<note>
|
|
<para>
|
|
上記のように、キーを省略して新規要素を追加する場合、
|
|
追加される数値添字は、使用されている添字の最大値 +1 (ただし、少なくとも 0 以上) になります。
|
|
まだ数値添字が存在しない場合は、添字は <literal>0</literal>
|
|
(ゼロ) となります。
|
|
</para>
|
|
|
|
<warning>
|
|
<simpara>
|
|
PHP 4.3.0 以降、上記のような添字生成動作は変更されました。
|
|
現在では、配列に追加する際に、
|
|
その配列の最大添字が負である場合は次の添字はゼロ
|
|
(<literal>0</literal>) となります。
|
|
以前は、正の添字の場合と同様に新しい添字は最大添字に +1
|
|
したものがセットされました。
|
|
</simpara>
|
|
</warning>
|
|
|
|
<para>
|
|
次のキー生成において、オフセットとして使われる整数値
|
|
(添字の最大値) に対応するエントリーが、
|
|
必ずしも配列内に存在するわけではないことに注意してください。
|
|
しかし、その値は、多くの場合、
|
|
配列にある整数のキー値の最大値と等しいはずです。以下に例を示します。
|
|
</para>
|
|
|
|
<informalexample>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
// 簡単な配列を生成します。
|
|
$array = array(1, 2, 3, 4, 5);
|
|
print_r($array);
|
|
|
|
// 全てのアイテムを削除しますが、配列自体は削除しないでおきます。
|
|
foreach ($array as $i => $value) {
|
|
unset($array[$i]);
|
|
}
|
|
print_r($array);
|
|
|
|
// アイテムを追加します(新しい添え字は0ではなく
|
|
// 5となることに注意)
|
|
$array[] = 6;
|
|
print_r($array);
|
|
|
|
// 添え字を振りなおします。
|
|
$array = array_values($array);
|
|
$array[] = 7;
|
|
print_r($array);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs;
|
|
<screen>
|
|
<![CDATA[
|
|
Array
|
|
(
|
|
[0] => 1
|
|
[1] => 2
|
|
[2] => 3
|
|
[3] => 4
|
|
[4] => 5
|
|
)
|
|
Array
|
|
(
|
|
)
|
|
Array
|
|
(
|
|
[5] => 6
|
|
)
|
|
Array
|
|
(
|
|
[0] => 6
|
|
[1] => 7
|
|
)
|
|
]]>
|
|
</screen>
|
|
</informalexample>
|
|
|
|
</note>
|
|
|
|
</sect3>
|
|
|
|
<sect3 xml:id="language.types.array.syntax.destructuring">
|
|
<title>配列の分解</title>
|
|
|
|
<para>
|
|
配列は、言語構造 <literal>[]</literal> (PHP 7.1.0 以降)
|
|
または、<function>list</function> を使って分解することができます。
|
|
これらの言語構造は、
|
|
配列を個別の値に分解する用途に使えます。
|
|
</para>
|
|
|
|
<example>
|
|
<title>配列の分解</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$source_array = ['foo', 'bar', 'baz'];
|
|
|
|
[$foo, $bar, $baz] = $source_array;
|
|
|
|
echo $foo, PHP_EOL; // "foo" を出力します。
|
|
echo $bar, PHP_EOL; // "bar" を出力します。
|
|
echo $baz, PHP_EOL; // "baz" を出力します。
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
<para>
|
|
これは、多次元配列を &foreach; で反復処理しながら分解する用途に使えます。
|
|
</para>
|
|
|
|
<example>
|
|
<title>foreach での配列の分解</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$source_array = [
|
|
[1, 'John'],
|
|
[2, 'Jane'],
|
|
];
|
|
|
|
foreach ($source_array as [$id, $name]) {
|
|
echo "{$id}: '{$name}'\n";
|
|
}
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
<para>
|
|
変数が与えられない配列の要素は無視されます。
|
|
配列の分解は、常にインデックス <literal>0</literal> から始まります。
|
|
</para>
|
|
|
|
<example>
|
|
<title>要素を無視する</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$source_array = ['foo', 'bar', 'baz'];
|
|
|
|
// インデックス2の要素を、変数 $baz に代入します
|
|
[, , $baz] = $source_array;
|
|
|
|
echo $baz; // "baz" を出力します。
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
<para>
|
|
PHP 7.1.0 以降では、
|
|
連想配列も分解できるようになりました。
|
|
数値をキーとした配列の右側の要素を、
|
|
インデックスを明示的に指定することで簡単に選択できるようになっています。
|
|
</para>
|
|
|
|
<example>
|
|
<title>連想配列の分解</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$source_array = ['foo' => 1, 'bar' => 2, 'baz' => 3];
|
|
|
|
// インデックス 'baz' の要素を、変数 $three に代入します。
|
|
['baz' => $three] = $source_array;
|
|
|
|
echo $three, PHP_EOL; // 3 を出力します。
|
|
|
|
$source_array = ['foo', 'bar', 'baz'];
|
|
|
|
// インデックス 2 の要素を、変数 $baz に代入します。
|
|
[2 => $baz] = $source_array;
|
|
|
|
echo $baz, PHP_EOL; // "baz" を出力します。
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
<para>
|
|
配列の分解を使うと、2つの変数を簡単に入れ替えることができます。
|
|
</para>
|
|
|
|
<example>
|
|
<title>2つの変数の入れ替え</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$a = 1;
|
|
$b = 2;
|
|
|
|
[$b, $a] = [$a, $b];
|
|
|
|
echo $a, PHP_EOL; // 2 を出力します。
|
|
echo $b, PHP_EOL; // 1 を出力します。
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
<note>
|
|
<para>
|
|
分解時に値を代入する際には、<literal>...</literal> 演算子はサポートされていません。
|
|
</para>
|
|
</note>
|
|
|
|
<note>
|
|
<para>
|
|
定義されていない配列のキーにアクセスしようとすると、
|
|
未定義の変数にアクセスする場合と同じ扱いになります。
|
|
つまり、<constant>E_WARNING</constant> レベルの警告
|
|
(PHP 8.0.0 より前のバージョンでは <constant>E_NOTICE</constant>)
|
|
が発生し、結果が &null; になります。
|
|
</para>
|
|
</note>
|
|
<note>
|
|
<para>
|
|
スカラー値を分解すると、全ての変数に &null; が代入されます。
|
|
</para>
|
|
</note>
|
|
</sect3>
|
|
|
|
</sect2><!-- end syntax -->
|
|
|
|
<sect2 xml:id="language.types.array.useful-funcs">
|
|
<title>有用な関数</title>
|
|
|
|
<para>
|
|
配列で使用する便利な関数がたくさんあります。
|
|
<link linkend="ref.array">配列関数</link> の節を参照ください。
|
|
</para>
|
|
|
|
<note>
|
|
<para>
|
|
<function>unset</function>関数は配列のキーを削除することが出来ます。
|
|
ただし、これによってインデックスの再構築が行われるわけではないことに
|
|
注意してください。
|
|
"通常の整数添字" (0 から始まり、1 つずつ増加) のみを使用している場合、
|
|
<function>array_values</function>
|
|
を用いてインデックスを再構築することができます。
|
|
</para>
|
|
|
|
<example>
|
|
<title>中間にある要素を unset する</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$a = array(1 => 'one', 2 => 'two', 3 => 'three');
|
|
|
|
/* これにより配列は以下の様に定義されます。
|
|
$a = array(1 => 'one', 3 => 'three');
|
|
以下ではありません：
|
|
$a = array(1 => 'one', 2 =>'three');
|
|
*/
|
|
unset($a[2]);
|
|
var_dump($a);
|
|
|
|
$b = array_values($a);
|
|
// $b は、array(0 => 'one', 1 =>'three')となります
|
|
var_dump($b);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</note>
|
|
|
|
<para>
|
|
配列専用の制御構造として &foreach; があります。
|
|
この構造は、配列の要素に簡単に連続的にアクセスする手段を提供します。
|
|
</para>
|
|
</sect2>
|
|
|
|
<sect2 xml:id="language.types.array.donts">
|
|
<title>配列ですべきこととしてはならないこと</title>
|
|
|
|
<sect3 xml:id="language.types.array.foo-bar">
|
|
<title>なぜ、<literal>$foo[bar]</literal> は使用できないのか?</title>
|
|
|
|
<para>
|
|
連想配列の添字の前後は常に引用符で括る必要があります。
|
|
例えば、$foo[bar] ではなく $foo['bar'] を使用してください。
|
|
しかし、$foo[bar] はなぜ誤りなのでしょうか?
|
|
古いスクリプトで次のような構文を見たことがあるかもしれません。
|
|
</para>
|
|
|
|
<informalexample>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$foo[bar] = 'enemy';
|
|
echo $foo[bar];
|
|
// etc
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</informalexample>
|
|
|
|
<para>
|
|
これは間違っていますが、動作します。では、なぜ間違っているのでしょう?
|
|
それは、このコードには文字列 (<literal>'bar'</literal> - 引用符で括られている)
|
|
ではなく未定義の定数 (<literal>bar</literal>) が使用されているためです。
|
|
下位互換性の維持のため、未定義の定数は同じ名前の文字列に自動的に変換されます。
|
|
そのため、このコードは動作します。
|
|
例えば、<constant>bar</constant> という名前の定義されていない定数があるとすると、
|
|
PHP は <literal>'bar'</literal> という文字列でそれを置換して使用します。
|
|
</para>
|
|
<warning>
|
|
<simpara>
|
|
生の文字列を未定義の定数として扱う振る舞いは、
|
|
<constant>E_NOTICE</constant>
|
|
レベルの警告が発生します。
|
|
この振る舞いは PHP 7.2.0 以降は推奨されなくなり、
|
|
<constant>E_WARNING</constant> レベルの警告が発生します。
|
|
PHP 8.0.0 以降は、この振る舞いは削除され、
|
|
<classname>Error</classname> 例外がスローされるようになっています。
|
|
</simpara>
|
|
</warning>
|
|
|
|
<simpara>
|
|
これは、キーを <emphasis>常に</emphasis> クォートするという意味ではありません。
|
|
<link linkend="language.constants">定数</link>や
|
|
<link linkend="language.variables">変数</link>
|
|
をキーとして使う際には、クォートしてしまうと PHP
|
|
はそれを解釈できなくなってしまいます。
|
|
</simpara>
|
|
|
|
<example>
|
|
<title>キーのクォート</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
error_reporting(E_ALL);
|
|
ini_set('display_errors', true);
|
|
ini_set('html_errors', false);
|
|
|
|
// 単純な配列
|
|
$array = array(1, 2);
|
|
$count = count($array);
|
|
|
|
for ($i = 0; $i < $count; $i++) {
|
|
echo "\nChecking $i: \n";
|
|
echo "Bad: " . $array['$i'] . "\n";
|
|
echo "Good: " . $array[$i] . "\n";
|
|
echo "Bad: {$array['$i']}\n";
|
|
echo "Good: {$array[$i]}\n";
|
|
}
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs;
|
|
<screen>
|
|
<![CDATA[
|
|
Checking 0:
|
|
Notice: Undefined index: $i in /path/to/script.html on line 9
|
|
Bad:
|
|
Good: 1
|
|
Notice: Undefined index: $i in /path/to/script.html on line 11
|
|
Bad:
|
|
Good: 1
|
|
|
|
Checking 1:
|
|
Notice: Undefined index: $i in /path/to/script.html on line 9
|
|
Bad:
|
|
Good: 2
|
|
Notice: Undefined index: $i in /path/to/script.html on line 11
|
|
Bad:
|
|
Good: 2
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
|
|
<para>
|
|
この具体例を以下に示します。
|
|
</para>
|
|
|
|
<example>
|
|
<title>その他の例</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
// エラーを全て表示するよう設定
|
|
error_reporting(E_ALL);
|
|
|
|
$arr = array('fruit' => 'apple', 'veggie' => 'carrot');
|
|
|
|
// 正しい
|
|
echo $arr['fruit'], PHP_EOL; // apple
|
|
echo $arr['veggie'], PHP_EOL; // carrot
|
|
|
|
// 間違い。未定義の定数fruitを使用しているため動作せず、
|
|
// PHP がエラーを発生させます。
|
|
//
|
|
// Error: Undefined constant "fruit"
|
|
try {
|
|
echo $arr[fruit];
|
|
} catch (Error $e) {
|
|
echo get_class($e), ': ', $e->getMessage(), PHP_EOL;
|
|
}
|
|
|
|
// 検証のため、定数を定義してみましょう。
|
|
// fruitという名前の定数に値'veggie'を代入します。
|
|
define('fruit', 'veggie');
|
|
|
|
// ここでは、出力が異なることに注意してください。
|
|
echo $arr['fruit'], PHP_EOL; // apple
|
|
echo $arr[fruit], PHP_EOL; // carrot
|
|
|
|
// 以下は文字列の中であるためOKです。定数は、文字列の中では解釈されな
|
|
// いため、エラーはここでは発生しません。
|
|
echo "Hello $arr[fruit]", PHP_EOL; // Hello apple
|
|
|
|
// 例外が１つあり、文字列の中で波括弧で配列を括った場合には、
|
|
// 定数が解釈されます
|
|
echo "Hello {$arr[fruit]}", PHP_EOL; // Hello carrot
|
|
echo "Hello {$arr['fruit']}", PHP_EOL; // Hello apple
|
|
|
|
// 文字列結合で同じことをすることもできます
|
|
echo "Hello " . $arr['fruit'], PHP_EOL; // Hello apple
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
<informalexample>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
// これは動作せず、以下のようなパースエラーを発生します:
|
|
// Parse error: parse error, expecting T_STRING' or T_VARIABLE' or T_NUM_STRING'
|
|
// 文字列の中でスーパーグローバルを使用した場合も無論同様です。
|
|
print "Hello $arr['fruit']";
|
|
print "Hello $_GET['foo']";
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</informalexample>
|
|
|
|
<para>
|
|
<link linkend="language.types.array.syntax"
|
|
>構文</link> で説明した通り、角括弧
|
|
('<literal>[</literal>' および '<literal>]</literal>')
|
|
の間には、式がなければなりません。つまり、
|
|
次のように書けるということです。
|
|
</para>
|
|
|
|
<informalexample>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
echo $arr[somefunc($bar)];
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</informalexample>
|
|
|
|
<para>
|
|
これは、関数の戻り値を配列の添字として使用する例です。PHP
|
|
は定数についても認識します。以下のような <literal>E_*</literal>
|
|
の使用例を見たことがあるかもしれません。
|
|
</para>
|
|
|
|
<informalexample>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$error_descriptions[E_ERROR] = "A fatal error has occurred";
|
|
$error_descriptions[E_WARNING] = "PHP issued a warning";
|
|
$error_descriptions[E_NOTICE] = "This is just an informal notice";
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</informalexample>
|
|
|
|
<para>
|
|
最初の例の <literal>bar</literal> と全く同様に
|
|
<constant>E_ERROR</constant> も有効な添字であることに注意してください。
|
|
しかし、実際には最後の例は次のように書くことと同じです。
|
|
</para>
|
|
|
|
<informalexample>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$error_descriptions[1] = "A fatal error has occurred";
|
|
$error_descriptions[2] = "PHP issued a warning";
|
|
$error_descriptions[8] = "This is just an informal notice";
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</informalexample>
|
|
|
|
<para>
|
|
これは、<constant>E_ERROR</constant> が <literal>1</literal>
|
|
と等しいこと等によります。
|
|
</para>
|
|
|
|
<sect4 xml:id="language.types.array.foo-bar.why">
|
|
<title>では、なぜ間違っているのでしょう?</title>
|
|
|
|
<para>
|
|
将来的に、PHP 開発チームが他の定数またはキーワードを追加したいと思うかもしれず、
|
|
問題となる可能性があります。例えば、現在でも、
|
|
単語 <literal>empty</literal> および
|
|
<literal>default</literal>を使用することはできません。
|
|
これは、これらが特別な
|
|
<link linkend="reserved">予約済みのキーワード</link>であるためです。
|
|
</para>
|
|
|
|
<note>
|
|
<simpara>
|
|
二重引用符で括られた <type>string</type> の中では
|
|
引用符で配列の添字を括らないことができ、このため、
|
|
<literal>"$foo[bar]"</literal> は有効です。
|
|
この理由の詳細については、上記の例や
|
|
<link linkend="language.types.string.parsing">
|
|
文字列中での変数のパース</link>を参照ください。
|
|
</simpara>
|
|
</note>
|
|
|
|
</sect4>
|
|
</sect3>
|
|
</sect2>
|
|
|
|
<sect2 xml:id="language.types.array.casting">
|
|
<title>配列への変換</title>
|
|
|
|
<para>
|
|
<type>int</type>, <type>float</type>, <type>string</type>,
|
|
<type>bool</type>, <type>resource</type>のいずれの型においても、
|
|
<type>array</type> に変換する場合、
|
|
最初のスカラー値が割り当てられている一つの要素 (添字は 0)
|
|
を持つ配列を得ることになります。
|
|
言い換えると、<code>(array) $scalarValue</code>
|
|
は、<literal>array($scalarValue)</literal> と全く同じです。
|
|
</para>
|
|
|
|
<para>
|
|
<type>object</type>を配列にする場合には、配列の要素として
|
|
オブジェクトの属性 (メンバ変数) を持つ配列を得ることになります。
|
|
添字はメンバ変数名となりますが、いくつか注意すべき例外があります。
|
|
整数のプロパティはアクセス不能になります。
|
|
private 変数の場合、変数名の頭にクラス名がつきます。また、
|
|
protected 変数の場合は、変数名の頭に '*' がつきます。
|
|
このとき、頭に追加される値の前後に <literal>NUL</literal> バイトがついてきます。
|
|
未初期化の
|
|
<link linkend="language.oop5.properties.typed-properties">型付きプロパティ</link> は黙って捨てられます。
|
|
</para>
|
|
|
|
<example>
|
|
<title>配列への変換</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
|
|
class A {
|
|
private $B;
|
|
protected $C;
|
|
public $D;
|
|
function __construct()
|
|
{
|
|
$this->{1} = null;
|
|
}
|
|
}
|
|
var_export((array) new A());
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs;
|
|
<screen>
|
|
<![CDATA[
|
|
array (
|
|
'' . "\0" . 'A' . "\0" . 'B' => NULL,
|
|
'' . "\0" . '*' . "\0" . 'C' => NULL,
|
|
'D' => NULL,
|
|
1 => NULL,
|
|
)
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
|
|
<para>
|
|
これらの <literal>NUL</literal> バイトは、以下のような予期せぬ振る舞いをすることがあります:
|
|
</para>
|
|
|
|
<example>
|
|
<title>オブジェクトを配列にキャストする</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
|
|
class A {
|
|
private $A; // これは '\0A\0A' となります
|
|
}
|
|
|
|
class B extends A {
|
|
private $A; // これは '\0B\0A' となります
|
|
public $AA; // これは 'AA' となります
|
|
}
|
|
|
|
var_dump((array) new B());
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs;
|
|
<screen>
|
|
<![CDATA[
|
|
array(3) {
|
|
["BA"]=>
|
|
NULL
|
|
["AA"]=>
|
|
NULL
|
|
["AA"]=>
|
|
NULL
|
|
}
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
|
|
<para>
|
|
上の例では 'AA' というキーがふたつあるように見えますが、
|
|
そのうちひとつは、実際は '\0A\0A' ということになります。
|
|
</para>
|
|
|
|
<para>
|
|
&null; を配列に変換すると、空の配列を得ます。
|
|
</para>
|
|
</sect2>
|
|
|
|
<sect2 xml:id="language.types.array.comparing">
|
|
<title>比較</title>
|
|
|
|
<para>
|
|
<function>array_diff</function> と
|
|
<link linkend="language.operators.array">配列演算子</link>
|
|
を用いると、配列を比較することができます。
|
|
</para>
|
|
</sect2>
|
|
|
|
<sect2 xml:id="language.types.array.unpacking">
|
|
<title>配列のアンパック</title>
|
|
|
|
<para>
|
|
配列の前に <code>...</code> を付けると、
|
|
配列を定義する際に、その配列の値を展開(アンパック)させることができます。
|
|
配列と、<interfacename>Traversable</interfacename>
|
|
を実装したオブジェクトを展開させることができます。
|
|
<code>...</code> を使った配列のアンパックは、
|
|
PHP 7.4.0 以降で利用可能です。これは、スプレッド演算子とも呼ばれます。
|
|
</para>
|
|
|
|
<para>
|
|
配列のアンパックは、配列中で何度でも行うことができます。
|
|
<code>...</code> の前後に通常の要素を置くこともできます:
|
|
|
|
<example>
|
|
<title>簡単な配列のアンパック</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
// 配列の短縮構文を使っています。
|
|
// array() 記法も使えます。
|
|
$arr1 = [1, 2, 3];
|
|
$arr2 = [...$arr1]; // [1, 2, 3]
|
|
$arr3 = [0, ...$arr1]; // [0, 1, 2, 3]
|
|
$arr4 = [...$arr1, ...$arr2, 111]; // [1, 2, 3, 1, 2, 3, 111]
|
|
$arr5 = [...$arr1, ...$arr1]; // [1, 2, 3, 1, 2, 3]
|
|
|
|
function getArr() {
|
|
return ['a', 'b'];
|
|
}
|
|
$arr6 = [...getArr(), 'c' => 'd']; // ['a', 'b', 'c' => 'd']
|
|
|
|
var_dump($arr1, $arr2, $arr3, $arr4, $arr5, $arr6);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</para>
|
|
|
|
<para>
|
|
<code>...</code> を使ったアンパックの動作は、
|
|
<function>array_merge</function> 関数の仕様に従います。
|
|
つまり、キーが文字列の場合は後に指定された値が前の値を上書きしますし、
|
|
キーが整数の場合は、ゼロから値が振り直されます:
|
|
|
|
<example>
|
|
<title>キーが重複した場合の配列のアンパック</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
// キーが文字列の場合
|
|
$arr1 = ["a" => 1];
|
|
$arr2 = ["a" => 2];
|
|
$arr3 = ["a" => 0, ...$arr1, ...$arr2];
|
|
var_dump($arr3); // ["a" => 2]
|
|
|
|
// キーが整数の場合
|
|
$arr4 = [1, 2, 3];
|
|
$arr5 = [4, 5, 6];
|
|
$arr6 = [...$arr4, ...$arr5];
|
|
var_dump($arr6); // [1, 2, 3, 4, 5, 6]
|
|
// $arr6 は、 [0 => 1, 1 => 2, 2 => 3, 3 => 4, 4 => 5, 5 => 6] と同義です。
|
|
// ここでは、キーの値は保存されません。
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</para>
|
|
|
|
<note>
|
|
<para>
|
|
キーが整数でも文字列でもない場合は、
|
|
<classname>TypeError</classname> がスローされます。
|
|
そのようなキーを持つ値は、
|
|
<interfacename>Traversable</interfacename>
|
|
オブジェクト経由でしか生成できません。
|
|
</para>
|
|
</note>
|
|
<note>
|
|
<para>
|
|
PHP 8.1 より前のバージョンでは、
|
|
キーが文字列の場合に、アンパックをサポートしていませんでした:
|
|
</para>
|
|
<informalexample>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
|
|
$arr1 = [1, 2, 3];
|
|
$arr2 = ['a' => 4];
|
|
$arr3 = [...$arr1, ...$arr2];
|
|
// Fatal error: Uncaught Error: Cannot unpack array with string keys in example.php:5
|
|
|
|
$arr4 = [1, 2, 3];
|
|
$arr5 = [4, 5];
|
|
$arr6 = [...$arr4, ...$arr5]; // 動作します。 [1, 2, 3, 4, 5]
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</informalexample>
|
|
</note>
|
|
|
|
</sect2>
|
|
|
|
<sect2 xml:id="language.types.array.examples">
|
|
<title>例</title>
|
|
|
|
<para>
|
|
PHP の配列型は、いろいろな使い方ができます。配列の強力な機能を示すため、
|
|
ここでいくつかの例を紹介します。
|
|
</para>
|
|
|
|
<example>
|
|
<title>多様な配列</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
// これは、
|
|
$a = array( 'color' => 'red',
|
|
'taste' => 'sweet',
|
|
'shape' => 'round',
|
|
'name' => 'apple',
|
|
4 // キーは0になります
|
|
);
|
|
|
|
$b = array('a', 'b', 'c');
|
|
|
|
var_dump($a, $b);
|
|
|
|
// 完全にこれと同じです。
|
|
$a = array();
|
|
$a['color'] = 'red';
|
|
$a['taste'] = 'sweet';
|
|
$a['shape'] = 'round';
|
|
$a['name'] = 'apple';
|
|
$a[] = 4; // キーは0になります
|
|
|
|
$b = array();
|
|
$b[] = 'a';
|
|
$b[] = 'b';
|
|
$b[] = 'c';
|
|
|
|
// 上のコードを実行すると、$a は次のような配列
|
|
// array('color' => 'red', 'taste' => 'sweet', 'shape' => 'round',
|
|
// 'name' => 'apple', 0 => 4) となり、$b は
|
|
// array(0 => 'a', 1 => 'b', 2 => 'c') あるいは単に array('a', 'b', 'c') となります
|
|
|
|
var_dump($a, $b);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
<example>
|
|
<title>array() の使用例</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
// マップを行う配列
|
|
$map = array( 'version' => 4,
|
|
'OS' => 'Linux',
|
|
'lang' => 'english',
|
|
'short_tags' => true
|
|
);
|
|
var_dump($map);
|
|
|
|
// 数値キーのみを有する
|
|
// これは、array(0 => 7, 1 => 8, ...) と同じです
|
|
$array = array( 7,
|
|
8,
|
|
0,
|
|
156,
|
|
-10
|
|
);
|
|
var_dump($array);
|
|
|
|
$switching = array( 10, // key = 0
|
|
5 => 6,
|
|
3 => 7,
|
|
'a' => 4,
|
|
11, // key = 6 (最大の添字は5です)
|
|
'8' => 2, // key = 8 (整数!)
|
|
'02' => 77, // key = '02'
|
|
0 => 12 // 値10は12で上書きされます
|
|
);
|
|
var_dump($switching);
|
|
|
|
// 空の配列
|
|
$empty = array();
|
|
var_dump($empty);
|
|
?>
|
|
]]>
|
|
<!-- TODO example of
|
|
- overwriting keys
|
|
- using vars/functions as key/values
|
|
- warning about references
|
|
-->
|
|
</programlisting>
|
|
</example>
|
|
|
|
<example xml:id="language.types.array.examples.loop">
|
|
<title>コレクション</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$colors = array('red', 'blue', 'green', 'yellow');
|
|
|
|
foreach ($colors as $color) {
|
|
echo "Do you like $color?\n";
|
|
}
|
|
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs;
|
|
<screen>
|
|
<![CDATA[
|
|
Do you like red?
|
|
Do you like blue?
|
|
Do you like green?
|
|
Do you like yellow?
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
|
|
<para>
|
|
配列を参照渡しすることでその値を直接変更できます。
|
|
</para>
|
|
|
|
<example xml:id="language.types.array.examples.changeloop">
|
|
<title>ループ内での要素の変更</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$colors = array('red', 'blue', 'green', 'yellow');
|
|
|
|
foreach ($colors as &$color) {
|
|
$color = mb_strtoupper($color);
|
|
}
|
|
unset($color); /* これ以降の $color への書き込みが
|
|
配列の要素を書き換えてしまわないことを保証する */
|
|
|
|
print_r($colors);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs;
|
|
<screen>
|
|
<![CDATA[
|
|
Array
|
|
(
|
|
[0] => RED
|
|
[1] => BLUE
|
|
[2] => GREEN
|
|
[3] => YELLOW
|
|
)
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
|
|
<para>
|
|
この例は、1 から始まる配列を作成します。
|
|
</para>
|
|
|
|
<example>
|
|
<title>1 から始まる添字</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$firstquarter = array(1 => 'January', 'February', 'March');
|
|
print_r($firstquarter);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs;
|
|
<screen>
|
|
<![CDATA[
|
|
Array
|
|
(
|
|
[1] => January
|
|
[2] => February
|
|
[3] => March
|
|
)
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
|
|
<example>
|
|
<title>配列に代入する</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
// ディレクトリから全てのアイテムを配列に代入する
|
|
$handle = opendir('.');
|
|
while (false !== ($file = readdir($handle))) {
|
|
$files[] = $file;
|
|
}
|
|
closedir($handle);
|
|
|
|
var_dump($files);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
<para>
|
|
配列には順番が付けられます。異なったソート関数を用いて順番を変更することも可能です。
|
|
より詳細な情報については、<link linkend="ref.array">配列関数</link> を参照ください。
|
|
<function>count</function> 関数を使用することで、
|
|
配列の要素数を数えることが可能です。
|
|
</para>
|
|
|
|
<example>
|
|
<title>配列のソート</title>
|
|
<programlisting role="php" annotations="non-interactive">
|
|
<![CDATA[
|
|
<?php
|
|
sort($files);
|
|
print_r($files);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
<para>
|
|
配列の値は何でも良いため、その値を他の配列とすることも可能です。
|
|
これにより、再帰的な配列や多次元の配列を作成することが可能です。
|
|
</para>
|
|
|
|
<example>
|
|
<title>再帰および多次元配列</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?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"
|
|
)
|
|
);
|
|
var_dump($fruits);
|
|
|
|
// 上の配列の内容を取得するための例
|
|
echo $fruits["holes"][5]; // "second" を表示します
|
|
echo $fruits["fruits"]["a"]; // "orange" を表示します
|
|
unset($fruits["holes"][0]); // "first" を削除します
|
|
|
|
// 新しい多次元配列を作成します
|
|
$juices["apple"]["green"] = "good";
|
|
var_dump($juices);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
<para>
|
|
配列への代入においては、常に値がコピーされることに注意してください。
|
|
配列をリファレンスでコピーする場合には、
|
|
リファレンス演算子を使う必要があります。
|
|
</para>
|
|
|
|
<example>
|
|
<title>配列のコピー</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$arr1 = array(2, 3);
|
|
$arr2 = $arr1;
|
|
$arr2[] = 4; // $arr2 が変更されます。
|
|
// $arr1 は array(2,3) のままです。
|
|
|
|
$arr3 = &$arr1;
|
|
$arr3[] = 4; // $arr1 と $arr3 は同じ内容になります。
|
|
|
|
var_dump($arr1, $arr2, $arr3);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
</sect2>
|
|
</sect1>
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
indent-tabs-mode:nil
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
vim600: syn=xml fen fdm=syntax fdl=2 si
|
|
vim: et tw=78 syn=sgml
|
|
vi: ts=1 sw=1
|
|
-->
|