函数

GLibget_system_data_dirs

since: 2.6

声明 [src]

const gchar* const*
g_get_system_data_dirs (
  void
)

说明 [src]

返回一个有序的基础目录列表，用于访问全系统应用程序数据。

在 UNIX 平台上，将使用 XDG 基本目录规范中所述的机制确定这一点。在这种情况下，检索到的目录列表将是 XDG_DATA_DIRS。

如果定义了 XDG_DATA_DIRS，那么在 Windows 上它将遵循 XDG 基本目录规范。如果未定义 XDG_DATA_DIRS，列表中的第一个元素是所有用户的应用程序数据文件夹和文档文件夹。（只有在 Windows 2000 或更高版本才能确定这些文件夹，它们不会出现在其他 Windows 版本的列表中。）请参阅 FOLDERID_ProgramData 和 FOLDERID_PublicDocuments 的文档。

然后遵循调用此函数的 DLL 所包含包的安装文件夹中的“share”子文件夹（如果可以确定）。

最后，列表中包含 GLib 安装文件夹和应用程序的 .exe 文件所属的包的安装文件夹中的“share”子文件夹。

上述安装文件夹是通过查找相关模块（DLL 或 EXE）所在的文件夹来确定的。如果文件夹的名称是“bin”，则使用其父文件夹，否则使用文件夹本身。

请注意，在 Windows 上，返回的列表可能会因调用此函数的位置而异。

返回值已被缓存，不支持在运行时修改它，因为在运行时修改环境变量是不安全的。

提供于：2.6

返回值

类型： filename 数组

a `NULL`-terminated array of strings owned by GLib that must not be
modified or freed.

数组以 NULL 结束。

数据由被调用的函数所有。

每个元素都是平台原生字符串，在 Unix 上使用首选的 OS 编码，在 Windows 上使用 UTF-8。