function format_size_for_display(size: Number(gint64)): String {
    // Gjs wrapper for g_format_size_for_display()

Formats a size (for example the size of a file) into a human readable string. Sizes are rounded to the nearest size prefix (KB, MB, GB) and are displayed rounded to the nearest tenth. E.g. the file size 3292528 bytes will be converted into the string "3.1 MB".

The prefix units base is 1024 (i.e. 1 KB is 1024 bytes).

This string should be freed with when not needed any longer.

Since 2.16


a size in bytes


a newly-allocated formatted string containing a human readable file size