str_repeat
str_rot13
String 함수 목록
PHP Manual

# str_replace

(PHP 4, PHP 5)

str_replace — 발견한 모든 검색 문자열을 치환 문자열로 교체

### 설명

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

`subject` 에서 발견한 모든 `search` 를 주어진 `replace` 값으로 치환한 문자열이나 배열을 반환합니다.

(정규표현식처럼) 복잡한 치환 규칙이 필요하지 않다면, ereg_replace()나 preg_replace() 대신 이 함수를 사용해야 합니다.

### 인수

`search` 와 `replace` 가 배열이면, str_replace()는 각가의 배열에서 취한 값을 사용해서 `subject` 를 검색 치환합니다. `replace` 가 `search` 보다 적은 값을 가지고 있으면, 나머지 치환값으로 빈 문자열을 사용합니다. `search` 가 배열이고 `replace` 가 문자열이면, `search` 의 모든 값에 이 치환 문자열을 사용합니다. 반대도 마찬가지입니다.

`search` 나 `replace` 가 배열이면, 그 요소는 처음부터 마지막 순으로 처리됩니다.

`search`

`replace`

`subject`

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

`count`
  넘겨지면, 매치하여 교체하는 수를 가집니다.

### 반환값

이 함수는 치환한 값을 가지는 문자열이나 배열을 반환합니다.

### 변경점

버전 | 설명
--- | ---
5.0.0 | `count` 인수 추가.
4.3.3 | 이 함수의 동작이 바뀌었습니다. 이전 버전에서는 `search` 와 `replace` 인수를 배열로 사용할 때, `search` 인덱스가 비어 있을 경우 `replace` 배열의 내부 포인트를 증가하지 않고 지나치는 버그가 있었습니다. 이는 PHP 4.3.3에서 수정되었으므로, 이 버그에 의존하고 있던 모든 스크립트는 이전의 이상한 동작을 재현하려면 호출 전에 빈 search 값을 제거해야 합니다.
4.0.5 | 대부분의 인수가 array를 받습니다.

### 예제

Example #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
// 교체 순서
$str = "Line 1\nLine 2\rLine 3\r\nLine 4\n";
$order = array("\r\n", "\n", "\r");
$replace = '<br />';
// \r\n을 먼처 처리해서 두번 변환되지 않도록 합니다.
$newstr = str_replace($order, $replace, $str);
// 출력: apearpearle pear
$letters = array('a', 'p');
$fruit = array('apple', 'pear');
$text = 'a p';
$output = str_replace($letters, $fruit, $text);
echo $output;
?>`

### 주의

> Note: 이 함수는 바이너리 안전입니다.

> Note: 이 함수는 대소문자를 구별합니다. 대소문자를 구별하지 않으려면 str_ireplace()를 사용하십시오.

### 참고

- str_ireplace() - 대소문자 구분 없는 str_replace
- substr_replace() - Replace text within a portion of a string
- preg_replace() - 정규 표현식 검색과 치환을 수행
- strtr() - Translate certain characters

str_repeat
str_rot13
String 함수 목록
PHP Manual