Icon.toString_

Generates a textual representation of icon that can be used for serialization such as when passing icon to a different process or saving it to persistent storage. Use gio.icon.Icon.newForString to get icon back from the returned string.

The encoding of the returned string is proprietary to #GIcon except in the following two cases

  • If icon is a #GFileIcon, the returned string is a native path (such as /path/to/my icon.png) without escaping if the #GFile for icon is a native file. If the file is not native, the returned string is the result of gio.file.File.getUri (such as sftp://path/to/my20icon.png).
  • If icon is a #GThemedIcon with exactly one name and no fallbacks, the encoding is simply the name (such as network-server).
interface Icon
string
toString_
()

Return Value

Type: string

An allocated NUL-terminated UTF8 string or null if icon can't be serialized. Use glib.global.gfree to free.