PHP 標準関数逆引き辞典

:: reverse dictionary ::

文字列

※ソースファイルについて

プログラムの実行は、自己責任の範囲で行ってください。
改良や再配布はご自由に。
転載・転用は禁止です。（著作権は放棄していません）

文字列の一部を新しい文字列に置き換える

文字列の一部を新しい文字列に置き換えるには、str_replace 関数を使います。

$str = "WindowsサーバとLinuxサーバ";
$result = str_replace("サーバ", "Server", $str);

ソースファイル

$result は "WindowsServerとLinuxServer" になります。

▼ 関数

mixed str_replace(mixed old, mixed new, mixed v)

値 v の中にある old を new に置き換えます。

通常これらの引数には、文字列を指定します。

●引数

old … 現在の値
new … 新しい値
v … 値

●戻り値

値 v の中にある old を new に置き換えた値

●バージョン

PHP3（3.0.6以降）、PHP4 、PHP5

●補足

PHP 4.0.5 以降から配列を指定できます。

配列を指定した場合の動作は、次のとおりです。
（配列以外の値は文字列に仮定）

(1) `old=文字列、new=文字列、v=配列`

配列 v のすべての要素に対して置き換えを行います。
戻り値は配列になります。

要素内の old を new に置き換えます。

(2) `old=文字列、new=配列、v=文字列`

old を "Array" に置き換えます。
（正常な置き換えができません）

(3) `old=文字列、new=配列、v=配列`

配列 v のすべての要素に対して置き換えを行います。
戻り値は配列になります。

old を "Array" に置き換えます。
（正常な置き換えができません）

(4) `old=配列、new=文字列、v=文字列`

old の要素に一致する文字列をすべて new に置き換えます。

(5) `old=配列、new=文字列、v=配列`

配列 v のすべての要素に対して置き換えを行います。
戻り値は配列になります。

old の要素に一致する文字列をすべて new に置き換えます。

(6) `old=配列、new=配列、v=文字列`

old の要素に一致する文字列を対応する new に置き換えます。

同じインデックスの要素が対応します。

old[0] に一致した文字列　→　new[0] に置き換え
old[1] に一致した文字列　→　new[1] に置き換え
old[2] に一致した文字列　→　new[2] に置き換え
old[3] に一致した文字列　→　new[3] に置き換え
　：

old より new の要素数が少ない場合は、残りを "" （空の文字列）で置き換えます。

(7) `old=配列、new=配列、v=配列`

配列 v のすべての要素に対して置き換えを行います。
戻り値は配列になります。

old の要素に一致する文字列を対応する new に置き換えます。
要素の対応は (6) と同じです。

$old = array("サーバ", "Linu", "Solar");
$new = array("Server", "Uni", "Who");

$servers = array(
               "Windowsサーバ"
             , "Linuxサーバ"
             , "Solarisサーバ"
           );
$results = str_replace($old, $new, $servers);

ソースファイル

$results[0] は "WindowsServer" 、
$results[1] は "UnixServer" 、
$results[2] は "WhoisServer" になります。