函数

GLibDiropen

声明 [src]

GDir*
g_dir_open (
  const gchar* path,
  guint flags,
  GError** error
)

描述 [src]

打开一个目录供读取。然后可以使用g_dir_read_name()检索目录中文件的名称。注意，排序并未定义。

参数

path

类型： const gchar*

你感兴趣的目录的路径。在Unix中为磁盘编码。在Windows中为UTF-8。

数据由函数的调用者拥有。
值是一个以NUL终止的UTF-8字符串。
flags

类型： guint

当前必须设置为0。供将来使用。

error

类型： GError **

用于可恢复错误的返回位置。

参数可以是NULL。
如果返回位置不是NULL，那么你必须初始化它为NULL的GError*。
如果没有错误，函数将保留参数初始化为NULL。
如果发生错误，参数将被设置为新的分配的GError；调用者将拥有数据，并负责释放它。

返回值

类型： GDir

在成功时分配一个新的GDir，在失败时返回NULL。如果非NULL，请在使用完毕后使用g_dir_close()释放结果。

函数的调用者将拥有数据，并负责释放它。