<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>htmlspecialchars</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="htmlspecialchars_decode"
HREF="function.htmlspecialchars-decode.html"><LINK
REL="NEXT"
TITLE="implode"
HREF="function.implode.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.htmlspecialchars-decode.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.implode.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.htmlspecialchars"
></A
>htmlspecialchars</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN219394"
></A
><P
> (PHP 3, PHP 4, PHP 5)</P
>htmlspecialchars --
Converte caracteres especiais para a realidade HTML
</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN219397"
></A
><H2
>Descrição</H2
>string <B
CLASS="methodname"
>htmlspecialchars</B
> ( string string [, int quote_style [, string charset]] )<BR
></BR
><P
> Certos caracteres tem significado especial em HTML, e seriam
representados pela realidade HTML se eles estão preservanado
seus significados. Esta função retorna uma string com algumas
destas conversões feitas; As transformações feitas são aquelas
mais úteis para programação web. Se você precisa que sejam
transformados todos os caracteres da realidade HTML, use
<A
HREF="function.htmlentities.html"
><B
CLASS="function"
>htmlentities()</B
></A
> no lugar dela.
</P
><P
> Esta função é útil na prevenção de textos fornecidos pelo usuário
contendo marcação HTML, tal como um quadro de mensgens ou guest book.
O segundo argumento opcional, <CODE
CLASS="parameter"
>quote_style</CODE
>, conta à função o que fazer
com os caracteres aspas simples e dupla.
O modo padrão, <TT
CLASS="constant"
><B
>ENT_COMPAT</B
></TT
>, é o modo mais compatível com a atualidade,
apenas transforma a aspas-dupla e deixa a aspas-simples como está.
Se <TT
CLASS="constant"
><B
>ENT_QUOTES</B
></TT
> está definida, ambas
transformadas e se <TT
CLASS="constant"
><B
>ENT_NOQUOTES</B
></TT
> está definida
nenhuma das duas são modificadas.
</P
><P
> As traduções executadas são:
<P
></P
><UL
><LI
><P
> '&' (ampersand) torna-se '&amp;'
</P
></LI
><LI
><P
> '"' (aspas dupla) torna-se '&quot;' quando <TT
CLASS="constant"
><B
>ENT_NOQUOTES</B
></TT
>
não está definida.
</P
></LI
><LI
><P
> ''' (aspas simples) torna-se '&#039;' apenas quando
<TT
CLASS="constant"
><B
>ENT_QUOTES</B
></TT
> está definida.
</P
></LI
><LI
><P
> '<' (menor que) torna-se '&lt;'
</P
></LI
><LI
><P
> '>' (maior que) torna-se '&gt;'
</P
></LI
></UL
>
<TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN219432"
></A
><P
><B
>Exemplo 1. <B
CLASS="function"
>htmlspecialchars()</B
> exemplo</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br />$new </font><font color="#007700">= </font><font color="#0000BB">htmlspecialchars</font><font color="#007700">(</font><font color="#DD0000">"<a href='test'>Test</a>"</font><font color="#007700">, </font><font color="#0000BB">ENT_QUOTES</font><font color="#007700">);<br />echo </font><font color="#0000BB">$new</font><font color="#007700">; </font><font color="#FF8000">// &lt;a href=&#039;test&#039;&gt;Test&lt;/a&gt; <br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
</P
><P
> Note que esta função não converte nada além do que foi listado acima.
Para completa realidade de conversões, veja
<A
HREF="function.htmlentities.html"
><B
CLASS="function"
>htmlentities()</B
></A
>. Suporte para
o segundo argumento opcional foi adicionado no PHP 3.0.17 e PHP 4.0.3.
</P
><P
> O terceiro argumento define o conjunto de caracteres usados na conversão. O
conjunto de caracteres padrão é ISO-8859-1. Suporte para o terceiro argumento
foi adicionado no PHP 4.1.0.
</P
><P
> Os seguintes conjuntos de caracteres são suportados no PHP 4.3.0 e posterior.
<DIV
CLASS="table"
><A
NAME="AEN219440"
></A
><P
><B
>Tabela 1. Conjuntos de caracteres suportados</B
></P
><TABLE
BORDER="1"
CLASS="CALSTABLE"
><COL><COL><COL><THEAD
><TR
><TH
>Conjunto de caracteres</TH
><TH
>Apelidos</TH
><TH
>Descrição</TH
></TR
></THEAD
><TBODY
><TR
><TD
>ISO-8859-1</TD
><TD
>ISO8859-1</TD
><TD
> Western European, Latin-1
</TD
></TR
><TR
><TD
>ISO-8859-15</TD
><TD
>ISO8859-15</TD
><TD
> Western European, Latin-9. Adiciona o símbolo do Euro, letras Francesas e Filandesas
faltando no Latin-1(ISO-8859-1).
</TD
></TR
><TR
><TD
>UTF-8</TD
><TD
> </TD
><TD
> Código de multi-byte 8-bit Unicode compatível com ASCII.
</TD
></TR
><TR
><TD
>cp866</TD
><TD
>ibm866, 866</TD
><TD
> Conjunto de caracteres do DOS específico para o Russo.
Este conjunto de caracteres é suportado no 4.3.2.
</TD
></TR
><TR
><TD
>cp1251</TD
><TD
>Windows-1251, win-1251, 1251</TD
><TD
> Conjunto de caracteres do Windows específico para o Russo.
Este conjunto de caracteres é suportado no 4.3.2.
</TD
></TR
><TR
><TD
>cp1252</TD
><TD
>Windows-1252, 1252</TD
><TD
> Conjunto de caracteres do Windows específico para a Europa Ocidental.
</TD
></TR
><TR
><TD
>KOI8-R</TD
><TD
>koi8-ru, koi8r</TD
><TD
> Russo. Este conjunto de caracteres é suportado no 4.3.2.
</TD
></TR
><TR
><TD
>BIG5</TD
><TD
>950</TD
><TD
> Chinês Tradicional, usado principalmente em Taiwan.
</TD
></TR
><TR
><TD
>GB2312</TD
><TD
>936</TD
><TD
> Chins Simplificado, conjunto de caracteres padrão nacional.
</TD
></TR
><TR
><TD
>BIG5-HKSCS</TD
><TD
> </TD
><TD
> Big5 com extenções de Hong Kong, Chinês Tradicional.
</TD
></TR
><TR
><TD
>Shift_JIS</TD
><TD
>SJIS, 932</TD
><TD
> Japonês
</TD
></TR
><TR
><TD
>EUC-JP</TD
><TD
>EUCJP</TD
><TD
> Japonês
</TD
></TR
></TBODY
></TABLE
></DIV
>
<DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
Qualquer outro conjunto de caracteres não é reconhecido e será usado o ISO-8859-1.
</P
></BLOCKQUOTE
></DIV
>
</P
><P
> Veja também <A
HREF="function.get-html-translation-table.html"
><B
CLASS="function"
>get_html_translation_table()</B
></A
>,
<A
HREF="function.htmlentities.html"
><B
CLASS="function"
>htmlentities()</B
></A
>,
<A
HREF="function.strip-tags.html"
><B
CLASS="function"
>strip_tags()</B
></A
> e
<A
HREF="function.nl2br.html"
><B
CLASS="function"
>nl2br()</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.htmlspecialchars-decode.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.implode.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>htmlspecialchars_decode</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"
>implode</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
