Ruby 1.9.2 リファレンスマニュアル > ライブラリ一覧 > win32/registryライブラリ > Win32::Registryクラス

class Win32::Registry

クラスの継承リスト: Win32::Registry < Enumerable < Win32::Registry::Constants < Object < Kernel < BasicObject

要約

特異メソッド

定義 説明
create(key, subkey, desired = KEY_ALL_ACCESS, opt = REG_OPTION_RESERVED)
create(key, subkey, desired = KEY_ALL_ACCESS, opt = REG_OPTION_RESERVED) {|reg| ... }

レジストリキー key 下にキー subkey を作成し, 開いたキーを表す Win32::Registry オブジェクトを返します。 key は親のキーを Win32::Registry オブジェクトで指定します。 親のキーには定義済キー HKEY_* を使用できます (⇒Win32::Registry::Constants)

expand_environ(str)

str の %\w+% という並びを環境変数に置換します。 REG_EXPAND_SZ で用いられます。

new(key, subkey, desired = KEY_READ, opt = REG_OPTION_RESERVED)
new(key, subkey, desired = KEY_READ, opt = REG_OPTION_RESERVED) {|reg| ... }
open(key, subkey, desired = KEY_READ, opt = REG_OPTION_RESERVED)
open(key, subkey, desired = KEY_READ, opt = REG_OPTION_RESERVED) {|reg| ... }

レジストリキー key 下のキー subkey を開き, 開いたキーを表す Win32::Registry オブジェクトを返します。 key は親のキーを Win32::Registry オブジェクトで指定します。 親のキーには定義済キー HKEY_* を使用できます (⇒Win32::Registry::Constants)

time2wtime(time)

Time オブジェクトまたは Integer オブジェクトを受け取り, 64bit の FILETIME に変換します。

type2name(type)

レジストリ値の型を整数から可読文字列に変換します。

wtime2time(wtime)

64bit の FILETIME を Time オブジェクトに変換します。

インスタンスメソッド

定義 説明
self[name, wtype = nil]

レジストリ値 name に value を書き込みます。

self[name, rtype] = value = nil
_dump
close

開かれているキーを閉じます。

create(subkey, desired = KEY_ALL_ACCESS, opt = REG_OPTION_RESERVED)

Win32::Registry.create(self, subkey, desired, opt) と同じです。

created?

キーが新しく作成された場合,真を返します。 (⇒Win32::Registry.create)

delete(name)
delete_value(name)

レジストリ値 name を削除します。 (標準) レジストリ値を削除することはできません。

delete_key(name, recursive = false)

サブキー name とそのキーが持つすべての値を削除します。

num_keys
max_key_length
num_values
max_value_name_length
max_value_length
descriptor_length
wtime

キー情報の個々の値を返します。

disposition

キーの disposition 値を返します。 (REG_CREATED_NEW_KEY または REG_OPENED_EXISTING_KEY)

each {|name, type, value| ... }
each_value {|name, type, value| ... }

キーが持つレジストリ値を列挙します。

each_key {|subkey, wtime| ... }

キーのサブキーを列挙します。

flush

キーの全てのデータをレジストリファイルに書き込みます。

hkey
info

キー情報を以下の値の配列で返します:

  • num_keys サブキーの個数
  • max_key_length サブキー名の最大長
  • num_values 値の個数
  • max_value_name_length 値の名前の最大長
  • max_value_length 値の最大長
  • descriptor_length セキュリティ記述子の長さ
  • wtime 最終更新時刻 (FILETIME)
inspect
keyname

Win32::Registry.open または Win32::Registry.create に指定された subkey の値を返します。

keys
name
to_s

キーのフルパスを 'HKEY_CURRENT_USER\SOFTWARE\foo\bar' のような形で返します。

open(subkey, desired = KEY_READ, opt = REG_OPTION_RESERVED)

Win32::Registry.open(self, subkey, desired, opt) と同じです。

open?
opened?

キーがまだ閉じられていない場合,真を返します。

parent

親のキーを表す Win32::Registry オブジェクトを返します。 定義済キーでは nil を返します。

read(name, *rtype)

レジストリ値 name を読み,[ type, data ] の配列で返します。 name が nil の場合,(標準) レジストリ値が読み込まれます。

read_s(name)
read_i(name)
read_bin(name)

型がそれぞれ REG_SZ(read_s), REG_DWORD(read_i), REG_BINARY(read_bin) であるレジストリ値 name を読み,その値を返します。

read_s_expand(name)

型が REG_SZ または REG_EXPAND_SZ であるレジストリ値 name を読み, その値を返します。

write(name, type, data)

レジストリ値 name に型 type で data を書き込みます。 name が nil の場合,(標準) レジストリ値に書き込みます。

write_s(name, value)
write_i(name, value)
write_bin(name, value)

レジストリ値 name に value を書き込みます。

定数

定義 説明
HKEY_CLASSES_ROOT
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_PERFORMANCE_DATA
HKEY_CURRENT_CONFIG
HKEY_DYN_DATA

それぞれの定義済キーを表す Win32::Registry オブジェクトです。

継承したメソッド

! != all? any? chunk collect collect_concat count cycle detect drop drop_while each_cons each_entry each_slice each_with_index each_with_object entries find_all find_index first grep group_by include? inject max max_by min min_by minmax minmax_by none? one? partition reject reverse_each slice_before sort sort_by take take_while to_set zip == === =~ __id__ __send__ class clone dclone display enum_for eql? equal? extend freeze frozen? hash initialize initialize_copy instance_eval instance_exec instance_of? instance_variable_defined? instance_variable_get instance_variable_set instance_variables is_a? marshal_dump marshal_load method method_missing methods must_be must_be_close_to must_be_empty must_be_instance_of must_be_kind_of must_be_nil must_be_same_as must_be_within_epsilon must_equal must_include must_match must_raise must_respond_to must_send must_throw nil? pretty_inspect pretty_print pretty_print_cycle pretty_print_inspect pretty_print_instance_variables private_methods protected_methods public_methods remove_instance_variable respond_to? respond_to_missing? singleton_class singleton_method_added singleton_method_removed singleton_method_undefined singleton_methods taint tainted? tap to_ary to_hash to_int to_io to_proc to_regexp to_str to_yaml to_yaml_properties to_yaml_style trust untaint untrust untrusted? wont_be wont_be_close_to wont_be_empty wont_be_instance_of wont_be_kind_of wont_be_nil wont_be_same_as wont_be_within_epsilon wont_equal wont_include wont_match wont_respond_to ::HKEY_CLASSES_ROOT ::KEY_ALL_ACCESS ::MAX_KEY_LENGTH ::REG_BINARY ::REG_CREATED_NEW_KEY ::REG_FORCE_RESTORE ::REG_LEGAL_OPTION