str_starts_with() 함수 사용법

str_starts_with() 함수는
문자열이 특정 문자열로 시작하는지 체크합니다.
특정 문자열로 시작하면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

이 함수는 대소문자를 구분합니다.

PHP 8에서 도입된 함수로 PHP 8 이전의 버전에서는 호환되지 않습니다.

PHP 
$haystack_en = 'Hello, world!';
var_dump(str_starts_with($haystack_en, 'Hello')); // bool(true)
var_dump(str_starts_with($haystack_en, 'hello')); // bool(false) => 대소문자를 구분
var_dump(str_starts_with($haystack_en, 'world')); // bool(false)

$haystack_ko = '환영합니다!';
var_dump(str_starts_with($haystack_ko, '환')); // bool(true)
var_dump(str_starts_with($haystack_ko, '환영합니다!')); // bool(true)
var_dump(str_starts_with($haystack_ko, '환영합니다xxxx')); // bool(false)

문자열이 특정 문자열로 끝나는지 체크하려면 str_ends_with() 함수를 사용하세요.

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

구문

PHP 
str_starts_with(string $haystack, string $needle): bool

매개변수

str_starts_with() 함수의 매개변수 설명
$haystack 검색 대상이 되는 문자열입니다.
$needle 검색할 문자열입니다.
대소문자를 구분합니다.

반환 값

검색 대상이 되는 문자열에서 검색할 주어진 문자열이 포함되어 있으면 true를 그렇지 않으면 false를 반환합니다.
검색할 주어진 문자는 대소문자를 구분합니다.

검색할 문자열이 빈 문자열('')일 경우

빈 문자열('')은 모든 문자열의 시작 부분에 있다고 간주되므로, 빈 문자열을 $haystack으로 사용하면 항상 true를 반환합니다.

PHP 
$haystack_1 = 'Hello, world!';
var_dump(str_starts_with($haystack_1, '')); // bool(true)

$haystack_2 = '';
var_dump(str_starts_with($haystack_2, '')); // bool(true)

이러한 동작은 문자열의 논리적 정의에 근거합니다. 빈 문자열은 어떤 문자열의 시작 부분이나 끝 부분에 존재하므로, 빈 문자열로 시작하거나 끝나는 모든 문자열에 대해 true를 반환하는 것이 자연스러운 결과입니다. 따라서, 이 개념은 PHP뿐만 아니라 여러 프로그래밍 언어에서 보편적으로 적용됩니다.

PHP 8에서 도입된 함수로 PHP 8 이전의 버전에서는 호환되지 않습니다.

PHP 8 이전의 버전에서는 호환되지(지원하지) 않기 때문에 PHP 8 이전의 버전에서는 다음과 같이 사용할 수도 있습니다.

일러두기
아래의 예제 코드는 PHP 8 이전 버전에서 str_starts_with() 함수를 대체하기 위한 간단한 polyfill 예제입니다. 완벽하지 않습니다.
이 polyfill은 간단한 사용 사례에 맞추어 작성되었지만, 특정 사용자의 요구 사항(PHP 버전, 성능 고려, 대소문자 구분, 빈 문자열 처리, 다국어 문자열 처리, 기타 상황 등)에 따라 유연성을 추가할 필요가 있을 수 있습니다.

PHP 
if ( ! function_exists( 'str_starts_with' ) ) {
	/**
	 * PHP 8.0에서 추가된 `str_starts_with()` 함수의 폴리필.
	 *
	 * 대소문자를 구분하여 주어진 문자열(haystack)이
	 * 특정 부분 문자열(needle)로 시작하는지 확인합니다.
	 *
	 * @param string $haystack 검색할 문자열.
	 * @param string $needle   `$haystack`에서 검색할 부분 문자열.
	 * @return bool `$haystack`가 `$needle`로 시작하면 true를, 그렇지 않으면 false를 반환.
	 */
	function str_starts_with( $haystack, $needle ) {
		if ( '' === $needle ) {
			return true;
		}

		return 0 === mb_strpos( $haystack, $needle );
	}
}

코드 부연설명
mb_strpos() 함수는 문자열에서 특정 문자열의 위치를 찾는 함수입니다. 대소문자를 구분합니다. multi-byte 문자열에서 안전하게 작동합니다.

PHP 버전

  • PHP 8 버전부터 지원합니다.

참고문헌

같이 보기