3.29.2 addPropValsプロパティ値(列)の追加

<この項の構成>
(1) 機能
(2) 形式
(3) 引数
(4) 戻り値
(5) 例外

(1) 機能

可変長配列オブジェクトに,指定したリストの値をコピーして追加します。指定したプロパティ名がすでに存在していた場合は,そのプロパティの値を,指定したリストの値で上書きします。

指定したリストの要素が可変長配列の要素に対して不足していた場合は,リストの最後の要素が可変長配列オブジェクトの不足分に設定されます。

可変長配列オブジェクトが空の場合に限り,空のプロパティ値を追加できます。

メタプロパティは変更されません。

(2) 形式

void addPropVals(
    String     propName,
    List       vals
)

(3) 引数

propName(入力)
プロパティ名を指定します。
vals(入力)
プロパティ値のListインターフェース(要素は可変長配列の各要素のプロパティ値)を指定します。

(4) 戻り値

なし

(5) 例外

IllegalArgumentException
可変長配列要素が空でないのに空リストを指定した場合
NullPointerException
引数propNameにnullを指定した場合