addcslashes

(PHP 4, PHP 5)

addcslashes — Экранирует спецсимволы в стиле языка C

Описание

string addcslashes ( string $str , string $charlist )

Возвращает сроку str , в которой перед каждым символом из перечисленных в charlist символов добавлен обратный слэш (\). Экранируются \n, \r и т.д. в стиле языка C, символы с ASCII менее 32 и более 126 преобразуются в восьмеричное представление.

Будьте внимательны при экранировании символв 0, a, b, f, n, r, t и v. Они будут преобразованы в \0, \a, \b, \f, \n, \r, \t и \v. В C все они являются предопреденными escape-последовательностями, в то время как в PHP только \0 (NULL), \r (возврат каретки), \n (перевод строки) и \t (табуляция).

При передаче charlist вида "\0..\37" будут экранированы символы с ASCII кодами от 0 до 37.

Пример #1 Пример использования addcslashes()

<?php
$escaped 
addcslashes($not_escaped"\0..\37!@\177..\377");
?>

Следует быть внимательным при указании диапазона символов в аргументе charlist. Проверяйте, какие символы входят в этот диапазон.

<?php
echo addcslashes('foo[ ]''A..z');
// выводит:  \f\o\o\[ \]
// Будут экранированы заглавные и строчные английские буквы
// ... а также [\]^_`  а также табуляция,
// возврат каретки, перевод строки и т.д.
?>
Также, если ASCII код первого символа диапозона больше, чем последнего, диапазон не будет создан. Вместо этого будут экранироваться только первый и последний символы и точка. Для определения ASCII кода символов используйте функцию ord().
<?php
echo addcslashes("zoo['.']"'z..A');
// выводит:  \zoo['\.']
?>

См. также описание функций stripcslashes(), stripslashes(), htmlspecialchars() и quotemeta().

Коментарии

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.
2002-05-17 19:22:37
http://php5.kiev.ua/manual/ru/function.addcslashes.html
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.
2005-01-20 01:02:17
http://php5.kiev.ua/manual/ru/function.addcslashes.html
addcslashes() treats NUL as a string terminator:

   assert("any"  === addcslashes("any\0body", "-"));

unless you order it backslashified:

   assert("any\\000body" === addcslashes("any\0body", "\0"));

(Uncertain whether this should be declared a bug or simply that addcslashes() is not binary-safe, whatever that means.)
2007-11-12 17:16:08
http://php5.kiev.ua/manual/ru/function.addcslashes.html

    Поддержать сайт на родительском проекте КГБ