Package: glib

Function g-system-data-dirs

Lambda List

g-system-data-dirs ()

Return Value

A list of strings owned by GLib that must not be modified or freed.

Details

Returns an ordered list of base directories in which to access system-wide application data.

On UNIX platforms this is determined using the mechanisms described in the XDG Base Directory Specification In this case the list of directories retrieved will be XDG_DATA_DIRS.

On Windows the first elements in the list are the Application Data and Documents folders for All Users. These can be determined only on Windows 2000 or later and are not present in the list on other Windows versions. See documentation for CSIDL_COMMON_APPDATA and CSIDL_COMMON_DOCUMENTS.

Then follows the "share" subfolder in the installation folder for the package containing the DLL that calls this function, if it can be determined.

Finally the list contains the "share" subfolder in the installation folder for GLib, and in the installation folder for the package the application's .exe file belongs to.

The installation folders above are determined by looking up the folder where the module (DLL or EXE) in question is located. If the folder's name is "bin", its parent is used, otherwise the folder itself.

Note that on Windows the returned list can vary depending on where this function is called.

Example

Result for a call on a LINUX system.
  (g-system-data-dirs)
=> ("/usr/share/ubuntu" "/usr/share/gnome"
    "/usr/local/share/" "/usr/share/")    
 

See also