<?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 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.addcslashes.php',
    1 => 'addcslashes',
    2 => 'A&ntilde;ade barras invertidas a un string, al estilo del lenguaje C',
  ),
  'up' => 
  array (
    0 => 'ref.strings.php',
    1 => 'Funciones de strings',
  ),
  'prev' => 
  array (
    0 => 'ref.strings.php',
    1 => 'Funciones de strings',
  ),
  'next' => 
  array (
    0 => 'function.addslashes.php',
    1 => 'addslashes',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    '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">Añade barras invertidas a un string, al estilo del lenguaje C</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.addcslashes-description">
  <h3 class="title">Descripción</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">$string</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$characters</code></span>): <span class="type"><a href="language.types.string.php" class="type string">string</a></span></div>

  <p class="para rdfs-comment">
   Devuelve el string <code class="parameter">string</code>, después de haber añadido
   barras invertidas antes de todos los caracteres que están presentes
   en la lista <code class="parameter">characters</code>.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.addcslashes-parameters">
  <h3 class="title">Parámetros</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">string</code></dt>
     <dd>
      <p class="para">
       El string a escapar.
      </p>
     </dd>
    
    
     <dt><code class="parameter">characters</code></dt>
     <dd>
      <p class="para">
       Una lista de caracteres a escapar. Si
       <code class="parameter">characters</code> contiene los caracteres
       <code class="literal">\n</code>, <code class="literal">\r</code> etc., serán
       convertidos al estilo del lenguaje C, mientras que otros
       caracteres no alfanuméricos con un código ASCII inferior
       a 26 y superior a 126 son reemplazados por su representación
       octal.
      </p>
      <p class="para">
       Al definir una secuencia de caracteres
       en el parámetro <code class="parameter">characters</code>, asegúrese
       de que conoce bien todos los caracteres que se encuentran entre
       los límites de los intervalos.
      <div class="example" id="example-1">
       <p><strong>Ejemplo #1 <span class="function"><strong>addcslashes()</strong></span> con rangos</strong></p>
        <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">// Muestra:  \f\o\o\[ \]<br />// Todas las mayúsculas y minúsculas serán escapadas<br />// ... pero también los caracteres [\]^_`<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
        </div>

       </div>
       Asimismo, si el primer carácter de un intervalo tiene un código ASCII
       mayor que el segundo, el intervalo no será creado.
       Solo los límites del intervalo y el carácter punto (.) serán
       escapados. Utilice la función <span class="function"><a href="function.ord.php" class="function">ord()</a></span> para
       encontrar el valor ASCII de un carácter.
      <div class="example" id="example-2">
       <p><strong>Ejemplo #2 <span class="function"><strong>addcslashes()</strong></span> con caracteres en el orden incorrecto</strong></p>
        <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">// Muestra:  \zoo['\.']<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
        </div>

       </div>
      </p>
      <p class="para">
       Tenga cuidado con el uso de caracteres como 0, a, b, f, n, r,
       t y v. Serán convertidos en \0, \a, \b, \f, \n, \r, \t y \v,
       todos siendo secuencias de escape en C. La mayoría de estas secuencias
       también están definidas en otros lenguajes derivados de C, incluyendo PHP,
       lo que significa que no se obtendrá el resultado esperado si se
       utiliza la salida de la función <span class="function"><strong>addcslashes()</strong></span>
       para generar código para estos lenguajes con los caracteres definidos
       en el parámetro <code class="parameter">characters</code>.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.addcslashes-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="para">
   Devuelve el string escapado.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.addcslashes-examples">
  <h3 class="title">Ejemplos</h3>
  <p class="para">
   <code class="parameter">characters</code> puede escribirse &quot;\0..\37&quot;, lo que
   identifica todos los caracteres ASCII cuyo código está entre
   0 y 37.
   <div class="example" id="example-3">
    <p><strong>Ejemplo #3 Ejemplo con <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 />$not_escaped </span><span style="color: #007700">= </span><span style="color: #DD0000">"PHP isThirty\nYears Old!\tYay to the Elephant!\n"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$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 />echo </span><span style="color: #0000BB">$escaped</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">Ver también</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.stripcslashes.php" class="function" rel="rdfs-seeAlso">stripcslashes()</a> - Decodifica un string codificado con addcslashes</span></li>
    <li><span class="function"><a href="function.stripslashes.php" class="function" rel="rdfs-seeAlso">stripslashes()</a> - Quita las barras de un string con comillas escapadas</span></li>
    <li><span class="function"><a href="function.addslashes.php" class="function" rel="rdfs-seeAlso">addslashes()</a> - A&ntilde;ade barras invertidas en un string</span></li>
    <li><span class="function"><a href="function.htmlspecialchars.php" class="function" rel="rdfs-seeAlso">htmlspecialchars()</a> - Convierte caracteres especiales en entidades HTML</span></li>
    <li><span class="function"><a href="function.quotemeta.php" class="function" rel="rdfs-seeAlso">quotemeta()</a> - Protege los metacaracteres</span></li>
   </ul>
  </p>
 </div>


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