file_get_utf8_name

This function works like filename_to_utf8 and returns a UTF-8 encoded string that does not need to be freed.

It converts a File'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 file_get_utf8_name.

The only purpose of this function is to provide an easy way to pass a File's name to a function that expects an UTF-8 encoded string.

See get_parse_name.

Parameters:

file

a File

Returns:

A temporarily valid UTF-8 representation of file's name. This string must not be changed or freed.