Function

GLibstrdup_vprintf

Declaration [src]

gchar*
g_strdup_vprintf (
  const gchar* format,
  va_list args
)

Description [src]

Similar to the standard C vsprintf() function but safer, since it calculates the maximum space required and allocates memory to hold the result. The returned string should be freed with g_free() when no longer needed.

The returned string is guaranteed to be non-NULL, unless format contains %lc or %ls conversions, which can fail if no multibyte representation is available for the given character.

See also g_vasprintf(), which offers the same functionality, but additionally returns the length of the allocated string.

Parameters

format const gchar*
 

A standard printf() format string, but notice [string precision pitfalls][string-precision]

 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
args va_list
 

The list of parameters to insert into the format string.

Return value

Returns: gchar*
 

A newly-allocated string holding the result.

 The caller of the function takes ownership of the data, and is responsible for freeing it.
 The string is a NUL terminated UTF-8 string.