PHP | Función strcspn()

La función strcspn() es una función incorporada en PHP que devuelve el número de caracteres presentes en una string antes de que se encuentre cualquier parte de los caracteres especificados que se van a buscar. Esta función distingue entre mayúsculas y minúsculas.

Sintaxis:  

strcspn( $string, $charlist, $start, $length)

Parámetros: esta función acepta cuatro parámetros como se muestra en la sintaxis anterior. Los dos primeros parámetros son obligatorios y deben proporcionarse, mientras que los dos parámetros restantes son opcionales. Todos estos parámetros se describen a continuación: 
 

• $string: este parámetro obligatorio especifica la string para buscar
• $charlist: este parámetro obligatorio especifica la lista de caracteres que se buscarán en la $string dada.
• $start : este parámetro opcional especifica el índice desde donde comenzar a buscar en la string. 
  • Si se proporciona $start y no es negativo , entonces strcspn() comenzará a examinar $string desde esa posición.
  • Si se da $start y es negativo , entonces strcspn() comenzará a examinar $string desde esa posición desde el final de $string.
• $longitud: especifica el número de caracteres de $string que se necesitan para buscar. Su valor predeterminado es hasta el final de la $string. 
  • Si se proporciona $longitud y no es negativo , se examinará la $string en busca de caracteres de $longitud desde la posición inicial.
  • Si se proporciona $longitud y es negativo , entonces $string se examinará desde la posición inicial hasta $longitud caracteres desde el final de $string.

Valor devuelto: Devuelve el número de caracteres desde la posición inicial (incluidos los espacios en blanco) presentes en la string antes de que cualquiera de los caracteres del parámetro $charlist se encuentre en la string.

Ejemplos: 

Input : $string = "Geeks for Geeks", $charlist = "mnopqr"
Output : 7

Input : $string = "Geeks for Geeks", $charlist = "for"
Output : 6

Los siguientes programas ilustrarán el uso de la función strcspn() : 

Programa 1: Este programa muestra el uso simple de la función strcspn().  

<?php
 
// Output is 6 because the input string
// contains 6 characters "Geeks " before
// the first character 'f' from the list
// "for" is found in the string.
echo strcspn("Geeks for Geeks", "for");
 
?>

Salida : 

6

Programa 2: Este programa muestra la distinción entre mayúsculas y minúsculas de la función strcspn(). 

<?php
 
// Output is 7 because the input string
// does not contain 'F' as specified in the list "For".
// Hence the first character from the
// list that is present in the string is 'o'
echo strcspn("Geeks for Geeks", "For");
 
?>

Salida : 

7

Programa 3: Este programa muestra el uso de la función strcspn() con el parámetro $start. 

<?php
 
// Searches from index 5 till
// the end of the string
echo strcspn("Geeks for Geeks", "G", 5);
 
?>

Salida : 

5

Programa 4: Este programa ilustra el uso de la función strcspn() con un parámetro $longitud negativo.  

<?php
 
// Searches from index 5 till 5-th position
// from end. Output is 0 since the character
// at $start (i.e. 5) is present in the
// specified list of characters
echo strcspn("Geeks for Geeks", " for", 5, -5);
 
?>

Salida : 

0

Programa 5: Este programa muestra el uso de la función strcspn() con un parámetro $start negativo. 

<?php
 
// Searches from 5th index from the end of the string
// Output is 0 as the character 'G' in the
// specified starting index is present in the
// given list of characters to be checked.
echo strcspn("Geeks for Geeks", "Geek", -5);
  
?>

Salida : 

0

Referencia: 
http://php.net/manual/en/function.strcspn.php