Function

GLibDirmake_tmp

Declaration

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

Description

Creates a subdirectory in the preferred directory for temporary files (as returned by g_get_tmp_dir()).

tmpl should be a string in the GLib file name encoding containing a sequence of six ‘X’ characters, as the parameter to g_mkstemp(). However, unlike these functions, the template should only be a basename, no directory components are allowed. If template is NULL, a default template is used.

Note that in contrast to g_mkdtemp() (and mkdtemp()) tmpl is not modified, and might thus be a read-only literal string.

Available since:2.30

Parameters

tmpl const gchar*
 

Template for directory name, as in g_mkdtemp(), basename only, or NULL for a default template.

 The argument can be NULL.
 The data is owned by the caller of the function.
 The value is a file system path, using the OS encoding.
error GError **
  The return location for a GError*, or NULL.

Return value

Returns: gchar*
 

The actual name used. This string should be freed with g_free() when not needed any longer and is is in the GLib file name encoding. In case of errors, NULL is returned and error will be set.

 The caller of the function takes ownership of the data, and is responsible for freeing it.
 The value is a file system path, using the OS encoding.