NVList (Java Platform SE 6)

org.omg.CORBA.ORB.create_list
```
    org.omg.CORBA.NVList nv = orb.create_list(3);
 
```
変数 nv は新たに作成された NVList オブジェクトを表す。引数は ORB に対するメモリー管理ヒントであり、リストの実際の長さを示すものではない。たとえば、要求に NVList オブジェクトを使用し、呼び出されるメソッドが 3 つのパラメータを取る場合、create_list メソッドに 3 を指定して最適化できる。新しい NVList は必ずしも長さ 3 ではなく、たとえば、長さが 2 または 4 の場合がある。元の長さに関係なく、このリストに任意の数の NamedValue オブジェクトを追加することも可能
org.omg.CORBA.ORB.create_operation_list
```
    org.omg.CORBA.NVList nv = orb.create_operation_list(myOperationDef);
 
```
変数 nv は、指定された OperationDef オブジェクトで記述されるメソッドの引数記述を格納している、新しく生成された NVList オブジェクトを表す

NVList クラスのメソッドはすべて、リスト内の NamedValue オブジェクトを処理します。NamedValue オブジェクトの追加用メソッドには、リスト内の NamedValue オブジェクトの数を取得するメソッド、指定したインデックスの NamedValue オブジェクトを取得するメソッド、および指定したインデックスの NamedValue オブジェクトを削除するメソッド、の 3 つがあります。

導入されたバージョン:: JDK1.2
関連項目:: Request, ServerRequest, NamedValue, Context

コンストラクタの概要
`NVList()`

メソッドの概要
`abstract NamedValue`	`add_item(String item_name, int flags)` 指定された名前とフラグで初期化された新しい `NamedValue` オブジェクトを作成し、それをこの `NVList` オブジェクトの末尾に追加します。
`abstract NamedValue`	`add_value(String item_name, Any val, int flags)` 指定された名前、値、およびフラグで初期化された新しい `NamedValue` オブジェクトを作成し、それをこの `NVList` オブジェクトの末尾に追加します。
`abstract NamedValue`	`add(int flags)` 指定されたフラグで初期化された `NamedValue` オブジェクトを新規作成し、それをこの `NVList` オブジェクトの末尾に追加します。
`abstract int`	`count()` この `NVList` オブジェクトに追加された `NamedValue` オブジェクトの数を返します。
`abstract NamedValue`	`item(int index)` 指定されたインデックスでの `NamedValue` を取得します。
`abstract void`	`remove(int index)` 指定されたインデックスでの `NamedValue` を削除します。

クラス java.lang.Object から継承されたメソッド
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

コンストラクタの詳細

NVList

public NVList()

メソッドの詳細

count

public abstract int count()

この NVList オブジェクトに追加された NamedValue オブジェクトの数を返します。

戻り値:: この NVList 内の NamedValue オブジェクトの数を示す int

add

public abstract NamedValue add(int flags)

指定されたフラグで初期化された NamedValue オブジェクトを新規作成し、それをこの NVList オブジェクトの末尾に追加します。フラグには、引数引き渡しモード ARG_IN.value、ARG_OUT.value、ARG_INOUT.value のいずれかを指定できます。

パラメータ:: flags - 引数モードフラグのいずれか
戻り値:: 新しく生成された NamedValue オブジェクト

add_item

public abstract NamedValue add_item(String item_name,
                                    int flags)

指定された名前とフラグで初期化された新しい NamedValue オブジェクトを作成し、それをこの NVList オブジェクトの末尾に追加します。フラグには、引数引き渡しモード ARG_IN.value、ARG_OUT.value、ARG_INOUT.value のいずれかを指定できます。

パラメータ:: item_name - 新しい NamedValue オブジェクトの名前; flags - 引数モードフラグのいずれか
戻り値:: 新しく生成された NamedValue オブジェクト

add_value

public abstract NamedValue add_value(String item_name,
                                     Any val,
                                     int flags)

指定された名前、値、およびフラグで初期化された新しい NamedValue オブジェクトを作成し、それをこの NVList オブジェクトの末尾に追加します。

パラメータ:: item_name - 新しい NamedValue オブジェクトの名前; val - 新しい NamedValue オブジェクトの値を含む Any オブジェクト; flags - 引数引き渡しモード ARG_IN.value、ARG_OUT.value、または ARG_INOUT.value のいずれか
戻り値:: 新しく作成された NamedValue オブジェクト

item

public abstract NamedValue item(int index)
                         throws Bounds

指定されたインデックスでの NamedValue を取得します。

パラメータ:: index - 対象の NamedValue オブジェクトのインデックス。インデックスは、0 から (リストの長さ - 1) までの値にする必要がある。最初の項目のインデックスは 0 になる
戻り値:: 指定されたインデックスでの NamedValue
例外:: Bounds - インデックスが NamedValue オブジェクトの数と等しいか、それよりも大きい場合

remove

public abstract void remove(int index)
                     throws Bounds

指定されたインデックスでの NamedValue を削除します。削除された NamedValue オブジェクト以降のすべてのインデックスが 1 だけ減少します。

パラメータ:: index - 削除される NamedValue オブジェクトのインデックス。インデックスは、0 から (リストの長さ - 1) までの値にする必要がある。最初の項目のインデックスは 0 になる
例外:: Bounds - インデックスがリスト内の NamedValue オブジェクトの数と等しいか、それよりも大きい場合