ctype_space

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

ctype_spaceChequear posibles caracteres de espacio en blanco

Descripción

function ctype_space(mixed $text): bool

Verifica si todos los caracteres en la string entregada, text, crean espacios en blanco.

Parámetros

text

El string de prueba.

Nota: Si se proporciona un int entre -128 y 255 inclusive, este se interpreta como el valor ASCII de un solo carácter (a los valores negativos se les añade 256 para permitir caracteres del rango ASCII extendido). Cualquier otro entero se interpreta como un string que contiene los dígitos decimales del entero.

Advertencia

A partir de PHP 8.1.0, pasar un argumento que no sea string está obsoleto. En el futuro, el argumento se interpretará como un string en lugar de un punto de código ASCII. Según el comportamiento deseado, el argumento debería convertirse a string o se debería realizar una llamada explícita a chr().

Valores devueltos

Devuelve true si cada caracter del text genera cierto tipo de espacio en blanco, o false de lo contrario. Junto con el caracter regular de espacio en blanco, también se consideran espacios a los caracteres de tabulación, tabulación vertical, avance de línea, retorno de carro y avance de formulario. Cuando se llama con una cadena vacía, el resultado será siempre false.

Ejemplos

Ejemplo #1 Un ejemplo de ctype_space()

<?php
$cadenas = array(
    'cadena1' => "\n\r\t",
    'cadena2' => "\narf12",
    'cadena3' => '\n\r\t' // observe las comillas simples
);
foreach ($cadenas as $nombre => $caso_prueba) {
    if (ctype_space($caso_prueba)) {
        echo "La cadena '$nombre' contiene únicamente caracteres de espacio en blanco.\n";
    } else {
        echo "La cadena '$nombre' contiene caracteres que no son de espacio en blanco.\n";
    }
}
?>

El ejemplo anterior mostrará:

La cadena 'cadena1' contiene únicamente caracteres de espacio en blanco.
La cadena 'cadena2' contiene caracteres que no son de espacio en blanco.
La cadena 'cadena3' contiene caracteres que no son de espacio en blanco.

Véase también

  • ctype_cntrl() - Chequear posibles caracteres de control
  • ctype_graph() - Chequear posibles caracteres imprimibles, con excepción de los espacios
  • ctype_punct() - Chequear posibles caracteres imprimibles que no son ni espacios en blanco ni caracteres alfanuméricos
  • IntlChar::isspace() - Verifica si un punto de código es un carácter de espacio