iconv_strpos 함수
(PHP 5, PHP 7, PHP 8)
iconv_strpos — haystack 내에서 needle이 처음 나타나는 위치를 찾습니다.
설명
iconv_strpos( string $haystack, string $needle, int $offset = 0, ?string $encoding = null ): int|false
haystack
내에서 needle
이 처음 나타나는 위치를 찾습니다.
strpos()와 달리 iconv_strpos()의 반환 값은 바늘이 발견된 위치에 대한 오프셋(바이트 단위)이 아니라 needle 앞에 나타나는 문자 수입니다. 문자는 지정된 문자 집합 encoding
을 기반으로 계산됩니다.
매개변수
haystack
- 전체 문자열입니다.
needle
- 검색된 하위 문자열입니다.
offset
- 선택적
offset
매개변수는 검색을 수행해야 하는 위치를 지정합니다. 오프셋이 음수이면 문자열 끝에서 계산됩니다. encoding
encoding
매개변수가 생략되거나null
인 경우string
은 iconv.internal_encoding에 인코딩된 것으로 간주됩니다.
haystack
나 needle
이 문자열이 아니면 문자열로 변환하여 문자의 서수 값으로 적용합니다.
반환 값
haystack
에서 처음으로 발생한 needle
의 숫자 위치를 반환합니다.
needle
이 발견되지 않으면 iconv_strpos()는 false
를 반환합니다.
경고 이 함수는 부울 false
을 반환할 수 있지만 false
으로 평가되는 부울이 아닌 값을 반환할 수도 있습니다. 자세한 내용은 부울 섹션을 참조하세요. 이 함수의 반환 값을 테스트하려면 === 연산자를 사용하십시오.
변경 로그
버전 | 설명 |
---|---|
8.0.0 | encoding 은 이제 nullable입니다. |
7.1.0 | 음수 offset 에 대한 지원이 추가되었습니다. |
기타
- strpos() - 문자열에서 부분 문자열이 처음 나타나는 위치 찾기
- iconv_strrpos() - haystack 내에서 needle의 마지막 발생을 찾습니다.
- mb_strpos() - 문자열에서 문자열이 처음 나타나는 위치 찾기