steal_string

Steal ownership on contents of a g_type_string Value .

As a result of this operation the value's contents will be reset to null.

The purpose of this call is to provide a way to avoid an extra copy when some object have been serialized into string through Value API.

NOTE: for safety and compatibility purposes, if Value contains static string, or an interned one, this function will return a copy of the string. Otherwise the transfer notation would be ambiguous.

Parameters:

this	a valid Value of type g_type_string

Returns:

string content of this; Should be freed with g_free when no longer needed.