QuickHashIntStringHash::set

(PECL quickhash >= Unknown)

QuickHashIntStringHash::set — ハッシュ内のエントリの値を更新 (エントリが存在しない場合は新しく追加) する

説明

public QuickHashIntStringHash::set ( int $key , string $value ) : int

このメソッドは、エントリを新しい値で更新します。エントリが存在しない場合は新しく追加します。エントリを追加したのか更新したのかを返します。重複するキーがあった場合は、最初に見つかった要素の値だけを更新します。ハッシュの作成時に QuickHashIntStringHash::CHECK_FOR_DUPES を使えば、ハッシュ内でのキーの重複を回避できます。

パラメータ

key: 追加あるいは更新するエントリのキー。
value: エントリに新しく設定する値。文字列以外を渡したときは、狩野であれば自動的に文字列に変換します。

返り値

エントリが見つかって更新できたときに 2、エントリを新しく追加したときに 1、エラーが発生したときに 0 を返します。

例

例1 QuickHashIntStringHash::set() の例


<?php
$hash = new QuickHashIntStringHash( 1024 );

echo "Set->Add\n";
var_dump( $hash->get( 46692 ) );
var_dump( $hash->set( 46692, "sixteen thousand ninety one" ) );
var_dump( $hash->get( 46692 ) );

echo "Set->Update\n";
var_dump( $hash->set( 46692, "twenty nine thousand nine hundred six" ) );
var_dump( $hash->get( 46692 ) );
?>

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

Set->Add
bool(false)
int(2)
string(27) "sixteen thousand ninety one"
Set->Update
int(1)
string(37) "twenty nine thousand nine hundred six"