>PHP: addcslashes

addcslashes

(PHP 4, PHP 5)

addcslashes -- Escapa una cadena de la misma forma que lo hace C

DescripciÃ³n

string addcslashes ( string cadena, string lista_caracteres )

Devuelve una cadena con barras invertidas antes de los caracteres definidos en el parÃ¡metro lista_caracteres. Si lista_caracteres contiene caracteres como \n, \r, etc. tambiÃ©n se convierten de la misma forma, mientras que los caracteres con cÃ³dico ASCII inferior a 32 y superior a 126 son convertidos a representaciÃ³n octal.

Se debe tener en cuenta que si se marcan para escapar los caracteres 0, a, b, f, n, r, t y v, se transforman en los caracteres especiales \0, \a, \b, \f, \n, \r, \t y \v. En PHP \0 (NULL), \r (retorno de carro), \n (nueva lÃnea) y \t (tabulador) son secuencias de escape predefinidas, mientras que en C todos los caracteres especiales mencionados anteriormente son secuencias de escape predefinidas.

El parÃ¡metro lista_caracteres puede indicar rangos como por ejemplo "\0..\37", que escaparÃa todos los caracteres con cÃ³digo ASCII entre 0 y 31.
Ejemplo 1. Ejemplo de addcslashes()

<?php $escapado = addcslashes($no_escapado, "\0..\37!@\177..\377"); ?>

Al definir secuencias de caracteres en el parÃ¡metro lista_caracteres se debe asegurar que se quieren escapar todos los caracteres incluidos en el rango.


<?php

echo addcslashes('prueba[ ]', 'A..z');

// La salida seria:  \p\r\u\e\b\a\[ \]

// Se escapan todos los caracteres en mayusculas y minusculas

// ... pero tambien los caracteres [\]^_` , los tabuladores, los retornos 

// de carro, las nuevas lineas, etc.

?>

AdemÃ¡s, si el primer carÃ¡cter del rango tiene un valor ASCII superior al segundo carÃ¡cter que define el rango, no se puede formar el rango. En otras palabras, no se pueden definir rangos descendentes y por tanto solo se escaparÃ¡n el primer carÃ¡cter del rango, el segundo y los puntos que separan a los caracteres. Para obtener el valor ASCII de un carÃ¡cter, se puede emplear la funciÃ³n ord().


<?php

echo addcslashes("zoo['.']", 'z..A');

// La salida seria:  \zoo['\.']

?>

Vea tambiÃ©n stripcslashes(), stripslashes(), htmlspecialchars() y quotemeta().

add a note User Contributed Notes
addcslashes

phpcoder at cyberpimp dot pimpdomain dot com
20-Jan-2005 12:35


Forgot to add something:

The only time you would likely use addcslashes() without specifying the backslash (\) character in charlist is when you are VALIDATING (not encoding!) a data string.



(Validation ensures that all control characters and other unsafe characters are correctly encoded / escaped, but does not alter any pre-existing escape sequences.)



You can validate a data string multiple times without fear of "double encoding".  A single decoding pass will return the original data, regardless of how many times it was validated.)

phpcoder at cyberpimp dot pimpdomain dot com
19-Jan-2005 11:02


If you are using addcslashes() to encode text which is to later be decoded back to it's original form, you MUST specify the backslash (\) character in charlist!



Example:



<?php

  $originaltext = 'This text does NOT contain \\n a new-line!';

  $encoded = addcslashes($originaltext, '\\');

  $decoded = stripcslashes($encoded);

  //$decoded now contains a copy of $originaltext with perfect integrity

  echo $decoded; //Display the sentence with it's literal \n intact

?>



If the '\\' was not specified in addcslashes(), any literal \n (or other C-style special character) sequences in $originaltext would pass through un-encoded, but then be decoded into control characters by stripcslashes() and the data would lose it's integrity through the encode-decode transaction.

ruben at intesys dot it
31-May-2004 09:51


jsAddSlashes for XHTML documents:



<?php

header("Content-type: text/xml");



print <<<EOF

<?xml version="1.0"?>

<html>

<head>

<script type="text/javascript">



EOF;



function jsAddSlashes($str) {

    $pattern = array(

        "/\\\\/"  , "/\n/"    , "/\r/"    , "/\"/"    ,

        "/\'/"    , "/&/"     , "/</"     , "/>/"

    );

    $replace = array(

        "\\\\\\\\", "\\n"     , "\\r"     , "\\\""    ,

        "\\'"     , "\\x26"   , "\\x3C"   , "\\x3E"

    );

    return preg_replace($pattern, $replace, $str);

}



$message = jsAddSlashes("\"<Hello>\",\r\n'&World'\\!");



print <<<EOF

alert("$message");

</script>

</head>

<body>

<h1>Hello, World!</h1>

</body>

</html>



EOF;

?>

21-Sep-2003 11:44


<?

function jsaddslashes($s)

{

 $o="";

 $l=strlen($s);

 for($i=0;$i<$l;$i++)

 {

  $c=$s[$i];

  switch($c)

  {

   case '<': $o.='\\x3C'; break;

   case '>': $o.='\\x3E'; break;

   case '\'': $o.='\\\''; break;

   case '\\': $o.='\\\\'; break;

   case '"':  $o.='\\"'; break;

   case "\n": $o.='\\n'; break;

   case "\r": $o.='\\r'; break;

   default:

   $o.=$c;

  }

 }

 return $o;

}



?>

<script language="javascript">

document.write("<? echo jsaddslashes('<h1 style="color:red">hello</h1>'); ?>");

</script>



output :



<script language="javascript">

document.write("\x3Ch1 style=\"color:red\"\x3Ehello\x3C/h1\x3E");

</script>

natNOSPAM at noworrie dot NO_SPAM dot com
17-May-2002 04:22


I have found the following to be much more appropriate code example:





<?php


$escaped = addcslashes($not_escaped, "\0..\37!@\@\177..\377");


?>





This will protect original, innocent backslashes from stripcslashes.

add a note

MANUAL DE PHP

windsurf mercedes camper

addcslashes

DescripciÃ³n