オペレーションの引数や戻り値、コンテキストのプロパティを表現する擬似インタフェースです。動的起動インタフェース(DII)、動的スケルトンインタフェース(DSI)で使われます。

オペレーションの引数の属性、戻り値の属性、コンテキストのプロパティの属性を表現するクラスです。 CORBA::ORB::create_named_valueを使ってインスタンスを作成します。オペレーションの引数の属性には、名前、型、値、モード(in, out, inout)があります。

引数のモードには以下のものがあります。

引数のモード

CORBA::ARG_IN	in引数
CORBA::ARG_OUT	out引数
CORBA::ARG_INOUT	inout引数

オペレーションの戻り値の属性には、型、値があります。コンテキストプロパティの属性には、名前、値があります。

name	名前を得る
value	型と値を得る
flags	モードを得る
_duplicate	NamedValueの論理的コピーを作る
_nil	nil NamedValueを返す

関連項目

CORBA::ORB::create_named_value

オペレーションの引数やコンテキストのプロパティを表現するCORBA::NamedValueをリストにして管理するためのクラスです。CORBA::ORB::create_listを用いて新しいインスタンスを作成することができます。CORBA::NVListは、動的起動インタフェース(DII)や動的スケルトンインタフェース(DSI)で、オペレーションの引数リストやコンテキストのプロパティリストを表現するために使われます。

count	リストの数を得る
add	モードを指定した要素を追加する
add_item	名前とモードを指定した要素を追加する
add_value	名前と値とモードを指定した要素を追加する
item	n番目の要素を取り出す
add_item_consume	名前とモードを指定した要素を追加する/名前の領域の権利が渡る
add_value_consume	名前と値とモードを指定した要素を追加する/名前と値の領域の権利が渡る
remove	n番目の要素を削除する
_duplicate	NVListの論理的コピーを作る
_nil	nil NVListを返す

関連項目

CORBA::ORB::craete_list

名前

CORBA::NamedValue::name - 名前を得る

形式

#include <orb.h>

