g-file-get-parse-name (file)

file -- a input g-file object

A string containing the parse name of the g-file object.

Gets the parse name of the file. A parse name is a UTF-8 string that describes the file such that one can get the g-file object back using the g-file-parse-name function.

This is generally used to show the g-file object as a nice full-pathname kind of string in a user interface, like in a location entry.

For local files with names that can safely be converted to UTF-8 the pathname is used, otherwise the IRI is used, a form of URI that allows UTF-8 characters unescaped.

This call does no blocking I/O.