要約
目次
- 特異メソッド
- インスタンスメソッド
-
- []
- []=
- _dump
- close
- create
- created?
- delete
- delete_key
- delete_value
- descriptor_length
- disposition
- each
- each_key
- each_value
- flush
- hkey
- info
- inspect
- keyname
- keys
- max_key_length
- max_value_length
- max_value_name_length
- name
- num_keys
- num_values
- open
- open?
- opened?
- parent
- read
- read_bin
- read_i
- read_s
- read_s_expand
- to_s
- write
- write_bin
- write_i
- write_s
- wtime
- 定数
継承しているメソッド
- Enumerableから継承しているメソッド
-
- all?
- any?
- chain
- chunk
- chunk_while
- collect
- collect_concat
- compact
- count
- cycle
- detect
- drop
- drop_while
- each_cons
- each_entry
- each_slice
- each_with_index
- each_with_object
- entries
- filter
- filter_map
- find
- find_all
- find_index
- first
- flat_map
- grep
- grep_v
- group_by
- include?
- inject
- lazy
- map
- max
- max_by
- member?
- min
- min_by
- minmax
- minmax_by
- none?
- one?
- partition
- reduce
- reject
- reverse_each
- select
- slice_after
- slice_before
- slice_when
- sort
- sort_by
- sum
- take
- take_while
- tally
- to_a
- to_h
- uniq
- zip
特異メソッド
create(key, subkey, desired = KEY_ALL_ACCESS, opt = REG_OPTION_RESERVED)
[permalink][rdoc][edit]create(key, subkey, desired = KEY_ALL_ACCESS, opt = REG_OPTION_RESERVED) {|reg| ... }
-
[TODO]
レジストリキー key 下にキー subkey を作成し,開いたキーを表す Win32::Registry オブジェクトを返します。 key は親のキーを Win32::Registry オブジェクトで指定します。親のキーには定義済キー HKEY_* を使用できます (⇒Win32::Registry::Constants)
サブキーが既に存在していればキーはただ開かれ,Win32::Registry#created? メソッドが false を返します。
ブロックが与えられると,キーは自動的に閉じられます。
expand_environ(str)
[permalink][rdoc][edit]-
[TODO]
str の %\w+% という並びを環境変数に置換します。 REG_EXPAND_SZ で用いられます。
詳細は以下の Win32 API を参照してください。
- ExpandEnvironmentStrings: http://msdn.microsoft.com/library/en-us/sysinfo/base/expandenvironmentstrings.asp
new(key, subkey, desired = KEY_READ, opt = REG_OPTION_RESERVED)
[permalink][rdoc][edit]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| ... }
-
[TODO]
レジストリキー key 下のキー subkey を開き,開いたキーを表す Win32::Registry オブジェクトを返します。 key は親のキーを Win32::Registry オブジェクトで指定します。親のキーには定義済キー HKEY_* を使用できます (⇒Win32::Registry::Constants)
desired はアクセスマスクです。opt はキーのオプションです。詳細は以下の MSDN Library を参照してください。
- Registry Key Security and Access Rights: http://msdn.microsoft.com/library/en-us/sysinfo/base/registry_key_security_and_access_rights.asp
ブロックが与えられると,キーは自動的に閉じられます。
time2wtime(time)
[permalink][rdoc][edit]-
[TODO]
Time オブジェクトまたは Integer オブジェクトを受け取り, 64bit の FILETIME に変換します。
type2name(type)
[permalink][rdoc][edit]-
[TODO]
レジストリ値の型を整数から可読文字列に変換します。
wtime2time(wtime)
[permalink][rdoc][edit]-
[TODO]
64bit の FILETIME を Time オブジェクトに変換します。
詳細は以下の MSDN Library を参照してください。
- FILETIME Structure: http://msdn.microsoft.com/library/en-us/sysinfo/base/filetime_str.asp
インスタンスメソッド
self[name, wtype = nil]
[permalink][rdoc][edit]-
[TODO]
レジストリ値 name に value を書き込みます。
オプション引数 wtype を指定した場合は,その型で書き込みます。指定しなかった場合,value のクラスに応じて次の型で書き込みます:
- Integer REG_DWORD
- String REG_SZ
- Array REG_MULTI_SZ
self[name, rtype] = value = nil
[permalink][rdoc][edit]-
[TODO]
_dump
[permalink][rdoc][edit]-
[TODO]
close
[permalink][rdoc][edit]-
[TODO]
開かれているキーを閉じます。
閉じられた後では,多くのメソッドは例外を発生します。
create(subkey, desired = KEY_ALL_ACCESS, opt = REG_OPTION_RESERVED)
[permalink][rdoc][edit]-
[TODO]
Win32::Registry.create(self, subkey, desired, opt) と同じです。
created?
[permalink][rdoc][edit]-
[TODO]
キーが新しく作成された場合,真を返します。 (⇒Win32::Registry.create)
delete(name)
[permalink][rdoc][edit]delete_value(name)
-
[TODO]
レジストリ値 name を削除します。 (標準) レジストリ値を削除することはできません。
delete_key(name, recursive = false)
[permalink][rdoc][edit]-
[TODO]
サブキー name とそのキーが持つすべての値を削除します。
recursive が false の場合,そのサブキーはサブキーを持っていてはなりません。 true の場合,キーは再帰的に削除されます。
num_keys
[permalink][rdoc][edit]max_key_length
num_values
max_value_name_length
max_value_length
descriptor_length
wtime
-
[TODO]
キー情報の個々の値を返します。
disposition
[permalink][rdoc][edit]-
[TODO]
キーの disposition 値を返します。 (REG_CREATED_NEW_KEY または REG_OPENED_EXISTING_KEY)
each {|name, type, value| ... }
[permalink][rdoc][edit]each_value {|name, type, value| ... }
-
[TODO]
キーが持つレジストリ値を列挙します。
each_key {|subkey, wtime| ... }
[permalink][rdoc][edit]-
[TODO]
キーのサブキーを列挙します。
subkey はサブキーの名前を表す String です。 wtime は最終更新時刻を表す FILETIME (64-bit 整数) です。 (⇒Win32::Registry.wtime2time)
flush
[permalink][rdoc][edit]-
[TODO]
キーの全てのデータをレジストリファイルに書き込みます。
hkey
[permalink][rdoc][edit]-
[TODO]
info
[permalink][rdoc][edit]-
[TODO]
キー情報を以下の値の配列で返します:
- num_keys サブキーの個数
- max_key_length サブキー名の最大長
- num_values 値の個数
- max_value_name_length 値の名前の最大長
- max_value_length 値の最大長
- descriptor_length セキュリティ記述子の長さ
- wtime 最終更新時刻 (FILETIME)
詳細は以下の Win32 API を参照してください。
inspect
[permalink][rdoc][edit]-
[TODO]
keyname
[permalink][rdoc][edit]-
[TODO]
Win32::Registry.open または Win32::Registry.create に指定された subkey の値を返します。
keys
[permalink][rdoc][edit]-
[TODO]
name
[permalink][rdoc][edit]to_s
-
[TODO]
キーのフルパスを 'HKEY_CURRENT_USER\SOFTWARE\foo\bar' のような形で返します。
open(subkey, desired = KEY_READ, opt = REG_OPTION_RESERVED)
[permalink][rdoc][edit]-
[TODO]
Win32::Registry.open(self, subkey, desired, opt) と同じです。
open?
[permalink][rdoc][edit]-
[TODO]
opened?
[permalink][rdoc][edit]-
[TODO]
キーがまだ閉じられていない場合,真を返します。
parent
[permalink][rdoc][edit]-
[TODO]
親のキーを表す Win32::Registry オブジェクトを返します。定義済キーでは nil を返します。
read(name, *rtype)
[permalink][rdoc][edit]-
[TODO]
レジストリ値 name を読み,[ type, data ] の配列で返します。 name が nil の場合,(標準) レジストリ値が読み込まれます。
type はレジストリ値の型です。(⇒Win32::Registry::Constants) data はレジストリ値のデータで,クラスは以下の通りです:
- REG_SZ, REG_EXPAND_SZ String
- REG_MULTI_SZ String の配列
- REG_DWORD, REG_DWORD_BIG_ENDIAN, REG_QWORD Integer
- REG_BINARY, REG_NONE String (バイナリデータを含みます)
オプション引数 rtype が指定されていた場合,レジストリ値の型が与えられた rtype の配列に存在するかチェックされ,存在しない場合に TypeError が発生します。
read_s(name)
[permalink][rdoc][edit]read_i(name)
read_bin(name)
-
[TODO]
型がそれぞれ REG_SZ(read_s), REG_DWORD(read_i), REG_BINARY(read_bin) であるレジストリ値 name を読み,その値を返します。
型がマッチしなかった場合,TypeError が発生します。
read_s_expand(name)
[permalink][rdoc][edit]-
[TODO]
型が REG_SZ または REG_EXPAND_SZ であるレジストリ値 name を読み,その値を返します。
型が REG_EXPAND_SZ だった場合,環境変数が置換された値が返ります。 REG_SZ または REG_EXPAND_SZ 以外だった場合,TypeError が発生します。
write(name, type, data)
[permalink][rdoc][edit]-
[TODO]
レジストリ値 name に型 type で data を書き込みます。 name が nil の場合,(標準) レジストリ値に書き込みます。
type はレジストリ値の型です。(⇒Win32::Registry::Constants) data のクラスは Win32::Registry#read メソッドに準じていなければなりません。
write_s(name, value)
[permalink][rdoc][edit]write_i(name, value)
write_bin(name, value)
-
[TODO]
レジストリ値 name に value を書き込みます。
レジストリ値の型はそれぞれ REG_SZ(write_s), REG_DWORD(write_i), REG_BINARY(write_bin) です。
定数
HKEY_CLASSES_ROOT -> Win32::Registry
[permalink][rdoc][edit]HKEY_CURRENT_USER -> Win32::Registry
HKEY_LOCAL_MACHINE -> Win32::Registry
HKEY_USERS -> Win32::Registry
HKEY_PERFORMANCE_DATA -> Win32::Registry
HKEY_PERFORMANCE_TEXT -> Win32::Registry
HKEY_PERFORMANCE_NLSTEXT -> Win32::Registry
HKEY_CURRENT_CONFIG -> Win32::Registry
HKEY_DYN_DATA -> Win32::Registry
-
[TODO]
それぞれの定義済キーを表す Win32::Registry オブジェクトです。
詳細は以下の MSDN Library を参照してください。