substr_count
substr
String 関数
PHP Manual

# substr_replace

(PHP 4, PHP 5)

substr_replace — 文字列の一部を置換する

### 説明

mixed substr_replace ( mixed `$string` , string `$replacement` , int `$start` [, int `$length` ] )

substr_replace()は、文字列 `string`の `start` および (オプションの) `length` パラメータで区切られた部分を `replacement` で指定した文字列に置換します。

### パラメータ

`string`

  入力文字列。

`replacement`

  置換する文字列。

`start`

  `start` が正の場合、置換は `string` で `start` 番目の文字から始まります。

  `start` が負の場合、置換は `string` の終端から `start` 番目の文字から始まります。

`length`

  正の値を指定した場合、 `string`の置換される部分の長さを表します。 負の場合、置換を停止する位置が `string` の終端から何文字目であるかを表します。このパラメータが省略された場合、 デフォルト値は strlen(`string`)、すなわち、 `string` の終端まで置換することになります。 当然、もし `length` がゼロだったら、 この関数は `string` の最初から `start` の位置に `replacement` を挿入するということになります。

### 返り値

結果の文字列を返します。もし、`string` が配列の場合、配列が返されます。

### 例

例1 substr_replace() の例

`<?php
$var = 'ABCDEFGH:/MNRPQR/';
echo "Original: $var<hr />\n";
/* 以下の2つの例は、全ての $var で 'bob' で置換します。 */
echo substr_replace($var, 'bob', 0) . "<br />\n";
echo substr_replace($var, 'bob', 0, strlen($var)) . "<br />\n";
/* $var の先頭に 'bob' を挿入します */
echo substr_replace($var, 'bob', 0, 0) . "<br />\n";
/* 次の2つの例は、$var の 'MNRPQR' を 'bob'で置換します */
echo substr_replace($var, 'bob', 10, -1) . "<br />\n";
echo substr_replace($var, 'bob', -7, -1) . "<br />\n";
/* $var から 'MNRPQR' を削除します */
echo substr_replace($var, '', 10, -1) . "<br />\n";
?>`

### 注意

> 注意: この関数はバイナリデータに対応しています。

### 参考

- str_replace() - 検索文字列に一致したすべての文字列を置換する
- substr() - 文字列の一部分を返す
- 文字列への文字単位のアクセスと修正

substr_count
substr
String 関数
PHP Manual