函数

GLibDirmake_tmp

自:2.30

声明 [源]

gchar*
g_dir_make_tmp (
  const gchar* tmpl,
  GError** error
)

描述 [源]

在临时文件的首选目录中创建一个子目录(g_get_tmp_dir() 返回的目录)。

tmpl 应该是按照 GLib 文件名编码包含六个连续的 ‘X’ 字符的字符串,作为 g_mkstemp() 的参数。然而,与这些函数不同,模板应该是基本名称,不允许有目录组成部分。如果模板是 NULL,则使用默认模板。

注意,与 g_mkdtemp()(和 mkdtemp())相比,tmpl 不会被修改,因此可能是一个只读的字符串字面量。

自:2.30

参数

tmpl

类型: const gchar*

目录名称模板,如在 g_mkdtemp() 中,仅基本名,或 NULL 使用默认模板。

参数可以为 NULL
数据由函数的调用者拥有。
该值是平台原生字符串,在 Unix 上使用首选 OS 编码,在 Windows 上使用 UTF-8。
error

类型: GError **

可恢复错误的返回位置。

参数可以为 NULL
如果返回位置不是 NULL,则必须将其初始化为 NULL GError*
如果没有错误,函数会将该参数初始化为 NULL
如果出现错误,参数将被设置为一个新的 GError;调用者将拥有该数据,并负责释放它。

返回值

类型: gchar*

实际使用的名称。应在不再需要时使用 g_free() 释放此字符串,并且它位于 GLib 文件名编码中。如果发生错误,则返回 NULL 并且设置 error

函数的调用者将拥有该数据,并负责释放它。
该值是平台原生字符串,在 Unix 上使用首选 OS 编码,在 Windows 上使用 UTF-8。