23.14.2
NVListのメソッド
CORBA::NamedValue_ptr
add
(
CORBA::Flags
flags
);
このメソッドは,フラグだけを初期化し,NamedValueオブジェクトをリストに追加します。追加されたオブジェクトの名前,またはオブジェクトの値は初期化されません。NamedValueの名前および値の属性を初期化するために,返されたポインタを使用できます。返された引数がポイントしているメモリを絶対に解放しないでください。
flags
NamedValueオブジェクトの用途を表すフラグ。このフラグは,ARG_IN,ARG_OUT,ARG_INOUTのどれかになります。
CORBA::NamedValue_ptr
add_item
(
const char *
name
, CORBA::Flags
flag
);
このメソッドは,オブジェクトのフラグまたは名前の属性を初期化して,NamedValueオブジェクトをリストに追加します。NamedValueの値の属性を初期化するために,返されたポインタを使用できます。
返された引数がポイントしているメモリを絶対に解放しないでください。
name
名前
flag
NamedValueオブジェクトの用途を表すフラグ。このフラグは,ARG_IN,ARG_OUT,ARG_INOUTのどれかになります。
NamedValue_ptr
add_item_consume
(
char *
nm
, CORBA::Flags
flag
);
nmが示すメモリの管理がNVListによって引き継がれるという点を除き,このメソッドはadd_itemメソッドと同じです。そのリストがすでにnmのコピーや解放をしている可能性があるので,このメソッドを呼び出したあとは,nmにアクセスできません。この項目を削除すると,自動的にそのメモリが解放されます。
このメソッドのリターン値のメモリを絶対に解放しないでください。
nm
名前
flag
NamedValueオブジェクトの用途を表すフラグ。このフラグは,ARG_IN,ARG_OUT,ARG_INOUTのどれかになります。
CORBA::NamedValue_ptr
add_value
(
const char *
name
,
const CORBA::Any *
value
,
CORBA::Flags
flag
);
このメソッドは,オブジェクトのフラグ,名前,および値を初期化して,リストにNamedValueを追加します。NamedValueオブジェクトを指すポインタが返されます。
返された引数がポイントしているメモリを絶対に解放しないでください。
name
名前
value
値
flag
NamedValueオブジェクトの用途を表すフラグ。このフラグは,ARG_IN,ARG_OUT,ARG_INOUTのどれかになります。
NamedValue_ptr
add_value_consume
(
char *
nm
,
CORBA::Any *
value
,
CORBA::Flags
flag
);
このメソッドは,nmまたはvalueが示すメモリの管理をNVListが引き継ぐという点を除き,add_valueメソッドと同じです。そのリストがすでにnmのコピーや解放をしている可能性があるので,このメソッドを呼び出したあとは,nmまたはvalueにアクセスできません。この項目を削除すると,自動的にそのメモリが解放されます。
nm
名前
value
値
flag
NamedValueオブジェクトの用途を表すフラグ。このフラグは,ARG_IN,ARG_OUT,ARG_INOUTのどれかになります。
CORBA::Long
count
() const;
このメソッドは,リスト内にあるNamedValueオブジェクトの数を返します。
static CORBA::Boolean
CORBA::is_nil
(
NVList_ptr
obj
);
指定されたNamedValueポインタがNULLの場合,このメソッドはTRUEを返します。
obj
チェックされるオブジェクトを指すポインタ
NamedValue_ptr
item
(
CORBA::Long
index
);
このメソッドは,指定されたインデックスを持つリストのNamedValueを返します。
返された引数がポイントしているメモリを絶対に解放しないでください。
index
NamedValueオブジェクトのインデックス。インデックスは0から始まります。
static void
CORBA::release
(
CORBA::NVList_ptr
obj
);
この静的メソッドは指定されたオブジェクトを解放します。
obj
解放されるオブジェクト
Status
remove
(
CORBA::Long
index
);
このメソッドは,指定されたインデックスにあるリストからNamedValueオブジェクトを削除します。add_item_consumeまたはadd_value_consumeメソッドを使用して追加されたリストの項目が格納されているメモリは,その項目が削除される前に解放されます。
index
NamedValueオブジェクトのインデックス。インデックスは0から始まります。
static CORBA::NVList_ptr
_duplicate
(
CORBA::NVList_ptr
ptr
);
この静的メソッドは,指定されたオブジェクトのリファレンスカウントを増やし,そのオブジェクトを指すポインタを返します。
ptr
複製されるオブジェクト
static CORBA::NVList_ptr
_nil
();
この静的メソッドは,NV_Listポインタの初期化に使用できるNULLポインタを返します。例を次に示します。
CORBA::NV_List_ptr p = CORBA::NVList::_nil();
static void
_release
(
CORBA::NVList *
ptr
);
この静的メソッドは,指定されたオブジェクトのリファレンスカウントを減らします。そのカウントが0になると,オブジェクトによって管理されていたすべてのメモリが解放され,そのオブジェクトが削除されます。
ptr
解放されるオブジェクト