ctype_space

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

ctype_spaceПроверяет пробельные символы

Описание

ctype_space(mixed $text): bool

Проверяет, состоит ли переданная строка (string) text только из пробельных символов.

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

text

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

Замечание:

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

Внимание

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

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

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

Примеры

Пример #1 Пример использования функции ctype_space()

<?php

$strings
= array(
'string1' => "\n\r\t",
'string2' => "\narf12",
'string3' => '\n\r\t' // Обратите внимание, кавычки одинарные
);
foreach (
$strings as $name => $testcase) {
if (
ctype_space($testcase)) {
echo
"Строка '$name' состоит только из пробельных символов.\n";
} else {
echo
"Строка '$name' состоит не только из пробельных символов.\n";
}
}
?>

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

Строка 'string1' состоит только из пробельных символов.
Строка 'string2' состоит не только из пробельных символов.
Строка 'string3' состоит не только из пробельных символов.

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

  • ctype_cntrl() - Проверяет управляющие символы
  • ctype_graph() - Проверяет любые печатные символы кроме пробела
  • ctype_punct() - Проверяет печатные символы, которые не содержат пробельных или буквенно-цифровых символов
  • IntlChar::isspace() - Проверяет, является ли символ пробельным