iconv_substr 함수
(PHP 5, PHP 7, PHP 8)
iconv_substr — 문자열의 일부를 잘라냅니다.
설명
iconv_substr( string $string, int $offset, ?int $length = null, ?string $encoding = null ): string|false
offset
및 length
매개변수로 지정된 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
인 경우string
은 iconv.internal_encoding에 인코딩된 것으로 간주됩니다.offset
및length
매개변수는 항상encoding
에 의해 결정된 문자 세트를 기반으로 계산된 오프셋을 나타내는 것으로 간주되는 반면, 대응하는 substr()은 항상 바이트 오프셋에 대해 이를 취합니다.
반환 값
offset
및 length
매개변수로 지정된 string
부분을 반환합니다.
string
이 offset
문자 길이보다 짧으면 false
가 반환됩니다. string
이 정확히 offset
문자 길이이면 빈 문자열이 반환됩니다.
변경 로그
버전 | 설명 |
---|---|
8.0.0 | length 와 encoding 은 이제 nullable입니다. |
7.0.11 | string 이 offset 문자 길이와 같으면 빈 문자열이 반환됩니다. 이 버전 이전에는 이 경우 false 가 반환되었습니다. |
기타
- substr() - 문자열의 일부 반환
- mb_substr() - 문자열의 일부 가져오기
- mb_strcut() - 문자열의 일부 가져오기