Function

GLibmkstemp_full

Declaration

gint
g_mkstemp_full (
  gchar* tmpl,
  gint flags,
  gint mode
)

Description

Opens a temporary file. See the mkstemp() documentation on most UNIX-like systems.

The parameter is a string that should follow the rules for mkstemp() templates, i.e. contain the string “XXXXXX”. g_mkstemp_full() is slightly more flexible than mkstemp() in that the sequence does not have to occur at the very end of the template and you can pass a mode and additional flags. The X string will be modified to form the name of a file that didn’t exist. The string should be in the GLib file name encoding. Most importantly, on Windows it should be in UTF-8.

Available since:	2.22
This function is not directly available to language bindings

Parameters

`tmpl`	`gchar*`
	Template filename.
	The data is owned by the caller of the function.
	The value is a file system path, using the OS encoding.
`flags`	`gint`
	Flags to pass to an `open()` call in addition to O_EXCL and O_CREAT, which are passed automatically.
`mode`	`gint`
	Permissions to create the temporary file with.

Return value

Returns:	`gint`
	A file handle (as from open()) to the file opened for reading and writing. The file handle should be closed with close(). In case of errors, -1 is returned and %errno will be set.