Vlax-safearray-fill

引数

var : データタイプがセーフ配列の変数。
'element-values : 配列に格納する値のリスト。配列の要素と同数の変数を指定することができる。要素数よりも少ない値しか指定しなかった場合は、残りの要素は現在の値を保持する。多次元配列に対しての element-values 引数は、各リストが配列の次元数に一致した、リストのリストでなければならない。

(setq sa (vlax-make-safearray vlax-vbdouble '(0 . 2)))
#<safearray...>

vlax-safearray-fill 関数を使用して、配列に値を代入する。

(vlax-safearray-fill sa '(1 2 3))
#<safearray...>

配列の内容をリストにする。

(vlax-safearray->list sa)
(1.0 2.0 3.0)

vlax-safearray-fill 関数を使用して、配列の最初の要素を設定する。

(vlax-safearray-fill sa '(-66))
#<safearray...>

配列の内容をリストにする。

(vlax-safearray->list sa)
(-66.0 2.0 3.0)

配列の最初の要素だけが変更されたことに注意。残りの要素には影響がなく、以前それらに設定された値が保持されている。2 番目または 3 番目の要素を変更し、最初の要素はそのままにしておきたいときは、vlax-safearray-put-element 関数を使用する。

要素が 3 つしかない配列の 4 番目の要素を設定するように、vlax-safearray-fill 関数に命令する。

(vlax-safearray-fill sa '(1 2 3 4))
エラー: safearray-fill が失敗しました. 初期化リストが不正です.

配列の要素よりも多くの要素を指定すると、vlax-safearray-fill 関数はエラーを返す。

複数次元の配列に値を割り当てるには、vlax‑safearray-fill 関数に、次元に対応する各リストからなるリストを指定する。次のコマンドは、各次元に 3 要素を含む文字列の 2 次元配列を作成する。

(setq mat2 (vlax-make-safearray vlax-vbString '(0 . 1) '(1 . 3)))
#<safearray...>

vlax-safearray-fill 関数を使用して、配列に値を代入する。

(vlax-safearray-fill mat2 '(("a" "b" "c") ("d" "e" "f")))
#<safearray...>

mat2 の内容を確認するには、vlax‑safearray‑>list 関数を使用する。

(vlax-safearray->list mat2)
(("a" "b" "c") ("d" "e" "f"))