Returns the string value of a
GVariant instance with a string
type. This includes the types
The string will always be UTF-8 encoded, will never be
NULL, and will never
contain nul bytes.
length is non-
NULL then the length of the string (in bytes) is
returned there. For trusted values, this information is already
known. Untrusted values will be validated and, if valid, a
strlen() will be
performed. If invalid, a default value will be returned — for
G_VARIANT_TYPE_OBJECT_PATH, this is
"/", and for other types it is the
It is an error to call this function with a
value of any type
other than those three.
The return value remains valid as long as
A pointer to a #gsize, to store the length.
|The argument will be set by the function.|
|The argument can be |
|The instance takes ownership of the data, and is responsible for freeing it.|