Strings str_ireplace

(PHP 5, PHP 7, PHP 8)

str_ireplace — 대소문자를 구분하지 않는 str_replace() 버전


설명

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

이 함수는 주어진 replace 값으로 대체된 subject(대소문자 무시)의 모든 search이 있는 문자열 또는 배열을 리턴합니다. 멋진 교체 규칙이 필요하지 않은 경우 일반적으로 i 수정자와 함께 preg_replace() 대신 이 함수를 사용해야 합니다.


매개변수

searchreplace가 배열인 경우 str_ireplace()는 각 배열에서 값을 가져와 subject에 대한 검색 및 바꾸기에 사용합니다. replacesearch보다 적은 값을 갖는 경우 나머지 대체 값에 대해 빈 문자열이 사용됩니다. search가 배열이고 replace가 문자열이면 이 대체 문자열은 모든 search 값에 사용됩니다. 그러나 그 반대는 의미가 없을 것입니다.

search 또는 replace가 배열인 경우 해당 요소가 처음부터 마지막으로 처리됩니다.

search
검색 중인 값(needle이라고도 함)입니다. 배열은 여러 needle을 지정하는 데 사용할 수 있습니다.
replace
찾은 search 값을 대체하는 대체 값입니다. 배열을 사용하여 여러 대체품을 지정할 수 있습니다.
subject
haystack라고도 하는 검색 및 대체되는 문자열 또는 배열입니다.

subject가 배열이면 subject의 모든 항목에 대해 검색 및 바꾸기가 수행되고 반환 값도 배열입니다.

count
통과하면 수행된 교체 횟수로 설정됩니다.

반환 값

문자열 또는 대체 배열을 반환합니다.


Examples

예제 #1 str_ireplace() 예제

                  
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
echo $bodytag; // <body text=black>
?>
                  
                

메모

참고: 이 함수는 binary-safe입니다.

주의
Replacement order gotcha

str_ireplace()는 왼쪽에서 오른쪽으로 교체하기 때문에 여러 교체를 수행할 때 이전에 삽입된 값을 교체할 수 있습니다. str_replace() 문서의 예제 #2는 이것이 실제로 어떻게 영향을 미칠 수 있는지 보여줍니다.


기타

  • str_replace() - 검색 문자열의 모든 항목을 대체 문자열로 바꿉니다.
  • preg_replace() - 정규식 검색 및 바꾸기 수행
  • strtr() - 문자 번역 또는 부분 문자열 바꾸기