php implode() 配列要素を連結して文字列に変換（一繋ぎのテキストになる）

PHP4 PHP5 PHP7

php implode() 配列要素を連結して文字列に変換

◆ implode() 内容

◆ implode() パラメーター

◆ implode() 返り値

◆ implode() 変更履歴

php implode() サンプル

php implode() 配列要素を連結して文字列に変換

implode() 書式
string 文字列 = implode('string $glue', array $pieces);
string 文字列 = implode(array $pieces);

説明	配列要素を連結して一繋ぎの文字列に変換する。$glue で要素間に連結文字を挿入できる。バイナリデータに対応。
引数	string $glue	各要素の間に挿入する文字列。デフォルトでは空文字列。
引数	array 必須 $pieces	要素を連結する配列
返り値	string	配列の各要素を連結した文字列

引数の順番はどちらが先に来ても動作します。implode(string $glue, array $array); implode(array $array, string $glue); ですが、通常は implode(string $glue, array $array); の通りに使用します。

サンプル

<?php
$array = array('pen', 'pineapple', 'apple', 'pen');
$ppap = implode('-', $array);
echo $ppap; //pen-pineapple-apple-pen
?>

<?php

$array = array('pen', 'pineapple', 'apple', 'pen');

$ppap = implode('-', $array);

echo $ppap; //pen-pineapple-apple-pen

データ型引数や返り値のデータ型の説明

引数や返り値	内容（引数 \| 返り値）
string	文字列型を受け入れる。 \| 文字列型を返す。
int	整数型を受け入れる。 \| 整数型を返す。
float	浮動小数点数型を受け入れる。 \| 浮動小数点数型を返す。
bool	論理型を受け入れる。 \| 論理型を返す。
number	整数型または浮動小数点数型を受け入れる。 \| 整数型または浮動小数点数型を返す。
array	配列型を受け入れる。 \| 配列型を返す。
object	オブジェクト型を受け入れる。 \| オブジェクト型を返す。
array\|object	配列型またはオブジェクト型を受け入れる。 \| 配列型またはオブジェクト型を返す。
mixed	複数のデータ型を受け入れる（パラメーター）、或いは、返す（返り値）ことが可能。全てのデータ型ではありません。例えば gettype()関数は全ての型を受け入れますが、一方、str_replace()関数は、文字列型と配列型のみを受け入れます。また、reset()関数や end()関数は、返り値に配列型と論理型（FALSE）を返します。
void	パラメータ一覧で void が使用されている場合、その関数がパラメータを受け付けないことを表します。 \| 返り値の型が void である場合、返り値に意味がないことを表します。
callback	callback 疑似型がこのドキュメントで使われていたのは、PHP 5.4 で callable タイプヒントが導入される前のことでした。両者はまったく同じ意味です。

◆ implode() 内容

配列を1つの文字列に変換

入力した配列のすべての要素を順番を変更せずに、1つなぎの文字列に変換して返します。string $glue を指定すると、各配列要素の間に string $glue 文字列を挿入し、1つの文字列にして返します。
implode()関数はバイナリデータに対応しています。

◆ implode() パラメーター

値	内容
string $glue	各要素の連結間に挿入する文字列（string）。デフォルトは空の文字列になっています。
必須 array $pieces	各要素を連結させたい配列（array）。

◆ implode() 返り値

string
配列の各要素が連結され、1つの文字列に変換された文字列を返します。string $glue を指定すると、各配列要素の間に $glue 文字列が挿入されて返ります。

string 文字列型を返します。

◆ implode() 変更履歴

PHPバージョン	変更内容
–	–

php implode() サンプル

サンプル

入力配列 array $array の要素数が4つで、要素間に挿入する string $glue を「-」にしています。

<?php
$array = array('pen', 'pineapple', 'apple', 'pen');
$ppap = implode('-', $array);
echo $ppap; //pen-pineapple-apple-pen
?>

<?php

$array = array('pen', 'pineapple', 'apple', 'pen');

$ppap = implode('-', $array);

echo $ppap; //pen-pineapple-apple-pen

実行結果

pen-pineapple-apple-pen

サンプル

空の配列を入力すると、空文字列となって返ってきます。

<?php
var_dump(implode(',', array())); // string(0) ""
?>

<?php

var_dump(implode(',', array())); // string(0) ""

実行結果

string(0) ""

サンプル

配列要素が1つ、または、0 でも動作します。特に配列要素が空でもエラーにならないので注意して下さい。

<?php
$aArray1 = array("a", "b", "c", "d", "e");
$aArray2 = array(1, 2, 3, 4, 5);
$aArray3 = array("a");
$aArray4 = array();

echo "aArray1 is: '".implode("','", $aArray1)."'<br>\n";
echo "aArray2 is: '".implode("','", $aArray2)."'<br>\n";
echo "aArray3 is: '".implode("','", $aArray3)."'<br>\n";
echo "aArray4 is: '".implode("','", $aArray4)."'<br>\n";
?>

<?php