archived-doc-it/reference/strings/functions/htmlspecialchars.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: n/a Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 -->
  <refentry xml:id="function.htmlspecialchars" xmlns="http://docbook.org/ns/docbook">
   <refnamediv>
    <refname>htmlspecialchars</refname> 
    <refpurpose>
     Converte i caratteri speciali in entità HTML
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>htmlspecialchars</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>quote_style</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam>
     </methodsynopsis>
    <para>
     Alcuni caratteri hanno significati particolari in HTML, e, per questo,
     devono essere rappresentati tramite entità HTML, se devono mantenere il proprio
     significato. Questa funzione restituisce restituisce una stringa con
     la conversione di alcuni di questi caratteri; la conversione svolta non è
     sempre valida nell'ambito della programmazione web. Se occorre l'utilizzo
     di tutte le entità HTML, utilizzare
     <function>htmlentities</function>.
    </para>
    <simpara>
     Questa funzione è utile nel prevenire la presenza di marcatori
     HTML negli input utente, tipo nei forum o nei guest book.
     Il secondo parametro <parameter>quote_style</parameter>, opzionale,
     indica alla funzione come comportarsi con gli apici singoli e doppi.
     La modalità di default è, <constant>ENT_COMPAT</constant>; questa modalità è compatibile con il passato
     e traduce solo gli apici doppi lasciando inalterati gli apici singoli.
     Se si imposta <constant>ENT_QUOTES</constant>, entrambi i tipi di apici, singoli e doppi,
     sono convertiti in entità e, infine, se si utilizza <constant>ENT_NOQUOTES</constant> ne gli apici singoli
     ne gli apici doppi sono convertiti in entità.
    </simpara>
    <para>
     La conversioni applicate sono:
     <itemizedlist>
      <listitem>
       <simpara>
        '&amp;' (e commerciale) diventa '&amp;amp;'
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&quot;' (doppio apice) diventa '&amp;quot;' con <constant>ENT_NOQUOTES</constant>
        is not set.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&#039;' (singolo apice) diventa '&amp;#039;' soltanto con
        l'impostazione di <constant>ENT_QUOTES</constant>.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&lt;' (minore) diventa '&amp;lt;'
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&gt;' (maggiore) diventa '&amp;gt;'
       </simpara>
      </listitem>
     </itemizedlist>
     <example>
      <title>Esempio di uso di <function>htmlspecialchars</function></title>
      <programlisting role="php">
<![CDATA[
<?php
$new = htmlspecialchars("<a href='test'>Test</a>", ENT_QUOTES);
echo $new; // &lt;a href=&#039;test&#039;&gt;Test&lt;/a&gt;
?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Occorre notare che questa funzione non converte null'altro oltre
     ai caratteri elencati in precedenza. Per la conversione di tutte le entità
     fare riferimento a <function>htmlentities</function>. Il secondo parametro
     è stato inserito in PHP 3.0.17 e 4.0.3. 
    </para>
    <para>
     Il terzo parametro <parameter>charset</parameter> indica quale set di caratteri utilizzare
     nella conversione. Il set di caratteri di default è ISO-8859-1. Questo terzo
     parametro è stato aggiunto in PHP 4.1.0.
    </para>
    &reference.strings.charsets;
    <para>
     Vedere anche <function>get_html_translation_table</function>,
     <function>strip_tags</function>,
     <function>htmlentities</function> e <function>nl2br</function>.
    </para>
   </refsect1>
  </refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->