「Vl-registry-write」の版間の差分

2022年6月23日 (木) 08:39時点における最新版

AutoLISP Home - AutoLISP 目次 - DCL - AutoLisp関数互換表 - CAD&CGブログ - オンラインショップ- GizmoTools ヘルプセンター

構文: (vl-registry-write reg-key [val-name val-data])

機能: Windows レジストリにキーを作成する。; val-name 引数を省略するか nil を指定した場合、キーに対する既定値が書き出される。; val-name 引数を指定し、val-data 引数を指定しなかった場合、空の文字列が書き出される。

BricsCAD V22から

(vl-registry-write) は、QWord, Binary, MultiString データもサポートしている。

QWord : 12036354033952110 や -59036354033952110 のような、64 ビットまでの整数値を受け取る。
バイナリ: 以下のフォーマットでリストを扱う．

(3 0 16 35 69 0 16 35 70 0 16 35 71 0 16 35 72)
最初のエントリ 3 は、それ以降のエントリが整数型 (範囲 0 ～ 255) であることを指定する。

MultiString : 以下の書式でリストを受け付ける。

(7 "hello" "この文字列の中に複数の行があるよ" "%USERPROFILE%" "%APPDATA%" "should be" "an array of" "eight single" "strings")
最初のエントリ 7 は、この文字列の配列を指定する。
最初のエントリ 7 は、後続のリストエントリが文字列型であることを指定する (空の文字列を含むことができる)。

引数

reg-key : Windows レジストリキーを指定する文字列。

注： HKEY_USERS または KEY_LOCAL_MACHINE に対して vl-registry-write 関数を使用することはできない。

val-name : レジストリ項目の値を含んだ文字列。
val-data : レジストリデータを含んだ文字列。

戻り値: 成功した場合、vl-registry-write 関数は val-data を返します。それ以外の場合は nil。

サンプル

(vl-registry-write "HKEY_CURRENT_USER¥¥Test" "" "test data") 
"test data" 
(vl-registry-read "HKEY_CURRENT_USER¥¥Test") 
"test data"

@@ 1行目: / 1行目: @@
+{{AutoLISP}}
 ; 構文
 : (vl-registry-write ''reg-key'' [''val-name'' ''val-data''])
@@ 7行目: / 8行目: @@
 : val-name 引数を省略するか nil を指定した場合、キーに対する既定値が書き出される。
 : val-name 引数を指定し、val-data 引数を指定しなかった場合、空の文字列が書き出される。
+; BricsCAD V22から
+: (vl-registry-write) は、QWord, Binary, MultiString データもサポートしている。
+:* QWord : 12036354033952110 や -59036354033952110 のような、64 ビットまでの整数値を受け取る。
+:* バイナリ: 以下のフォーマットでリストを扱う．
+ (3 0 16 35 69 0 16 35 70 0 16 35 71 0 16 35 72)
+ 最初のエントリ 3 は、それ以降のエントリが整数型 (範囲 0 ～ 255) であることを指定する。
+:* MultiString : 以下の書式でリストを受け付ける。
+ (7 "hello" "この文字列の中に複数の行があるよ" "%USERPROFILE%" "%APPDATA%" "should be" "an array of" "eight single" "strings")
+ 最初のエントリ 7 は、この文字列の配列を指定する。
+ 最初のエントリ 7 は、後続のリストエントリが文字列型であることを指定する (空の文字列を含むことができる)。
 ; 引数
 :* reg-key : Windows レジストリ キーを指定する文字列。
-;:: '''注''' HKEY_USERS または KEY_LOCAL_MACHINE に対して vl-registry-write 関数を使用することはできない。
+;:: '''注：''' HKEY_USERS または KEY_LOCAL_MACHINE に対して vl-registry-write 関数を使用することはできない。
 ;
 :* val-name : レジストリ項目の値を含んだ文字列。
 :* val-data : レジストリ データを含んだ文字列。
 ; 戻り値
 : 成功した場合、vl-registry-write 関数は val-data を返します。 それ以外の場合は nil。
 ; サンプル
-: (vl-registry-write "HKEY_CURRENT_USER¥¥Test" "" "test data")
+<pre class="brush:autolisp;">
-: '''"test data"'''
+(vl-registry-write "HKEY_CURRENT_USER¥¥Test" "" "test data")
-: (vl-registry-read "HKEY_CURRENT_USER¥¥Test")
+"test data"
-: "test data"
+(vl-registry-read "HKEY_CURRENT_USER¥¥Test")
+"test data"
+</pre>
 -----