CakeFest 2024: The Official CakePHP Conference

ctype_cntrl

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

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

Описание

ctype_cntrl(mixed $text): bool

Проверяет, состоит ли переданная строка (string) 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() - Проверить, является ли символ управляющим

add a note

User Contributed Notes 1 note

up
2
Tor
11 years ago
Returns true if bytes are in the range of \x00-\x1f or \x7f (del). Returns false if bytes are in the range of \x20-\x7e or \x80-\xff.
To Top