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() 대신 이 함수를 사용해야 합니다.

인수

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

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

search

replace

subject

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

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

반환값

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

변경점

버전 설명
5.0.0 count 인수 추가.
4.3.3 이 함수의 동작이 바뀌었습니다. 이전 버전에서는 searchreplace 인수를 배열로 사용할 때, 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()를 사용하십시오.

참고


String 함수 목록
PHP Manual