strspn
(PHP 4, PHP 5)
strspn — Encuentra la longitud del segmento inicial de un string que consista únicamente en caracteres contenidos dentro de una máscara dada.
Descripción
$subject
, string $mask
[, int $start
[, int $length
]] )
Encuentra la longitud del segmento inicial de subject
que contiene solamente caracteres de mask.
Si start y length
son omitidos, entonces la totalidad de subject será
examinada. Si son incluidos, entonces el efecto será el mismo que
llamando strspn(substr($subject, $start, $length),
$mask) (ver substr
para más información).
La línea de código:
<?php
$var = strspn("42 is the answer to the 128th question.", "1234567890");
?>
subject que consiste solamente en caracteres
contenidos dentro de "1234567890".
Parámetros
-
subject -
El string a examinar.
-
mask -
La lista de caracteres permitidos.
-
start -
La posición en
subjectdonde iniciar la búsqueda.Si
startes dado y no es negativo, entonces strspn() comenzará a examinar asubjecten la posiciónstartésima. Por ejemplo, en el string 'abcdef', el caracter en la posición 0 es 'a', el caracter en la posición 2 es 'c' y así sucesivamente.Si
startes dado y es negativo, entonces strspn() comenzará a examinarsubjectdesde lastartésima posición desde el final desubject. -
length -
La longitud del segmento de
subjecta examinar.Si se proporciona
lengthy no es negativo, entoncessubjectserá examinado por el númerolengthde caracteres después de la posición de inicio.Si se proporciona
lengthy es negativo, entoncessubjectsera examinado desde la posición de inicio hasta el númerolengthde caracteres desde el final desubject.
Valores devueltos
Devuelve la longitud del segmento inicial de subject
el cual enteramente consiste en caracteres en mask.
Ejemplos
Ejemplo #1 Ejemplo de strspn()
<?php
// subject no inicia con ningún caracter de mask
var_dump(strspn("foo", "o"));
// examina dos caracteres de subject iniciando en el offset 1
var_dump(strspn("foo", "o", 1, 2));
// examina un caracter de subject iniciando en el offset 1
var_dump(strspn("foo", "o", 1, 1));
?>
El resultado del ejemplo sería:
int(0) int(2) int(1)
Notas
Nota: Esta función es segura binariamente.