str_replace

関数の概要

str_replaceは、PHPで文字列の一部を別の文字列に置き換えるための関数です。指定した検索文字列を見つけて、対応する置換文字列に置き換えます。文字列操作の中でも非常に基本的かつよく使われる関数で、文章の編集やデータの加工など様々な場面で役立ちます。

パラメータの説明

  • $search（必須）: 置換したい対象の文字列または文字列の配列。
  • $replace（必須）: $searchで指定した文字列を置換する文字列または文字列の配列。
  • $subject（必須）: 置換を行う対象の文字列または文字列の配列。
  • &$count（任意）: 置換が行われた回数を格納する変数（参照渡し）。

戻り値

置換処理が行われたあとの文字列を返します。$subjectが配列の場合は、置換後の文字列の配列が返ります。

使用例

基本的な使い方

$text = "こんにちは、世界！";
$replaced = str_replace("世界", "PHP", $text);
echo $replaced; // こんにちは、PHP！

文字列の「世界」を「PHP」に置き換えています。結果は「こんにちは、PHP！」となります。

複数の文字列を一度に置換する

$text = "赤いリンゴと青い空";
$search = ["赤い", "青い"];
$replace = ["青い", "赤い"];
$replaced = str_replace($search, $replace, $text);
echo $replaced; // 青いリンゴと赤い空

複数の語句を同時に入れ替えることも可能です。ここでは「赤い」と「青い」を互いに置き換えています。

置換回数を取得する

$text = "PHPはPHPでPHPだ";
$count = 0;
$replaced = str_replace("PHP", "JavaScript", $text, $count);
echo $replaced; // JavaScriptはJavaScriptでJavaScriptだ
echo "置換回数: " . $count; // 置換回数: 3

4つ目のパラメータを使うと、実際に置換が行われた回数を取得することができます。

関連する関数

  • str_ireplace – 大文字・小文字を区別せずに文字列置換を行う
  • preg_replace – 正規表現を使った高度な文字列置換を行う
  • substr_replace – 指定した位置の文字列を置換する

まとめ

str_replaceはPHPで文字列を置き換える際の基本関数で、使い方が簡単で高速に動作します。単純な文字列置換に最適であり、配列にも対応しているため複数の置換も一度に処理可能です。文字列操作を行う際にはぜひ活用してください。

スポンサーリンク