配列：PHPリファレンス
配列に属するゴルフ用語を紹介しています。
array()
arrayは配列、または連想配列を生成するときに使用します。インデックスと値を指定する場合は｢インデックス＝＞値｣のように指定します。インデックスを指定しない場合は0からの連番が自動的にインデックスとしてセットされます。
array_diff()
array_diff関数は配列の差を求めます。2番目以降の配列に存在しない、1番目の配列の要素を返します。配列の差を調べたり、配列が一致するのかを調べたいときに使用が可能です。取り出された差分の値は、新しい配列で返されます。
array_flip()
array_flip関数は配列のインデックスと値を反転します。元の配列のインデックスが値となり、値がインデックスとなる配列が返されます。作成するのインデックスが重複するときは最後の要素がキーとして使用されます。
array_key_exists()
array_key_exists関数は配列にインデックスが存在するかどうかを返します。
array_keys()
array_keys関数は配列全てのインデックスを返します。
array_map()
array_map関数は配列の各要素を関数で処理します。配列値をまとめて処理したいときに使用できます。
array_merge()
array_merge関数は、元の配列の後ろに指定された配列を追加します。インデックスを自動で割り振っている配列の場合、結合後の配列で、インデックスが再度割り振られることに注意が必要です。この点は配列演算子「＋」と異なります。配列演算子「＋」は単純に配列を加算していくので、インデックスも元の値が保持されます。
array_pop()
array_pop関数は配列から末尾の要素を削除します。削除された値が返され、元の配列は要素がひとつ減ります。最後の要素を取り出す用途でも使用可能です。指定した変数の配列が空だった場合には、nullが返されます。
array_push()
array_push関数は配列の末尾に要素を追加します。処理後の配列の要素数が返されるため、元の配列は要素が追加されます。
array_reverse()
array_reverse関数は配列を逆順にしたものを返します。インデックスと値がともに逆順にされますが、インデックスを明示的に指定せずに0から始まる連番インデックスのみ使用のときは一緒に処理されず、処理後に新たに0からの連番が割り振られます。元の連番もそのまま逆順にしたいときには、2番目のパラメータでTRUEを指定します。
array_search()
arra_search関数は配列から指定値を検索し、見つかった場合はインデックスを返します。複数存在する場合は、最初のキーを返します。3番目のパラメータで、型の一致も含めた検索を指定することができます。
array_shift()
array_shift関数は配列のインデックスから、先頭にあるインデックスの要素を取り出します。配列の先頭にあった値が戻り値として返されるため、処理対象の配列は要素が一つ少なくなります。
array_slice()
array_slice関数は配列の一部を取り出します。ただし、もとの配列の内容に変更はありません。3番目のパラメータで指定する、取得する要素数を省略すると指定位置以降の要素全てを返します。
取り出す位置や長さは、添え字としてではなく、配列の内部的な並び順に対して適用されることに注意してください。
array_sum()
array_sum関数は配列配列値の各要素の合計を返します。オンライン投票の総合計など、値が配列にセットされており合計値を必要とするときに使うことができます。
array_unique()
array_unique関数は配列の重複値を削除します。配列内の値について、2回目以降に現れる同じ値が削除されます。インデックスには元の値が保持されます。
array_unshift()
array_unshift関数は1つ以上の配列インデックスの最初に要素を追加します。処理後の配列の要素数が返され、元の配列には要素が追加されます。
array_values()
array_values関数は配列から全ての値を取得します。取得した値と0から始まるインデックスで構成された配列が返されます。
arsort()
arsort関数は配列を値で降順にソートします。その際インデックスと値の関係も維持されます。この関数は、主に実際の要素の並び方が重要であ る連想配列をソートするために使われます。
asort()
asort関数は配列を値で昇順にソートします。降順にソートするarsort関数と逆の動作となりますが、インデックスと値の関係はarsortと同様に維持されます。
count()
count関数は指定した変数に格納されている配列のインデックス数を返します。
配列が使われているプログラムや、PHPの全関数の中で最も多く使われている関数の一つです。
単純に要素数を取得したり、ループや条件文で使われることも多いです。要素数をそのまま利用するケースでは、テキストファイルの行数を取得する用途があります。ループなどでの条件文では、for文やif文で使用されます。
※sizeof関数はcount関数の別名です。
current()
current関数は現在の配列の要素を取得します。
※pos関数はcurrent関数の別名です。
each()
each関数は配列から現在のキーと値のペアを返して、配列の現在位置を示すポインタをひとつ進め、次の要素を返します。ｗｈｉｌｅ文と組み合わせることで、配列の要素を一つずつ処理していく使い方ができます。
end()
end関数はポインタを配列の最後に進め、配列の最後の要素を返します。
extract()
extract関数は、配列を変数にセットします。配列のインデックスを名前に持つ変数に、各要素の値をセットします。言い換えると、配列を個々の変数に展開するため、配列にセットされた値をまとめて変数にセットしたいときに使用することができます。
func_get_args()
func_get_args関数は関数に渡されたパラメータを配列として返します。
in_array()
in_array関数は配列に値が存在するかどうか調べるときに使用します。大文字と小文字は区別されます。
key()
key関数は現在の配列位置における要素のインデックスを返します。
krsort()
krsort関数は配列をインデックスで降順にソートします。インデックスと値の関係は維持されます。この関数は主に連想配列の場合に有用です。
ksort
ksort関数はキーとデータの関係を維持しつつ、配列をインデックスで昇順にソートします。インデックスと値の関係は維持されます。この関数は、主として連想配列において有用です。
list()
listは1つ以上の変数に配列値をセットします。listは関数ではなく、言語構造になります。データベースから取り出したデータのように配列で取得したデータを処理したいようなときに使用できます。
natsort()
natsort関数は配列を自然順でソートします 。
例)「page1、page10、page2」という3つの値。
sort関数→「page1、page10、page2」とアルファベット順でソートされる。
natsort関数→「page1、page2、page10」という自然な並び順にソートされる。
next()
next関数は配列のポインタをひとつ進めて、移動後の次の要素を返します。最後の要素まで到達して、次の要素がない場合は「FALSE」を返します。
prev()
prev関数は配列のポインタをひとつ前に移動して、ひとつ前の要素を返します。next関数と逆の動作を行います。先頭の要素まで到達して、それ以上前に進めない場合は「FALSE」を返します。」
range()
range関数は指定範囲の整数で構成される配列を生成します。一定の間隔で並んだ値で構成される配列を作成したいようなときに使います。入力フォームの選択リストに表示する連番の値を生成する際に便利な関数です。
reset()
reset関数は配列のポインタを先頭へ移動し、配列の最初の要素の値を返します。
rsort()
rsort関数は配列を降順にソートします。この関数は、パラメータの要素に対して新しいキーを割り当てますが、その際、単純にキーを並べ替える代わりに、すでに割り当てられている既存のキーを削除してしまうため注意が必要です。