CRBMultiMap::FindFirstWithKey

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

指定されたキーを持つ最初の要素の位置を探します。

POSITION FindFirstWithKey(
   KINARGTYPE key 
) const throw( );

パラメータ

key
検索する要素を識別するキー。

戻り値

キーが見つかった場合は、キーと値の組み合わせ要素の POSITION を返します。それ以外の場合は、NULL を返します。

解説

CRBMultiMap のキーには、1 つ以上の値を関連付けることができます。このメソッドを使用すると、特定のキーに関連付けられた 1 番目の値 (値が 1 つしかない場合もある) の位置の値を取得できます。位置の戻り値を CRBMultiMap::GetNextValueWithKey または CRBMultiMap::GetNextWithKey で使用すると、値の取得および位置の更新を行うことができます。

ほかの使用可能なメソッドについては、CRBTree 基本クラスに関するドキュメントを参照してください。