(PHP 4, PHP 5, PHP 7)
addcslashes — String entre aspas com barras no estilo C
$str
, string $charlist
)
Retorna uma string com barras invertidas antes dos caracteres que
estão listados no parâmetro charlist.
strA string a receber escape.
charlist
Uma lista de caractere para receber escape. Se
charlist contém caracteres
\n, \r etc., eles são
convertidos na mesma forma que C, quando outros caracteres não-alfanumérico
com códigos ASCII menor que 32 e maior que 126 são convertido para
representação octal.
Quando você define uma seqüencia de caracteres no argumento charlist certifique-se que você sabe quais os caracteres que vêm dentro do intervalo que você definiu.
<?php
echo addcslashes('foo[ ]', 'A..z');
// output: \f\o\o\[ \]
// All upper and lower-case letters will be escaped
// ... but so will the [\]^_` and any tabs, line
// feeds, carriage returns, etc.
?>
<?php
echo addcslashes("zoo['.']", 'z..A');
// output: \zoo['\.']
?>
Tenha cuidado se você escolheu adicionar escape nos caracteres 0, a, b, f, n, r, t e v. Eles serão convertidos para \0, \a, \b, \f, \n, \r, \t e \v. No PHP \0 (NULL), \r (carriage return), \n (newline), \f (form feed), \v (vertical tab) e \t (tab) são pré-definidas seqüências de escape, quando em C todos esses são pré-definidas seqüências de escape.
Retorna a string com escapes.
| Versão | Descrição |
|---|---|
| 5.2.5 | As seqüências de escape \v e \f foram adicionadas. |
charlist como "\0..\37", que
adicionaria escape para todos caracteres com código ASCII entre 0 e 31.
Exemplo #1 Exemplo da addcslashes()
<?php
$escaped = addcslashes($not_escaped, "\0..\37!@\177..\377");
?>