strcspn() 함수는 문자열에서 지정한 문자가 처음으로 나타나기 전까지 존재하는 문자의 개수를 반환하는 PHP 내장 함수입니다. 즉, 검색 대상 문자와 일치하지 않는 부분이 몇 글자 이어지는지를 계산할 때 유용하게 사용됩니다.
문법(Syntax)
strcspn(str, char, begin, len)
매개변수(Parameters)
str − 검색 대상이 되는 원본 문자열입니다.
char − 찾고자 하는 문자(또는 문자 집합)입니다.
begin − 검색을 시작할 위치(인덱스)입니다. 선택 사항입니다.
len − 검색에 포함할 문자열의 길이입니다. 선택 사항입니다.
반환값(Return)
strcspn() 함수는 지정된 문자가 발견되기 전까지 이어진 문자의 개수를 정수형(int)으로 반환합니다. 시작 위치부터 첫 번째 매칭 문자 앞까지의 길이라고 생각하면 이해하기 쉽습니다.
다음은 기본적인 사용 예시입니다 −
예제 1
<?php
echo strcspn("demo text","m");
?>
위 코드의 실행 결과는 다음과 같습니다 −
출력
2
설명: 문자열 "demo text"에서 문자 'm'이 처음 나타나는 위치 앞에는 'd', 'e' 두 글자가 있으므로 결과값으로 2가 반환됩니다.
이번에는 begin과 len 매개변수를 함께 활용한 예제를 살펴보겠습니다 −
예제 2
<?php
echo strcspn("Demo text!!","e",0,4);
?>
위 코드의 실행 결과는 다음과 같습니다 −
출력
1
설명: 인덱스 0에서 시작해 최대 4글자("Demo") 범위 안에서만 검색합니다. 이 범위에서 'e'가 나타나기 전의 문자는 'D' 한 글자뿐이므로 결과는 1이 됩니다. 만약 len 제한 없이 전체 문자열을 검색했다면 'e'가 세 번째 위치에서 발견되어 2가 반환되었을 것입니다.