ctype_cntrl

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

ctype_cntrlПроверяет наличие управляющих символов

Описание

ctype_cntrl(mixed $text): bool

Проверяет, все ли символы в переданной строке text являются управляющими символами. Управляющими символами, к примеру, являются перевод строки, символ табуляции, escape.

Список параметров

text

Проверяемая строка.

Замечание:

Если передано целое число (int) в диапазоне между -128 и 255 включительно, то оно будет обработано как ASCII-код одного символа (к отрицательным значениям будет прибавлено 256 для возможности представления символов из расширенного диапазона ASCII). Любое другое целое число будет обработано как строка, содержащая десятичные цифры этого числа.

Внимание

Начиная с PHP 8.1.0, передача нестроковых аргументов устарела. В будущем аргумент будет интерпретироваться как строка вместо кода ASCII. В зависимости от предполагаемого поведения аргумент должен быть приведён к строке (string) или должен быть сделан явный вызов функции chr().

Возвращаемые значения

Возвращает true, если каждый символ в строке text является управляющим символом из текущей локали, false в противном случае. При вызове с пустой строкой результатом всегда будет false.

Примеры

Пример #1 Пример использования ctype_cntrl()

<?php
$strings
= array('string1' => "\n\r\t", 'string2' => 'arf12');
foreach (
$strings as $name => $testcase) {
if (
ctype_cntrl($testcase)) {
echo
"Строка '$name' состоит только из управляющих символов.\n";
} else {
echo
"Строка '$name' не состоит только из управляющих символов.\n";
}
}
?>

Результат выполнения данного примера:

Строка 'string1' состоит только из управляющих символов.
Строка 'string2' не состоит только из управляющих символов.

Смотрите также

  • ctype_print() - Проверяет наличие печатных символов
  • IntlChar::iscntrl() - Проверить, является ли символ управляющим