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() 대신 이 함수를 사용해야 합니다.
매개변수
search 및 replace가 배열인 경우 str_ireplace()는 각 배열에서 값을 가져와 subject에 대한 검색 및 바꾸기에 사용합니다. replace가 search보다 적은 값을 갖는 경우 나머지 대체 값에 대해 빈 문자열이 사용됩니다. 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() - 문자 번역 또는 부분 문자열 바꾸기