get-resource in Miscellaneous

• (get-resource section entry value file) -> boolean
     section : string
     entry : string
     value : boxed string or boxed exact integer
     file = #f : string 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 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 path within the named registry section:

  • "HKEY_CLASSES_ROOT"

  • "HKEY_CURRENT_CONFIG"

  • "HKEY_CURRENT_USER"

  • "HKEY_LOCAL_MACHINE"

  • "HKEY_USERS"

  See also write-resource.