QuickHashIntHash::add

(PECL quickhash >= Unknown)

QuickHashIntHash::add — 新たなエントリをハッシュに追加する

説明

public bool QuickHashIntHash::add ( int $key [, int $value ] )

このメソッドは、新たなエントリをハッシュに追加して追加に成功したかどうかを返します。ハッシュの作成時に QuickHashIntHash::CHECK_FOR_DUPES を渡さない限り、エントリの追加はデフォルトで常に成功します。

パラメータ

key: 追加するエントリのキー。
value: 追加するエントリの値 (オプション)。値を省略した場合は 1 を追加します。

返り値

エントリが追加された場合に TRUE、追加されなかった場合に FALSE を返します。

例

例1 QuickHashIntHash::add() の例


<?php
echo "重複チェックなしの場合\n";
$hash = new QuickHashIntHash( 1024 );
var_dump( $hash->exists( 4 ) );
var_dump( $hash->get( 4 ) );
var_dump( $hash->add( 4, 22 ) );
var_dump( $hash->exists( 4 ) );
var_dump( $hash->get( 4 ) );
var_dump( $hash->add( 4, 12 ) );

echo "\n重複チェックありの場合\n";
$hash = new QuickHashIntHash( 1024, QuickHashIntHash::CHECK_FOR_DUPES );
var_dump( $hash->exists( 4 ) );
var_dump( $hash->get( 4 ) );
var_dump( $hash->add( 4, 78 ) );
var_dump( $hash->exists( 4 ) );
var_dump( $hash->get( 4 ) );
var_dump( $hash->add( 4, 9 ) );

echo "\nデフォルト値\n";
var_dump( $hash->add( 5 ) );
var_dump( $hash->get( 5 ) );
?>

上の例の出力は、たとえば以下のようになります。

重複チェックなしの場合
bool(false)
bool(false)
bool(true)
bool(true)
int(22)
bool(true)

重複チェックありの場合
bool(false)
bool(false)
bool(true)
bool(true)
int(78)
bool(false)

デフォルト値
bool(true)
int(1)