stealString

Steal ownership on contents of a %G_TYPE_STRING #GValue. 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 #GValue API.

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