Sophie

Sophie

distrib > Mandriva > 2008.1 > i586 > by-pkgid > 703d980c580707c382b4e43e25965bc5 > files > 105

php-manual-pt_BR-5.2.4-1mdv2008.1.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Lista de Filtros Disponíveis</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="Apêndices"
HREF="appendices.html"><LINK
REL="PREVIOUS"
TITLE="Process Interaction Streams"
HREF="wrappers.expect.html"><LINK
REL="NEXT"
TITLE="Fitros de Conversão"
HREF="filters.convert.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="appendix"
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="wrappers.expect.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="filters.convert.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="appendix"
><H1
><A
NAME="filters"
>Apêndice O. Lista de Filtros Disponíveis</A
></H1
><DIV
CLASS="TOC"
><DL
><DT
><B
>Índice</B
></DT
><DT
><A
HREF="filters.html#filters.string"
>Filtros de String</A
></DT
><DT
><A
HREF="filters.convert.html"
>Fitros de Conversão</A
></DT
><DT
><A
HREF="filters.compression.html"
>Filtros de Compressão</A
></DT
><DT
><A
HREF="filters.encryption.html"
>Encryption Filters</A
></DT
></DL
></DIV
><P
>&#13;  A seguir está uma lista de alguns filtros built-in de stream para
  o uso com <A
HREF="function.stream-filter-append.html"
><B
CLASS="function"
>stream_filter_append()</B
></A
>.
  Sua versão de PHP pode ter mais filtros (ou menos) que os
  listados aqui.
 </P
><P
>&#13;  Vale reparar que existe uma leve assimetria entre
  <A
HREF="function.stream-filter-append.html"
><B
CLASS="function"
>stream_filter_append()</B
></A
>
  e <A
HREF="function.stream-filter-prepend.html"
><B
CLASS="function"
>stream_filter_prepend()</B
></A
>
  Toda stream no PHP contem um pequeno <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>buffer de leitura</I
></SPAN
>
  onde ele guarda blocos de dados recuperados do
  sistema de arquivo ou outro recurso (resource) com o propósito de processar dados
  da maneira mais eficiente. Assim que os dados são puxados
  do recurso para o buffer interno da stream, eles
  são processados imediatamente por qualquer filtro anexo caso
  a aplicação PHP esteja preparada ou não para receber os dados.
  Se os dados estão esperando no buffer de leitura quando o filtro for
  <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>appended</I
></SPAN
>, esses dados serão imediatamente
  processados através daquele buffer, fazendo o fato de que eles estavam
  esperando num buffer transparente. No entanto, se os dados estão
  esperando no buffer de leitura quando um filtro é
  <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>prepended</I
></SPAN
>, esses dados <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>NÃO</I
></SPAN
> serão
  processados pelo filtro. Ao invés disso, eles esperarão até
  o próximo bloco de dados ser recuperado do recurso.
 </P
><P
>&#13;  Para uma lista dos filtros instalados na sua versão do
  PHP use <A
HREF="function.stream-get-filters.html"
><B
CLASS="function"
>stream_get_filters()</B
></A
>.
 </P
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="filters.string"
>Filtros de String</A
></H1
><P
>&#13;   Cada um dos filtros faz precisamente o que o seu nome implica e
   corresponde ao comportamente da função de manuseio de string homônima.
   Para mais informação em um dado filtro, veja a página do manual para
   a função correspondente.
  </P
><P
>&#13;   <TT
CLASS="literal"
>string.rot13</TT
>
   (since PHP 4.3.0)
   Uso desse filtro é equivalente a processar todos os dados da stream com
   a função <A
HREF="function.str-rot13.html"
><B
CLASS="function"
>str_rot13()</B
></A
>.
  </P
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN289314"
></A
><P
><B
>Exemplo O-1. string.rot13</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />$fp </font><font color="#007700">= </font><font color="#0000BB">fopen</font><font color="#007700">(</font><font color="#DD0000">'php://output'</font><font color="#007700">, </font><font color="#DD0000">'w'</font><font color="#007700">);<br /></font><font color="#0000BB">stream_filter_append</font><font color="#007700">(</font><font color="#0000BB">$fp</font><font color="#007700">, </font><font color="#DD0000">'string.rot13'</font><font color="#007700">);<br /></font><font color="#0000BB">fwrite</font><font color="#007700">(</font><font color="#0000BB">$fp</font><font color="#007700">, </font><font color="#DD0000">"This is a test.\n"</font><font color="#007700">);<br /></font><font color="#FF8000">/* Outputs:&nbsp;&nbsp;Guvf vf n grfg.&nbsp;&nbsp;&nbsp;*/<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
><P
>&#13;   <TT
CLASS="literal"
>string.toupper</TT
>
   (since PHP 5.0.0)
   Uso desse filtro é equivalente a processar todos os dados da stream com
   a função <A
HREF="function.strtoupper.html"
><B
CLASS="function"
>strtoupper()</B
></A
>.
  </P
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN289320"
></A
><P
><B
>Exemplo O-2. string.toupper</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />$fp </font><font color="#007700">= </font><font color="#0000BB">fopen</font><font color="#007700">(</font><font color="#DD0000">'php://output'</font><font color="#007700">, </font><font color="#DD0000">'w'</font><font color="#007700">);<br /></font><font color="#0000BB">stream_filter_append</font><font color="#007700">(</font><font color="#0000BB">$fp</font><font color="#007700">, </font><font color="#DD0000">'string.toupper'</font><font color="#007700">);<br /></font><font color="#0000BB">fwrite</font><font color="#007700">(</font><font color="#0000BB">$fp</font><font color="#007700">, </font><font color="#DD0000">"This is a test.\n"</font><font color="#007700">);<br /></font><font color="#FF8000">/* Outputs:&nbsp;&nbsp;THIS IS A TEST.&nbsp;&nbsp;&nbsp;*/<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
><P
>&#13;   <TT
CLASS="literal"
>string.tolower</TT
>
   (since PHP 5.0.0)
   Uso desse filtro é equivalente a processar todos os dados da stream com
   a função <A
