Declaration [src]

g_build_filename (
  const gchar* first_element,

Description [src]

Creates a filename from a series of elements using the correct separator for filenames.

On Unix, this function behaves identically to g_build_path (G_DIR_SEPARATOR_S, first_element, ....).

On Windows, it takes into account that either the backslash (\ or slash (/) can be used as separator in filenames, but otherwise behaves as on UNIX. When file pathname separators need to be inserted, the one that last previously occurred in the parameters (reading from left to right) is used.

No attempt is made to force the resulting filename to be an absolute path. If the first element is a relative path, the result will be a relative path.


first_element const gchar*

The first element in the path.

 The data is owned by the caller of the function.
 The string is a file system path, using the OS encoding.

Remaining elements in path, terminated by NULL.

Return value

Returns: gchar*

A newly-allocated string that must be freed with g_free().

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