<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >sscanf</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REL="HOME" TITLE="Manual do PHP" HREF="index.html"><LINK REL="UP" TITLE="String" HREF="ref.strings.html"><LINK REL="PREVIOUS" TITLE="sprintf" HREF="function.sprintf.html"><LINK REL="NEXT" TITLE="str_getcsv" HREF="function.str-getcsv.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=UTF-8"></HEAD ><BODY CLASS="refentry" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >Manual do PHP</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.sprintf.html" ACCESSKEY="P" >Anterior</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.str-getcsv.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="function.sscanf" ></A >sscanf</H1 ><DIV CLASS="refnamediv" ><A NAME="AEN220640" ></A ><P > (PHP 4 >= 4.0.1, PHP 5)</P >sscanf -- Interpreta a entrada de uma string de acordo com um formato </DIV ><DIV CLASS="refsect1" ><A NAME="AEN220643" ></A ><H2 >Descrição</H2 >mixed <B CLASS="methodname" >sscanf</B > ( string str, string formato [, string var1] )<BR ></BR ><P > A função <B CLASS="function" >sscanf()</B > é análoga a <A HREF="function.printf.html" ><B CLASS="function" >printf()</B ></A >. <B CLASS="function" >sscanf()</B > lê da string <CODE CLASS="parameter" >str</CODE > e interpreta ela de acordo com o <CODE CLASS="parameter" >formato</CODE > especificado. Se apenas dois parâmetros forem passados para esta função, os valores interpretados serão retornados como array. </P ><P > Qualquer espaço em branco na string de formato será comparada com qualquer espaço em branco na string de entrada. Isto significa que até mesmo um tab \t na string de formato pode ser comparada com um caractere de espaço simples na string de entrada. </P ><P > <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN220665" ></A ><P ><B >Exemplo 1. <B CLASS="function" >sscanf()</B > Exemplo</B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br /></font><font color="#FF8000">// Pegando o número serial<br /></font><font color="#0000BB">$serial </font><font color="#007700">= </font><font color="#0000BB">sscanf</font><font color="#007700">(</font><font color="#DD0000">"SN/2350001"</font><font color="#007700">,</font><font color="#DD0000">"SN/%d"</font><font color="#007700">);<br /></font><font color="#FF8000">// e a data de criação<br /></font><font color="#0000BB">$mandate </font><font color="#007700">= </font><font color="#DD0000">"January 01 2000"</font><font color="#007700">;<br />list(</font><font color="#0000BB">$month</font><font color="#007700">, </font><font color="#0000BB">$day</font><font color="#007700">, </font><font color="#0000BB">$year</font><font color="#007700">) = </font><font color="#0000BB">sscanf</font><font color="#007700">(</font><font color="#0000BB">$mandate</font><font color="#007700">,</font><font color="#DD0000">"%s %d %d"</font><font color="#007700">);<br />echo </font><font color="#DD0000">"O Item $serial foi criado em: $year-"</font><font color="#007700">.</font><font color="#0000BB">substr</font><font color="#007700">(</font><font color="#0000BB">$month</font><font color="#007700">,</font><font color="#0000BB">0</font><font color="#007700">,</font><font color="#0000BB">3</font><font color="#007700">).</font><font color="#DD0000">"-$day</font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE > Se parâetros opcionais são passados, a função retornará o número de valores assumidos. Os parâmetros opcionais devem ser passados por referência. <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN220669" ></A ><P ><B >Exemplo 2. <B CLASS="function" >sscanf()</B > - usando parâmetros opcionais</B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br /></font><font color="#FF8000">// pega informação do autor e gera uma entrada de DocBook<br /></font><font color="#0000BB">$auth </font><font color="#007700">= </font><font color="#DD0000">"24\tLewis Carroll"</font><font color="#007700">;<br /></font><font color="#0000BB">$n </font><font color="#007700">= </font><font color="#0000BB">sscanf</font><font color="#007700">(</font><font color="#0000BB">$auth</font><font color="#007700">,</font><font color="#DD0000">"%d\t%s %s"</font><font color="#007700">, &</font><font color="#0000BB">$id</font><font color="#007700">, &</font><font color="#0000BB">$first</font><font color="#007700">, &</font><font color="#0000BB">$last</font><font color="#007700">);<br />echo </font><font color="#DD0000">"<author id='$id'><br /> <firstname>$first</firstname><br /> <surname>$last</surname><br /></author></font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE > </P ><P > Veja também <A HREF="function.fscanf.html" ><B CLASS="function" >fscanf()</B ></A >, <A HREF="function.printf.html" ><B CLASS="function" >printf()</B ></A >, e <A HREF="function.sprintf.html" ><B CLASS="function" >sprintf()</B ></A >. </P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="function.sprintf.html" ACCESSKEY="P" >Anterior</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Principal</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.str-getcsv.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >sprintf</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ref.strings.html" ACCESSKEY="U" >Acima</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >str_getcsv</TD ></TR ></TABLE ></DIV ></BODY ></HTML >