str_replace() 함수의 사용법

str_replace() 함수는
문자열에서 특정 문자열을 검색해서 다른 문자열로 바꾸는 함수입니다.

PHP 
$str = 'Hello, world!';
$new_str = str_replace('world!', 'universe!', $str);
echo $new_str;
결과 출력

str_replace() 함수는 주어진 문자열 안에서 지정한 문자열을 검색해서 대체 문자열로 교체하는 역할을 합니다.

지정한 고정된 문자열로 검색하는 대신 패턴을 기반으로 검색해서 텍스트를 교체하려면 preg_replace()를 사용하세요.

str_replace() 함수의 형식은 다음과 같습니다.

구문

PHP 
str_replace(
    array|string $search,
    array|string $replace,
    string|array $subject,
    int &$count = null
): string|array

// str_replace(찾을 문자열, 바꿀 문자열, 대상 문자열[,카운트]);

매개변수

str_replace() 함수의 매개변수 설명
$search 필수. 대상 문자열에서 바꾸고자 하는 문자열 또는 문자열 배열을 지정합니다.
(대소문자를 구분합니다.)
$replace 필수. $search를 대체해서 교체할 새로운 문자열 또는 문자열 배열을 지정합니다.
$subject 필수. 대상이 되는 문자열 또는 문자열 배열을 지정합니다.
$search를 이 문자열 안에서 찾아서 $replace로 교체합니다.
$count 옵션. 교체 작업의 횟수를 저장하기 위한 변수입니다.
기본값은 null입니다. str_replace() 함수가 호출될 때, 이 변수에 교체 작업 횟수가 저장됩니다. 참조 변수입니다.

주의하세요!
str_replace() 함수는 대소문자를 구분합니다.
대소문자를 구분하지 않고 교체하려면 str_ireplace() 함수를 사용하세요 .

반환 값

str_replace() 함수는 교체 작업이 수행된 후에 대상 문자열 또는 대상 문자열 배열을 반환합니다.
함수는 교체 작업이 수행된 후에 대상 문자열 또는 대상 문자열 배열을 반환합니다.

사용법

str_replace() 함수의 사용법을 알아보겠습니다.

특정 문자를 다른 문자로 바꾸는 경우

PHP 
$original_string = 'Hello, world! Hello, PHP!';
$new_string = str_replace('Hello', 'Hi', $original_string);

echo $new_string;  // 출력: 'Hi, world! Hi, PHP!'

위의 예제에서 str_replace() 함수는 "Hello"를 "Hi"로 교체하여 새로운 문자열을 생성하고, 이 새로운 문자열이 $new_string 변수에 저장됩니다. 이후 echo $new_string;을 사용하여 새로운 문자열을 출력합니다.

따라서 str_replace() 함수를 호출한 결과인 $new_string은 교체된 결과를 가진 새로운 문자열을 나타냅니다. 이것이 str_replace() 함수의 반환 값입니다.

특정 문자열을 제거하는 경우

PHP 
$str = 'This is a test';
$new_str = str_replace('test', '', $str);
echo $new_str; // 출력: 'This is a'

위 예제에서 $str은 "This is a test"라는 문자열입니다. str_replace() 함수를 사용하여 $str에서 "test"를 빈 문장열('')로 교체함으로써, 제거하는 결과를 만들 수 있습니다. 제거하는 결과는 "This is a"입니다.

str_replace() 함수는 문자열을 처리하는 데 매우 유용한 함수입니다. 다양한 상황에서 활용할 수 있으므로 잘 숙지해두면 좋습니다.

str_replace() 함수에 배열을 이용해서 여러 개의 문자열을 교체하는 사례

PHP - 배열의 문자열을 검색해서 교체 
$original_array = ['Apples are red.', 'Bananas are yellow.', 'Apples and bananas are delicious.'];

$search = ['Apples', 'Bananas'];
$replace = ['Oranges', 'Grapes'];

$new_array = str_replace($search, $replace, $original_array);

print_r($new_array);

/* 출력:
Array
(
    [0] => Oranges are red.
    [1] => Grapes are yellow.
    [2] => Oranges and grapes are delicious.
)
*/
PHP - 문자열의 문자열을 검색해서 교체 
$original_string = 'Apples are red. Bananas are yellow. Apples and bananas are delicious.';

$search = ['Apples', 'Bananas'];
$replace = ['Oranges', 'Grapes'];

$new_string = str_replace($search, $replace, $original_string);

echo $new_string;
// 출력: 'Oranges are red. Grapes are yellow. Oranges and grapes are delicious.'

$count 파라미터를 사용한 유용한 사례

$count 파라미터는 str_replace() 함수의 교체 작업의 횟수를 저장하기 위한 변수이며 옵션입니다. 기본값은 null입니다. str_replace() 함수가 호출될 때, 이 변수에 교체 작업 횟수가 저장됩니다.

$count 파라미터를 사용하는 유용한 사례 중 하나는 특정 문자열이나 패턴의 반복 횟수를 세는 것입니다. 이를 통해 문자열 내에서 특정 패턴이 얼마나 자주 나타나는지를 파악할 수 있습니다.

예를 들어, 특정 단어가 문자열 내에서 얼마나 자주 나타나는지 세어보고 싶다고 가정해보겠습니다.

PHP 
$original_string = '안녕하세요, 세상! 안녕하세요, PHP! 안녕하세요, 모두!';
$search = '안녕하세요';
$replace = '안녕';
$count = 0;

$new_string = str_replace($search, $replace, $original_string, $count);

echo $new_string;  // 출력: '안녕, 세상! 안녕, PHP! 안녕, 모두!'
echo "단어 '{$search}'은(는) {$count}번 나타납니다.";
// 출력: "단어 '안녕하세요'은(는) 3번 나타납니다."

위의 예제에서 $search 변수로 찾을 단어 "안녕하세요"를 지정하고, $replace 변수로 교체할 단어 "안녕"을 지정하였습니다. str_replace() 함수를 실행하면서 $count 변수도 함께 제공하였기 때문에, 교체 작업이 몇 번 이루어졌는지를 나타내는 $count 변수에 값이 저장됩니다.

참고문헌

같이 보기