iconv_strlen

(PHP 5, PHP 7, PHP 8)

iconv_strlen — Dizgenin karakter sayısı ile döner

Açıklama

iconv_strlen(string $dizge, ?string $karküm = null): int|false

Taydaşı olan strlen() işlevinden farklı olarak bayt değil karakter sayar. Karakterler karküm ile belirlenen karakter kümesine göre değerlendirilirler.

Bağımsız Değişkenler

dizge: Karakter sayısı hesaplanacak dizge.
karküm: Eğer karküm belirtilmezse veya null ise, dizgenin karakter kodlamasının iconv.internal_encoding yönergesinde belirtilen kodlama olduğu varsayılır.

Dönen Değerler

dizge dizgesinin karakter sayısını bir tamsayı olarak döndürür. Hata oluşmuşsa false döner.

Sürüm Bilgisi

Sürüm:	Açıklama
8.0.0	`karküm` artık `null` olabiliyor.

Ayrıca Bakınız

grapheme_strlen() - Dizgenin sesletim birimi cinsinden uzunluğunu döndürür
mb_strlen() - Dizge uzunluğu ile döner
strlen() - Dizge uzunluğunu döndürür

add a note

User Contributed Notes 2 notes

down

hfuecks @ nospam org ¶

18 years ago


If iconv_strlen is passed a UTF-8 string containing badly formed sequences, it will return FALSE. This is in contrast to mb_strlen of the behaviour of utf8_decode, which strip out any bad sequences;

<?php
# UTF-8 string containing bad sequence: \xe9
$str = "I?t?rn?ti?n\xe9?liz?ti?n";

print "mb_strlen: ".mb_strlen($str,'UTF-8')."\n";
print "strlen/utf8_decode: ".strlen(utf8_decode($str))."\n";
print "iconv_strlen: ".iconv_strlen($str,'UTF-8')."\n";
?>

Displays;

mb_strlen: 20
strlen/utf8_decode: 20
iconv_strlen:

(PHP 5.0.5)

As such it is being "stricter" than mb_strlen and it may mean you need to check for invalid sequences first. A quick way to check is to exploit the behaviour of the PCRE extension (see notes on pattern modifiers);

<?php
if (preg_match('/^.{1}/us',$str,$ar) != 1) {
    die("string contains invalid UTF-8");
}
?>

A slower but stricter check (regex) can be found at: http://www.w3.org/International/questions/qa-forms-utf-8

Similiar applies to iconv_substr, iconv_strpos and iconv_strrpos

down

sheryl ¶

4 years ago


Notice there is a disconnect:  
>If charset`parameter is omitted, str is assumed to be encoded in iconv.internal_encoding.

But clicking on the iconv.internal_encoding link (https://www.php.net/manual/en/iconv.configuration.php), the docs indicate that iconv.internal_encoding is deprecated since 5.6.

add a note