方法
GLibKeyFileload_from_dirs
自:2.14
声明 [源码]
gboolean
g_key_file_load_from_dirs (
GKeyFile* key_file,
const gchar* file,
const gchar** search_dirs,
gchar** full_path,
GKeyFileFlags flags,
GError** error
)
描述 [源码]
此函数在search_dirs
指定的路径中查找名为file
的密钥文件,将文件加载到key_file
中,并返回文件的完整路径到full_path
。
如果在任何search_dirs
中找不到该文件,则返回G_KEY_FILE_ERROR_NOT_FOUND
。如果找到文件,但操作系统在打开或读取文件时返回错误,则返回一个G_FILE_ERROR
。如果解析文件有问题,则返回G_KEY_FILE_ERROR
。
自可用:2.14
参数
file
-
类型:
const gchar*
打开和解析文件名的相对路径。
数据由方法的调用者拥有。 该值是平台原生字符串,在Unix上使用首选的OS编码,在Windows上使用UTF-8。 search_dirs
-
类型: 一组
filename
要搜索的目录的
NULL
-终结数组。该数组必须以 NULL
结尾。数据由方法的调用者拥有。 每个元素都是平台本机字符串,在Unix上使用首选的OS编码,在Windows上使用UTF-8。 full_path
-
类型:
gchar**
包含文件完整路径的字符串的返回位置,或
NULL
。此参数将由函数设置。 此参数可以是 NULL
。方法调用者将拥有返回的数据,并负责释放它。 该值是平台原生字符串,在Unix上使用首选的OS编码,在Windows上使用UTF-8。 flags
-
类型:
GKeyFileFlags
来自
GKeyFileFlags
的标志。 error
-
类型:
GError **
用于可恢复错误的返回位置。
此参数可以是 NULL
。如果返回位置不是 NULL
,则必须将其初始化为NULL
GError*
。如果没有错误,则方法将此参数初始化为 NULL
。在发生错误的情况下,将参数设置为新的 allocated GError
;调用者将拥有数据,并负责释放它。