Strings stristr
(PHP 4, PHP 5, PHP 7, PHP 8)
stristr — 대소문자를 구분하지 않는 strstr()
설명
stristr(string $haystack
, string $needle
, bool $before_needle
= false
): string|false
첫 번째 needle
부터 끝까지 포함하여 모든 haystack
를 반환합니다.
매개변수
haystack
- 검색할 문자열
needle
- PHP 8.0.0 이전에는
needle
이 문자열이 아닌 경우 정수로 변환되어 문자의 서수 값으로 적용되었습니다. 이 동작은 PHP 7.3.0부터 더 이상 사용되지 않으며 이에 의존하지 않는 것이 좋습니다. 의도한 동작에 따라needle
을 명시적으로 문자열로 캐스팅하거나 chr()에 대한 명시적 호출을 수행해야 합니다. before_needle
true
인 경우 stristr()은needle
이 처음 발생하기 전haystack
의 일부를 반환합니다(needle 제외).
needle
과 haystack
는 대소문자를 구분하지 않고 검사합니다.
반환 값
일치하는 부분 문자열을 반환합니다. needle
이 발견되지 않으면 false
를 반환합니다.
변경 로그
버전 | 설명 |
---|---|
8.0.0 | int를 needle 로 전달하는 것은 더 이상 지원되지 않습니다. |
7.3.0 | int를 needle 로 전달하는 것은 더 이상 사용되지 않습니다. |
Examples
예제 #1 stristr() 예제
<?php
$email = 'USER@EXAMPLE.com';
echo stristr($email, 'e'); // outputs ER@EXAMPLE.com
echo stristr($email, 'e', true); // outputs US
?>
예제 #2 문자열 발견 여부 테스트
<?php
$string = 'Hello World!';
if(stristr($string, 'earth') === FALSE) {
echo '"earth" not found in string';
}
// outputs: "earth" not found in string
?>
예제 #3 "string"이 아닌 needle 사용
<?php
$string = 'APPLE';
echo stristr($string, 97); // 97 = lowercase a
// outputs: APPLE
?>
메모
참고: 이 함수는 binary-safe입니다.
기타
- strstr() - 문자열의 첫 번째 항목 찾기
- strrchr() - 문자열에서 마지막 문자 찾기
- stripos() - 문자열에서 대소문자를 구분하지 않는 하위 문자열이 처음 나타나는 위치 찾기
- strpbrk() - 임의의 문자 집합에 대한 문자열 검색
- preg_match() - 정규식 일치 수행