strspn
(PHP 4, PHP 5, PHP 7, PHP 8)
strspn —
Encuentra la longitud del segmento inicial de un string que contiene
todos los caracteres de una máscara dada
Descripción
Si los parámetros offset y length
son omitidos, entonces todo el string string será
analizado. Si son proporcionados, entonces los efectos serán idénticos a llamar
strspn(substr($string, $offset, $length), $characters)
(ver substr para más información).
El código siguiente:
asigna
2 a la variable
$var,
ya que el string "42" es el segmento inicial del parámetro
string cuyos caracteres están contenidos en
"1234567890".
Parámetros
string
-
El string a analizar.
characters
-
La lista de caracteres autorizados.
offset
-
La posición en el string string a
partir de la cual se debe buscar.
Si offset es proporcionado y no es negativo,
entonces strspn() comenzará a analizar el string
string en la posición offset.
Por ejemplo, en el string 'abcdef', el carácter
en la posición 0 es 'a', el carácter
en la posición 2 es 'c', y así
sucesivamente.
Si offset es proporcionado y es negativo,
entonces strspn() comenzará a analizar el string
string en la posición offset
desde el final del string string.
length
-
La longitud del string a analizar.
Si length es proporcionado y no es negativo,
entonces string será examinado sobre
length caracteres después de la posición de inicio.
Si length es proporcionado y es negativo,
entonces string será examinado sobre
length caracteres desde el final
del string string.
Valores devueltos
Retorna el tamaño del segmento inicial del string
string que está enteramente
constituido de caracteres contenidos en characters.
Nota:
Cuando el parámetro offset está definido, la longitud
retornada es contada a partir de esta posición, y no desde el inicio
del parámetro string.
Ejemplos
Ejemplo #1 Ejemplo con strspn()
<?php
// El sujeto no comienza con uno de los caracteres desde la máscara
var_dump(strspn("foo", "o"));
// Examina 2 caracteres desde el inicio del sujeto, en la posición 1
var_dump(strspn("foo", "o", 1, 2));
// Examina un carácter desde el inicio del sujeto, en la posición 1
var_dump(strspn("foo", "o", 1, 1));
?>
El ejemplo anterior mostrará:
Notas
Nota: Esta función es
segura para sistemas binarios.
Ver también
- strcspn() - Encuentra un segmento de string que no contiene ciertos caracteres