<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.strings.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'it',
  ),
  'this' => 
  array (
    0 => 'function.addcslashes.php',
    1 => 'addcslashes',
    2 => 'Esegue il quoting di una stringa con gli slash nello stile del C',
  ),
  'up' => 
  array (
    0 => 'ref.strings.php',
    1 => 'String Funzioni',
  ),
  'prev' => 
  array (
    0 => 'ref.strings.php',
    1 => 'String Funzioni',
  ),
  'next' => 
  array (
    0 => 'function.addslashes.php',
    1 => 'addslashes',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'it',
    'path' => 'reference/strings/functions/addcslashes.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.addcslashes" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">addcslashes</h1>
  <p class="verinfo">(PHP 4, PHP 5, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">addcslashes</span> &mdash; <span class="dc-title">Esegue il quoting di una stringa con gli slash nello stile del C</span></p>

 </div>
 
 <div class="refsect1 description" id="refsect1-function.addcslashes-description">
  <h3 class="title">Descrizione</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>addcslashes</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$str</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$charlist</code></span>): <span class="type"><a href="language.types.string.php" class="type string">string</a></span></div>

  <p class="para rdfs-comment">
   La funzione restituisce una stringa con il carattere di backslash &#039;\&#039; anteposto
   ai caratteri che sono indicati nel parametro <code class="parameter">charlist</code>.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.addcslashes-parameters">
  <h3 class="title">Elenco dei parametri</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">str</code></dt>
     <dd>
      <p class="para">
       La stringa su cui effettuare l&#039;escape.
      </p>
     </dd>
    
    
     <dt><code class="parameter">charlist</code></dt>
     <dd>
      <p class="para">
       Una lista dei caratteri su cui effettuare l&#039;escape. Se
       <code class="parameter">charlist</code> contiene i caratteri
       <code class="literal">\n</code>, <code class="literal">\r</code> ecc., essi sono
       convertiti nello stile C-like, mentre gli altri caratteri non alfanumerici
       con codici ASCII minori di 32 e maggiori di 126 sono convertiti nella
       rappresentazione ottale.
      </p>
      <p class="para">
       Quando si definisce una sequenza di caratteri nel parametro charlist
       assicurarsi di sapere quali caratteri sono presenti tra i
       caratteri che si sono impostati come inizio e la fine dell&#039;intervallo.
       <div class="informalexample">
        <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">addcslashes</span><span style="color: #007700">(</span><span style="color: #DD0000">'foo[ ]'</span><span style="color: #007700">, </span><span style="color: #DD0000">'A..z'</span><span style="color: #007700">);<br /></span><span style="color: #FF8000">// output:  \f\o\o\[ \]<br />// Su tutte le lettere maiuscole e minuscole verrà effettuato l'escape<br />// ... ma anche [\]^_`<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
        </div>

       </div>
       Inoltre, se il primo carattere in un intervallo ha un valore ASCII maggiore
       del secondo carattere nell&#039;intervallo, non verrà costruito
       nessun intervallo.  Solo sull&#039;inizio, sulla fine e sui caratteri period (&#039;.&#039;) sarà
       effettuato l&#039;escape. Usare la funzione <span class="function"><a href="function.ord.php" class="function">ord()</a></span> per trovare il
       valore ASCII per un carattere.
       <div class="informalexample">
        <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">addcslashes</span><span style="color: #007700">(</span><span style="color: #DD0000">"zoo['.']"</span><span style="color: #007700">, </span><span style="color: #DD0000">'z..A'</span><span style="color: #007700">);<br /></span><span style="color: #FF8000">// output:  \zoo['\.']<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
        </div>

       </div>
      </p>
      <p class="para">
       Occorre prestare attenzione se si imposta di anteporre il carattere di escape ai caratteri
       0, a, b, f, n, r, t e v. Questi saranno convertiti in \0, \a, \b, \f, \n, \r, \t e \v,
       i quali sono sequenze di escape predefinite in C. Molte di queste sequenze sono
       anche definite in altri linguaggi derivati da C, incluso PHP, il che significa che
       non si possono ottenere i risultati desiderati se si usa l&#039;output di
       <span class="function"><strong>addcslashes()</strong></span> per generare codice in questi linguaggi
       con questi caratteri definiti in <code class="parameter">charlist</code>.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.addcslashes-returnvalues">
  <h3 class="title">Valori restituiti</h3>
  <p class="para">
   Restituisce la stringa con l&#039;escape.
  </p>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.addcslashes-changelog">
  <h3 class="title">Log delle modifiche</h3>
  <p class="para">
   <table class="doctable informaltable">
    
     <thead>
      <tr>
       <th>Versione</th>
       <th>Descrizione</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td>5.2.5</td>
       <td>
        Sono state aggiunte le sequenze di escape \v e \f.
       </td>
      </tr>

     </tbody>
    
   </table>

  </p>
 </div>

 
 <div class="refsect1 examples" id="refsect1-function.addcslashes-examples">
  <h3 class="title">Esempi</h3>
  <p class="para">
    Usare <code class="parameter">charlist</code> pari a &quot;\0..\37&quot;, significa che si vuole effettuare
    l&#039;escape di tutti i caratteri con codice ASCII tra 0 e 31.
   <div class="example" id="example-1">
    <p><strong>Example #1 Esempio di <span class="function"><strong>addcslashes()</strong></span></strong></p>
    <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$escaped </span><span style="color: #007700">= </span><span style="color: #0000BB">addcslashes</span><span style="color: #007700">(</span><span style="color: #0000BB">$not_escaped</span><span style="color: #007700">, </span><span style="color: #DD0000">"\0..\37!@\177..\377"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.addcslashes-seealso">
  <h3 class="title">Vedere anche:</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.stripcslashes.php" class="function" rel="rdfs-seeAlso">stripcslashes()</a> - Rimuove gli slash aggiunti con addcslashes</span></li>
    <li><span class="function"><a href="function.stripslashes.php" class="function" rel="rdfs-seeAlso">stripslashes()</a> - Rimuove i caratteri di escape da una stringa su cui si &egrave; effettuato l'escape</span></li>
    <li><span class="function"><a href="function.addslashes.php" class="function" rel="rdfs-seeAlso">addslashes()</a> - Esegue il quoting di una stringa con gli slash</span></li>
    <li><span class="function"><a href="function.htmlspecialchars.php" class="function" rel="rdfs-seeAlso">htmlspecialchars()</a> - Converte i caratteri speciali in entit&agrave; HTML</span></li>
    <li><span class="function"><a href="function.quotemeta.php" class="function" rel="rdfs-seeAlso">quotemeta()</a> - Quota i meta caratteri</span></li>
   </ul>
  </p>
 </div>


</div><?php manual_footer($setup); ?>