const char* CORBA::NamedValue::name(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

オペレーションの引数名やコンテキストのプロパティ名を取得することができます。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

名前を文字列で返します。

エラー

CORBA標準例外がthrowされます。

注意

戻り値を変更したり、削除してはいけません。

名前

CORBA::NamedValue::value - 引数の値を得る

形式

#include <orb.h>

CORBA::Any* CORBA::NamedValue::value(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

オペレーションの引数の値や戻り値、コンテキストプロパティの値を取得することができます。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

引数の値を返します。

エラー

CORBA標準例外がthrowされます。

注意

戻り値を削除してはいけません。戻り値が保持しているメモリ領域を解放する権利はNamedValueにあるので、必要ならばコピーしてください。

名前

CORBA::NamedValue::flags - 引数のモードを得る

形式

#include <orb.h>

CORBA::Flags CORBA::NamedValue::flags(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

オペレーションの引数のモードを取得することができます。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

引数のモードを返します。

エラー

CORBA標準例外がthrowされます。

名前

CORBA::NamedValue::_duplicate - NamedValueの論理的コピーを作る

形式

#include <orb.h>

static CORBA::NamedValue_ptr CORBA::NamedValue::_duplicate(
	CORBA::NamedValue_ptr nv,
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

引数nvの論理的コピーを作ります。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

引数nvの論理的コピーが返ります。

エラー

CORBA標準例外がthrowされます。

名前

CORBA::NamedValue::_nil - nil NamedValueを返す

形式

#include <orb.h>

static CORBA::NamedValue_ptr CORBA::NamedValue::_nil(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

nil NamedValueを返します。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

nil NamedValueが返ります。

エラー

CORBA標準例外がthrowされます。

名前

CORBA::NVList::count - リストの数を得る

形式

#include <orb.h>

CORBA::Long CORBA::NVList::count(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

リストの要素数を返します。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

リストの要素数が返ります。

エラー

CORBA標準例外がthrowされます。

名前

CORBA::NVList::add - モードを指定した要素を追加する

形式

#include <orb.h>

CORBA::NamedValue_ptr CORBA::NVList::add(
	CORBA::Flags flags,
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

要素を新たに１つ作成し、リストに追加します。このとき、新たに作られたCORBA::NamedValueインスタンスのモード属性にflagsがセットされます。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

生成したNamedValueを返します。

エラー

CORBA標準例外がthrowされます。

注意

戻り値は削除してはいけません。

名前

CORBA::NVList::add_item - 名前とモードを指定した要素を追加する

形式

#include <orb.h>

CORBA::NamedValue_ptr CORBA::NVList::add_item(
	const char* name,
	CORBA::Flags flags,
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

要素を新たに１つ作成し、リストに追加します。このとき、新たに作られたCORBA::NamedValueインスタンスの名前属性にnameが、モード属性にflagsがセットされます。

nameの値はコピーされます。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

生成したNamedValueを返します。

エラー

CORBA標準例外がthrowされます。

注意

戻り値は削除してはいけません。

名前

CORBA::NVList::add_value - 名前と値とモードを指定した要素を追加する

形式

#include <orb.h>

CORBA::NamedValue_ptr CORBA::NVList::add_value(
	const char* name,
	const CORBA::Any& value,
	CORBA::Flags flags,
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

要素を新たに１つ作成し、リストに追加します。このとき、新たに作られたCORBA::NamedValueインスタンスの名前属性にnameが、型と値の属性にvalueが、モード属性にflagsがセットされます。

nameとvalueの値はコピーされます。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

生成したNamedValueを返します。

エラー

CORBA標準例外がthrowされます。

注意

戻り値は削除してはいけません。

名前

CORBA::NVList::item - n番目の要素を取り出す

形式

#include <orb.h>

CORBA::NamedValue_ptr CORBA::NVList::item(
	CORBA::Long n,
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

このリストのn番目の要素を取り出します。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

n番目の引数情報が返ります。

エラー

CORBA標準例外がthrowされます。

注意

戻り値は削除してはいけません。

名前

CORBA::NVList::add_item_consume

- 名前とモードを指定した要素を追加する。名前の領域の権利が渡る。

形式

#include <orb.h>

CORBA::NamedValue_ptr CORBA::NVList::add_item_consume(
	char* name,
	CORBA::Flags flags,
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

要素を新たに１つ作成し、リストに追加します。このとき、新たに作られたCORBA::NamedValueインスタンスの名前属性にnameが、モード属性にflagsがセットされます。

nameのメモリ領域を解放する権利は生成されたNamedValueに渡ります。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

生成したNamedValueを返します。

エラー

CORBA標準例外がthrowされます。

注意

戻り値は削除してはいけません。

名前

CORBA::NVList::add_value_consume

- 名前と値とモードを指定した要素を追加する。名前と値の領域の権利が渡る。

形式

#include <orb.h>

CORBA::NamedValue_ptr CORBA::NVList::add_value_consume(
	char* name,
	CORBA::Any* value,
	CORBA::Flags flags,
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

要素を新たに１つ作成し、リストに追加します。このとき、新たに作られたCORBA::NamedValueインスタンスの名前属性にnameが、型と値の属性にvalueが、モード属性にflagsがセットされます。

nameとvalueのメモリ領域を解放する権利は生成されたNamedValueに渡ります。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

生成したNamedValueを返します。

エラー

CORBA標準例外がthrowされます。

注意

戻り値は削除してはいけません。

名前

CORBA::NVList::remove - n番目の要素を削除する

形式

#include <orb.h>

CORBA::Status CORBA::NVList::remove(
	CORBA::Long n,
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

このリストのn番目の要素を削除します。削除した要素の後ろにあった要素は前につめられます。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

処理が正常終了したときには、CORBA::Status_Successが返ります。異常終了したときは、CORBA::Status_Failedが返ります。

エラー

戻り値として、CORBA::Status_Failedが返ります。また、CORBA標準例外がthrowされます。

名前

CORBA::NVList::_duplicate - NVListの論理的コピーを作る

形式

#include <orb.h>

static CORBA::NVList_ptr CORBA::NVList::_duplicate(
	CORBA::NVList_ptr nv,
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

引数nvの論理的コピーを作ります。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

引数nvの論理的コピーが返ります。

エラー

CORBA標準例外がthrowされます。

名前

CORBA::NVList::_nil - nil NVListを返す

形式

#include <orb.h>

static CORBA::NVList_ptr CORBA::NVList::_nil(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

nil NVListを返します。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

nil NVListが返ります。

エラー

CORBA標準例外がthrowされます。