HREF="function.strtolower.html"
><B
CLASS="function"
>strtolower()</B
></A
>.
  </P
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN289326"
></A
><P
><B
>Exemplo O-3. string.tolower</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />$fp </font><font color="#007700">= </font><font color="#0000BB">fopen</font><font color="#007700">(</font><font color="#DD0000">'php://output'</font><font color="#007700">, </font><font color="#DD0000">'w'</font><font color="#007700">);<br /></font><font color="#0000BB">stream_filter_append</font><font color="#007700">(</font><font color="#0000BB">$fp</font><font color="#007700">, </font><font color="#DD0000">'string.tolower'</font><font color="#007700">);<br /></font><font color="#0000BB">fwrite</font><font color="#007700">(</font><font color="#0000BB">$fp</font><font color="#007700">, </font><font color="#DD0000">"This is a test.\n"</font><font color="#007700">);<br /></font><font color="#FF8000">/* Outputs:&nbsp;&nbsp;this is a test.&nbsp;&nbsp;&nbsp;*/<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
><P
>&#13;   <TT
CLASS="literal"
>string.strip_tags</TT
>
   (since PHP 5.0.0)
   Uso desse filtro é equivalente a processar todos os dados da stream com
   a função <A
HREF="function.strip-tags.html"
><B
CLASS="function"
>strip_tags()</B
></A
>.
   Ela aceita parâmetros em uma das duas formas:
   Ou como uma string contendo uma lista de tags similares ao
   segundo parâmetro da função <A
HREF="function.strip-tags.html"
><B
CLASS="function"
>strip_tags()</B
></A
>,
   ou como um array dos nomes das tags.
  </P
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN289333"
></A
><P
><B
>Exemplo O-4. string.strip_tags</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />$fp </font><font color="#007700">= </font><font color="#0000BB">fopen</font><font color="#007700">(</font><font color="#DD0000">'php://output'</font><font color="#007700">, </font><font color="#DD0000">'w'</font><font color="#007700">);<br /></font><font color="#0000BB">stream_filter_append</font><font color="#007700">(</font><font color="#0000BB">$fp</font><font color="#007700">, </font><font color="#DD0000">'string.strip_tags'</font><font color="#007700">, </font><font color="#0000BB">STREAM_FILTER_WRITE</font><font color="#007700">, </font><font color="#DD0000">"&lt;b&gt;&lt;i&gt;&lt;u&gt;"</font><font color="#007700">);<br /></font><font color="#0000BB">fwrite</font><font color="#007700">(</font><font color="#0000BB">$fp</font><font color="#007700">, </font><font color="#DD0000">"&lt;b&gt;bolded text&lt;/b&gt; enlarged to a &lt;h1&gt;level 1 heading&lt;/h1&gt;\n"</font><font color="#007700">);<br /></font><font color="#0000BB">fclose</font><font color="#007700">(</font><font color="#0000BB">$fp</font><font color="#007700">);<br /></font><font color="#FF8000">/* Outputs:&nbsp;&nbsp;&lt;b&gt;bolded text&lt;/b&gt; enlarged to a level 1 heading&nbsp;&nbsp;&nbsp;*/<br /><br /></font><font color="#0000BB">$fp </font><font color="#007700">= </font><font color="#0000BB">fopen</font><font color="#007700">(</font><font color="#DD0000">'php://output'</font><font color="#007700">, </font><font color="#DD0000">'w'</font><font color="#007700">);<br /></font><font color="#0000BB">stream_filter_append</font><font color="#007700">(</font><font color="#0000BB">$fp</font><font color="#007700">, </font><font color="#DD0000">'string.strip_tags'</font><font color="#007700">, </font><font color="#0000BB">STREAM_FILTER_WRITE</font><font color="#007700">, array(</font><font color="#DD0000">'b'</font><font color="#007700">,</font><font color="#DD0000">'i'</font><font color="#007700">,</font><font color="#DD0000">'u'</font><font color="#007700">));<br /></font><font color="#0000BB">fwrite</font><font color="#007700">(</font><font color="#0000BB">$fp</font><font color="#007700">, </font><font color="#DD0000">"&lt;b&gt;bolded text&lt;/b&gt; enlarged to a &lt;h1&gt;level 1 heading&lt;/h1&gt;\n"</font><font color="#007700">);<br /></font><font color="#0000BB">fclose</font><font color="#007700">(</font><font color="#0000BB">$fp</font><font color="#007700">);<br /></font><font color="#FF8000">/* Outputs:&nbsp;&nbsp;&lt;b&gt;bolded text&lt;/b&gt; enlarged to a level 1 heading&nbsp;&nbsp;&nbsp;*/<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
></DIV
></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="wrappers.expect.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="filters.convert.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Process Interaction Streams</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="appendices.html"
ACCESSKEY="U"
>Acima</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Fitros de Conversão</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>