iconv_substr 함수

(PHP 5, PHP 7, PHP 8)

iconv_substr — 문자열의 일부를 잘라냅니다.


설명

iconv_substr(
    string $string,
    int $offset,
    ?int $length = null,
    ?string $encoding = null
): string|false
                

offsetlength 매개변수로 지정된 string의 일부를 자릅니다.


매개변수

string
원래 문자열입니다.
offset
offset이 음수가 아닌 경우 iconv_substr()은 0부터 계산하여 offset' 문자에서 시작하는 string 부분을 잘라냅니다.

offset이 음수이면 iconv_substr()은 위치에서 시작하는 부분을 잘라내고 string 끝에서 문자를 오프셋합니다.

length
length가 지정되고 양수이면 반환 값에는 offset에서 시작하는 부분의 최대 length 문자가 포함됩니다(string 길이에 따라 다름).

음수 length가 전달되면 iconv_substr()offset 문자에서 string 끝에서 length 문자만큼 떨어진 문자까지 string의 일부를 자릅니다. offset도 음수인 경우 위에서 설명한 규칙에 따라 시작 위치가 미리 계산됩니다.

encoding
encoding 매개변수가 생략되거나 null인 경우 stringiconv.internal_encoding에 인코딩된 것으로 간주됩니다.

offsetlength 매개변수는 항상 encoding에 의해 결정된 문자 세트를 기반으로 계산된 오프셋을 나타내는 것으로 간주되는 반면, 대응하는 substr()은 항상 바이트 오프셋에 대해 이를 취합니다.


반환 값

offsetlength 매개변수로 지정된 string 부분을 반환합니다.

stringoffset 문자 길이보다 짧으면 false가 반환됩니다. string이 정확히 offset 문자 길이이면 빈 문자열이 반환됩니다.


변경 로그

버전 설명
8.0.0 lengthencoding은 이제 nullable입니다.
7.0.11 stringoffset 문자 길이와 같으면 빈 문자열이 반환됩니다. 이 버전 이전에는 이 경우 false가 반환되었습니다.

기타