set
void set( string $key, mixed $val [, int $length = 0] )
Rampart インスタンスの連想配列に、
キーと値のペアをセットします。
引数
$key は、セットするデータのキーです。
$val は、セットするデータの値です。
$length に 1 以上の値を指定すると、
セットされるデータの値はその文字数以下にカットされます。
省略すると、文字数のカットは行われません。
内部処理
setTrimFlag メソッドで true が設定されている場合、
$val に trim が適用されます。
$val の改行コードを統一します。
$val のヌルバイトを除去します。
$val の文字コードを
setEncoding メソッドで指定したものに変換します。
setDoubleByteKanaFlag メソッドで true が設定されている場合、
$val の半角カタカナを全角カタカナに変換します。
mb_check_encoding で
$val の文字コードの有効性をチェックします。
チェックの結果、無効な文字コードであると判断された場合は、
$val = '' （カラ文字列）となりますのでご注意ください。
$length が 1 以上で指定されている場合は、
$val = mb_substr($val, 0, $length);
が実行されます。