get-resource in Miscellaneous

• (get-resource section entry value file) -> boolean
     section : string
     entry : string
     value : boxed string or boxed exact integer
     file = #f : path or #f

  Gets a resource value from the resource database. The resource value is keyed on the combination of section and entry. The return value is #t is a value is found, #f if it is not. The type of the value initially in the value box determines the way that the resource is interpreted, and value is filled with a new value of the same type if one is found.

  If file is #f, platform-specific resource files are read, as determined by find-graphical-system-path with 'setup-file. (Under X, when file is #f, the user's .Xdefaults file is also read, or the file specified by the XENVIRONMENT environment variable.)

  The format of a resource entry depends on the platform. Windows resources use the standard .INI format. X and Mac OS X resources use the standard X resource format, where each entry consists of a section.entry resource name, a colon, and the resource value, terminated by a newline. Section and entry names are case-sensitive.

  Under Windows, if section is one of the following strings, then file is ignored, and entry is used as a resource path:

  • "HKEY_CLASSES_ROOT"

  • "HKEY_CURRENT_CONFIG"

  • "HKEY_CURRENT_USER"

  • "HKEY_LOCAL_MACHINE"

  • "HKEY_USERS"

  In that case, the entry argument is parsed as a resource entry path, followed by a backslash, followed by a value name. To get the ``default'' value for an entry, use the empty name. For example, the following expression gets a command line for starting a browser:

  (let ([b (box "")]) (get-resource "HKEY_CLASSES_ROOT" "htmlfile\\shell\\open\\command\\" b) (unbox b))

  See also write-resource.