mcrypt_get_iv_size
(PHP 4 >= 4.0.2, PHP 5)
mcrypt_get_iv_size — 指定した暗号/モードの組み合わせに属する IV の大きさを返す
説明
int mcrypt_get_iv_size
( string
$cipher
, string $mode
)
指定した cipher/mode
の組み合わせにおける IV の大きさを取得します。
mcrypt_enc_get_iv_size() 関数を使用するほうが より有用です。これは mcrypt_module_open() が返すリソースを使用します。
パラメータ
-
cipher -
MCRYPT_暗号名定数のいずれか、 あるいはアルゴリズム名をあらわす文字列。 -
mode -
定数
MCRYPT_MODE_モード名、あるいは文字列 "ecb", "cbc", "cfb", "ofb", "nofb" ,"stream" のいずれか。ECB モードでは IV は要求されないため、IV は無視されます。 暗号化と復号の際には、同じ IV(開始位置)を必要とします。さもないと 暗号化処理は失敗します。
返り値
初期化ベクトル(IV)の大きさをバイト数で返します。
エラーの際には FALSE を返します。IV
が指定した暗号/モードで無視される場合には、ゼロを返します。
例
例1 mcrypt_get_iv_size() の例
<?php
echo mcrypt_get_iv_size(MCRYPT_CAST_256, MCRYPT_MODE_CFB) . "\n";
echo mcrypt_get_iv_size('des', 'ecb') . "\n";
?>
参考
- mcrypt_get_block_size() - 指定した暗号のブロックサイズを得る
- mcrypt_enc_get_iv_size() - オープンされたアルゴリズムの IV の大きさを返す
- mcrypt_create_iv() - 乱数ソースから初期化ベクトル(IV)を生成する