PHP 매뉴얼
이전 |  | 다음

# str_replace

(PHP 3>= 3.0.6, PHP 4 , PHP 5)

str_replace -- 발견한 모든 검색 문자열을 치환 문자열로 교체합니다.

## 설명

mixed str_replace ( mixed search, mixed replace, mixed subject [, int &count])

`subject`에서 발견한 모든 `search`를 주어진 `replace` 값으로 치환한 문자열이나 배열을 반환합니다. (정규표현식처럼) 복잡한 치환 규칙이 필요하지 않다면, 항상 ereg_replace()나 preg_replace() 대신 이 함수를 사용해야 합니다.

PHP 4.0.5부터, str_replace()의 모든 인자를 array로 지정할 수 있습니다.

주의
PHP 4.3.3 이전 버전에는 `search`와 `replace` 인자에 모두 배열을 사용할 경우, 빈 `search` 인덱스를 `replace` 배열의 내부 포인터를 옮기지 않은 채 넘어가는 버그가 존재했습니다. `PHP 4.3.3`에서 수정했기에, 이 버그에 관련된 모든 스크립트는 이전의 동작을 하려면 이 함수를 호출 하기 전에 빈 search값을 제거해야 합니다.

`subject`가 배열이면, 검색 및 치환을 `subject`의 모든 원소에서 수행하고, 배열을 반환합니다.

`search`와 `replace`가 배열이면, str_replace()는 각각의 배열에서 가져온 값을 `subject`의 검색과 치환에 사용합니다. `replace`가 `search`보다 적은 값을 가지면, 나머지 치환값은 빈 문자열을 사용합니다. `search`가 배열이고 `replace`가 문자열이면; 치환 문자열을 모든 `search` 값에 사용합니다.

예 1. str_replace() 예제

`<?php
// 결과: <body text='black'>
$bodytag = str_replace("%body%", "black", "<body text='%body%'>");
// 결과: Hll Wrld f PHP
$vowels = array("a", "e", "i", "o", "u", "A", "E", "I", "O", "U");
$onlyconsonants = str_replace($vowels, "", "Hello World of PHP");
// 결과: You should eat pizza, beer, and ice cream every day
$phrase = "You should eat fruits, vegetables, and fiber every day.";
$healthy = array("fruits", "vegetables", "fiber");
$yummy = array("pizza", "beer", "ice cream");
$newphrase = str_replace($healthy, $yummy, $phrase);
// PHP 5.0.0부터 사용할 수있는 count 인자 사용
$str = str_replace("ll", "", "good golly miss molly!", $count);
echo $count; // 2
?>`

> 참고: 이 함수는 바이너리 호환(binary-safe)입니다.

> 참고: `PHP 5.0.0`부터 매치하고 치환한 횟수를 참조로 전달하는 `count`로 반환할 수 있습니다. `PHP 5.0.0` 이전에는 이 인자를 사용할 수 없습니다.

참고: str_ireplace(), substr_replace(), ereg_replace(), preg_replace(), strtr().

이전 | 처음으로 | 다음
str_repeat | 위로 | str_rot13