<?xml version="1.0"?>
<page id="Gimp.file_get_utf8_name"
      type="topic"
      style="function"
      xmlns="http://projectmallard.org/1.0/"
      xmlns:api="http://projectmallard.org/experimental/api/"
      xmlns:ui="http://projectmallard.org/1.0/ui/">
  <info>
    <link xref="index" group="function" type="guide"/>
    <api:function>
      <api:returns>
        <api:type>unicode</api:type>
      </api:returns>
      <api:name>gimp_file_get_utf8_name</api:name>
      <api:arg>
        <api:type>Gio.File</api:type>
        <api:name>file</api:name>
      </api:arg>
    </api:function>
  </info>
  <title>Gimp.file_get_utf8_name</title>
  <synopsis><code mime="text/x-python">
@accepts(Gio.File)
@returns(unicode)
def file_get_utf8_name(file):
    # Python wrapper for gimp_file_get_utf8_name()
  </code></synopsis>
  <p>This function works like <link xref="Gimp.filename_to_utf8"/> and returns
a UTF-8 encoded string that does not need to be freed.</p>  <p>It converts a <link href="../Gio-2.0/Gio.File.html">Gio.File</link>'s path or uri to UTF-8 temporarily.  The
return value is a pointer to a string that is guaranteed to be
valid only during the current iteration of the main loop or until
the next call to <link xref="Gimp.file_get_utf8_name"/>.</p>  <p>The only purpose of this function is to provide an easy way to pass
a <link href="../Gio-2.0/Gio.File.html">Gio.File</link>'s name to a function that expects an UTF-8 encoded string.</p>  <p>See g_file_get_parse_name().</p>
  <p>Since 2.10</p>
<terms>
<item>
<title><code>file</code></title>
  <p>a <link href="../Gio-2.0/Gio.File.html">Gio.File</link></p>
</item>
<item>
<title><code>Returns</code></title>
{formatter.format(node, node.retval.doc)}
</item>
</terms>

</page>
