定義と使い方
- PHPバージョン
- 4+
join() 関数は、配列の要素を1つの文字列に結合(変換)する関数です。
指定した配列の各要素を、パラメータで指定した区切り文字で連結し、1つの文字列として返します。
基本例
$colors = ['red', 'green', 'blue'];
$comma_separated = implode(', ', $colors); // ',' で区切って連結
echo $comma_separated; // 出力: 'red, green, blue'
構文
join(string $separator, array $array): string
パラメータ
$separator |
オプション。配列の各要素を連結するときに使用する区切り文字です。 デフォルト値は空の文字列( '')です。 |
|---|---|
$array |
文字列に結合する配列です。 |
戻り値
join()関数は、配列の要素を順番に区切り文字で結合して生成した文字列を返します。
使用例
join()関数の使い方について説明します。
基本的な使い方
$fruits = ['apple', 'banana', 'orange'];
$fruits_string = join(', ', $fruits);
echo $fruits_string; // 出力: 'apple, banana, orange'
上記のコードは、配列$fruitsの各要素をカンマとスペース(', ')で区切って1つの文字列に結合し、出力します。
配列の要素をHTMLリストとして連結する
$items = ['Item 1', 'Item 2', 'Item 3'];
$html_list = '<ul><li>' . join('</li><li>', $items) . '</li></ul>';
echo "HTML List:\n" . $html_list;
- Item 1
- Item 2
- Item 3
上記のコードは、配列$itemsの各要素をHTMLリストとして生成し、出力します。
join()関数に渡される配列にオブジェクトが含まれる場合があります
class StringArray {
protected $title;
public function __construct($title)
{
$this->title = $title;
}
public function __toString()
{
return $this->title;
}
}
$array = [
new StringArray('春'),
new StringArray('夏'),
new StringArray('秋'),
new StringArray('冬')
];
echo join(' ', $array); // 出力: '春' '夏' '秋' '冬'
注意点
join()関数に渡す配列には、Boolean型の要素を含めることができます。この場合、予期しない結果が発生する可能性があります。
$booleans_array = [true, true, false, false, true];
$result = join('', $booleans_array);
var_dump($result); // 出力: string(3) '111'
// trueは'1'になり、falseは何も出力されません。