GLibfilename_display_basename

since: 2.6

gchar*
g_filename_display_basename (
  const gchar* filename
)

傳回指定檔名顯示的檔名，保證為有效的 UTF-8。顯示的名稱可能不會與檔名相同，例如可能會遇到轉換為 UTF-8 的問題，部分檔案可在顯示中加以轉換。

如果 GLib 讀不懂 `filename` 的編碼，最後會用 U+FFFD，也就是 Unicode 替換字元，取代不認識的字元。你可以搜尋結果中 UTF-8 編碼的此字元（以八進制表示為「\357\277\275」），以找出 `filename` 是否使用無效的編碼。

你必須傳遞整個絕對路徑的名稱給此函數，以便能轉換知名的位置。

如果你知道整條路徑，建議使用此函數，而非 `g_filename_display_name() `，因為它允許轉換。

自以下版本提供：2.6

filename

型別： const gchar*

GLib 檔名編碼中的絕對路徑名稱。

資料由函數呼叫者擁有。

值為平台原生字串，在 Unix 上使用首選作業系統編碼，在 Windows 上使用 UTF-8。

型別： gchar*

新配置的字串，包含檔名 basename 在有效 UTF-8 中的版本。

函數呼叫者取得資料所有權，並且負責釋放它。

值為 NUL 字元終止的 UTF-8 字串。