update page now

ctype_alnum

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

ctype_alnumSınama, abecesayısal karakterler için yapılır

Açıklama

ctype_alnum(mixed $metin): bool

Belirtilen metin içindeki karakterlerin hepsi geçerli yerele göre birer harf veya rakam ise true döner.

Bağımsız Değişkenler

metin

Sınanacak dizge.

Bilginize:

-128 ile 255 (dahil) arasında bir tamsayı belirtilmişse bu, tek bir karakterin ASCII değeri olarak yorumlanır (negatif değerlere 256 eklenerek genişletimiş ASCII karakterlerin kullanımı sağlanmıştır). Bu aralığın dışındaki tüm tamsayılar, sayının rakamlarını oluşturan bir dizge olarak yorumlanır.

Uyarı

PHP 8.1.0 itibariyle, dizge olmayan bağımsız değişken aktarımı önerilmemektedir. Gelecek sürümlerde, bağımsız değişken bir ASCII karakter kodu olarak değil bir dizge olarak yorumlanacaktır. Amaçlanan davranışa bağlı olarak, bağımsız değişken ya string türe dönüştürülmeli ya da doğrudan chr() çağrısı yapılmalıdır.

Dönen Değerler

Belirtilen metin içindeki karakterlerin hepsi geçerli yerele göre birer harf veya rakam ise true, değilse false döner. Boş dizge ile çağrıldığında sonuç daima false olur.

Örnekler

Örnek 1 - ctype_alnum() örneği (öntanımlı yerel kullanılarak)

<?php
$dizgeler
= array('AbCd1zyZ9', 'foo!#$bar');
foreach (
$dizgeler as $dizge) {
if (
ctype_alnum($dizge)) {
echo
"$dizge tamamen harflerden ve/veya rakamlardan oluşuyor.\n";
} else {
echo
"$dizge tamamen harflerden ve/veya rakamlardan oluşmuyor.\n";
}
}
?>

Yukarıdaki örneğin çıktısı:

AbCd1zyZ9 tamamen harflerden ve/veya rakamlardan oluşuyor.
foo!#$bar tamamen harflerden ve/veya rakamlardan oluşmuyor.

Ayrıca Bakınız

add a note

User Contributed Notes 4 notes

up
97
thinice at gmail dot com
16 years ago
ctype_alnum() is a godsend for quick and easy username/data filtering when used in conjunction with str_replace().

Let's say your usernames have dash(-) and underscore(_) allowable and alphanumeric digits as well.

Instead of a regex you can trade a bit of performance for simplicity:

<?php
$sUser = 'my_username01';
$aValid = array('-', '_');

if(!ctype_alnum(str_replace($aValid, '', $sUser))) {
    echo 'Your username is not properly formatted.';
}
?>
up
11
marcelocamargo at linuxmail dot org
10 years ago
It is also important to note that the behavior of `ctype_alnum` differs according to the operating system. For UNIX-based operating system, if you pass a value that is not a string (or an overloaded object), independently of the value, it will always result in false. However, if we do the same on Windows, using, for example, -1 as literal (a minus and a number greater than 0), we'll have true as result.

<?php var_dump(ctype_alnum(-1));
// UNIX: bool(false)
// Windows: bool(true)
up
23
Anonymous
13 years ago
Quicktip: If ctype is not enabled by default on your server, replace ctype_alnum($var) with preg_match('/^[a-zA-Z0-9]+$/', $var).
up
0
luismartin at casfid dot com
10 hours ago
Be aware that this function will not validate non-english alphanumeric characters. Only ASCII.

<?php
$test = "aeiou";
echo ctype_alnum($test) ? "ok\n" : "err\n";
$test = "áeiou";
echo ctype_alnum($test) ? "ok\n" : "err\n";
$test = "aeiöu";
echo ctype_alnum($test) ? "ok\n" : "err\n";
$test = "ñ";
echo ctype_alnum($test) ? "ok\n" : "err\n";

// output:
// ok
// err
// err
// err
?>

In case you want to validate these types of characters, the best choice is the use of regex, but there's a shortcut so that you will not have to bother typing all of them:

This regex: /^[\p{L}\p{M}\p{Nd}]+$/u
\p{L}  = Any letter, syllable, or ideogram from any Unicode script.
\p{M}  = Any combining mark (necessary for vowels/accents in languages like Arabic or Hindi).
\p{Nd} = Any decimal digit (0-9) from any script, excluding fractions like ½ or Roman numerals.
u = The modifier at the end says: treat the string as a UTF-8 representation.

<?php
$test = "aeiouáöñçسअ爱";
echo preg_match('/^[\p{L}\p{M}\p{Nd}]+$/u', $test) ? "ok\n" : "err\n";
$test = "aeiouáöñçسअ爱!+½";
echo preg_match('/^[\p{L}\p{M}\p{Nd}]+$/u', $test) ? "ok\n" : "err\n";

// output:
// ok
// err
?>
To Top