addcslashes

PHP マニュアル
前のページ		次のページ

説明

string addcslashes ( string str, string charlist )

charlistパラメータに羅列された文字の前にバックスラッシュを付けた文字列を返します。もし charlist が \n, \r 等の文字を含んでいる場合、 C言語と同様の手法によりエスケープされます。アスキーコードが32未満または126より大きい文字は、8進表現に変換されます。

エスケープ文字を0, a, b, f, n, r, t , vとする場合には注意してください。これらは、\0, \a, \b, \f, \n, \r, \t , \v に変換されます。PHPでは、 \0 (NULL), \r (復改文字), \n (改行文字) , \t (タブ)が定義済みのエスケープシーケンスですが、C言語では、これら全てが定義済みのエスケープシーケンスです。

"\0..\37" のようにcharlistに範囲を指定可能です。この場合、アスキーコードが 0 から 31 の範囲の文字は全てエスケープされます。

例 1. addcslashes() の例


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

charlist引数の文字の列びを定義する際には、範囲の最初と最後で指定する文字集合に含まれる文字の種類を把握するようにしてください。


<?php
echo addcslashes('foo[ ]', 'A..z');
// 全ての大文字と小文字はエスケープされます。
// ... しかし、[\]^_` とタブ、改行、復改文字等もエスケープされてしまいます。
?>

また、ある範囲を指定する最初の文字がその範囲の2番目の文字よりも大きな ASCII値を有している場合、範囲は定義されません。最初と最後の文字とピリオド文字のみがエスケープされます。ある文字のASCII値を見つけるには、ord() 関数を使用してください。


<?php
echo addcslashes("zoo['.']", 'z..A');
// 出力:  \zoo['\.']
?>

stripcslashes(), stripslashes(), addslashes(), htmlspecialchars(), quotemeta() も参照ください。

前のページ	ホーム	次のページ
Strings(文字列関数)	上に戻る	addslashes