array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.sscanf.php', 1 => 'sscanf', 2 => 'Analiza una cadena utilizando un formato', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Funciones de strings', ), 'prev' => array ( 0 => 'function.sprintf.php', 1 => 'sprintf', ), 'next' => array ( 0 => 'function.str-contains.php', 1 => 'str_contains', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/strings/functions/sscanf.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

sscanf

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

sscanf — Analiza una cadena utilizando un formato

Descripción

function sscanf(string $string, string $format, mixed &...$vars): array|int|null

sscanf() es la función inversa de printf(). sscanf() lee datos de la cadena string e los interpreta según el formato format.

Todos los caracteres en blanco en la cadena format corresponden a un carácter en blanco en la cadena string. Esto significa que incluso una tabulación (\t) en la cadena de formato puede corresponder a un simple espacio en la cadena str.

Parámetros

string
La cadena a analizar.
format

El formato interpretado para string se describe en la documentación de la sprintf() con las siguientes diferencias:

  • La función no tiene en cuenta el contexto local.
  • F, g, G y b no son soportados.
  • D representa un número decimal.
  • i representa un número entero con detección de base.
  • n representa el número de caracteres tratados hasta este punto.
  • s detiene la lectura en cada carácter de espacio.
  • * en lugar de argnum$ elimina la asignación de esta especificación de conversión.

vars
Opcionalmente, se pueden pasar variables en este parámetro, por referencia que contendrán los valores del análisis.

Valores devueltos

Si solo se proporcionan dos parámetros, los valores encontrados se devolverán como un array. De lo contrario, si se proporcionan los parámetros opcionales, la función devolverá el número de valores asignados. El parámetro opcional debe pasarse por referencia.

Si hay más subcadenas esperadas en el parámetro format que las disponibles en string, entonces null será devuelto.

Cuando se usan parámetros opcionales y se alcanza el final de la cadena de entrada string antes de que se haya analizado ningún valor, se devuelve -1.

Ejemplos

Ejemplo #1 Ejemplo con sscanf()

<?php
// Lectura de un número de serie
list($serial) = sscanf("SN/2350001", "SN/%d");
// y la fecha de fabricación
$mandate = "January 01 2000";
list($month, $day, $year) = sscanf($mandate, "%s %d %d");
echo "El producto $serial fue fabricado el: $year-" . substr($month, 0, 3) . "-$day\n";
?>

Si se pasan parámetros opcionales, sscanf() devolverá el número de valores asignados.

Ejemplo #2 sscanf() - uso de parámetros opcionales

<?php
// lee la información del autor y genera una entrada DocBook
$auth = "24\tLewis Carroll";
$n = sscanf($auth, "%d\t%s %s", $id, $first, $last);
echo "<author id='$id'>
<firstname>$first</firstname>
<surname>$last</surname>
</author>\n";
?>

Ver también