Utility Functions

Utility Functions

Synopsis


#include <thunar-vfs/thunar-vfs.h>

gchar*              thunar_vfs_canonicalize_filename    (const gchar *filename);
gchar*              thunar_vfs_expand_filename          (const gchar *filename,
                                                         GError **error);
gchar*              thunar_vfs_humanize_size            (ThunarVfsFileSize size,
                                                         gchar *buffer,
                                                         gsize buflen);

Description

Details

thunar_vfs_canonicalize_filename ()

gchar*              thunar_vfs_canonicalize_filename    (const gchar *filename);

Canonicalizes filename and returns a new path. The new path differs from filename in:

Multiple `/'s are collapsed to a single `/'.
Leading `./'s and trailing `/.'s are removed.
Non-leading `../'s and trailing `..'s are handled by removing portions of the path.

The caller is responsible to free the returned string using g_free() when no longer needed.

filename :

a local filename.

Returns :

the canonicalized path for filename.

thunar_vfs_expand_filename ()

gchar*              thunar_vfs_expand_filename          (const gchar *filename,
                                                         GError **error);

Takes a user-typed filename and expands a tilde at the beginning of the filename.

The caller is responsible to free the returned string using g_free() when no longer needed.

filename :

a local filename.

error :

return location for errors or NULL.

Returns :

the expanded filename or NULL on error.

thunar_vfs_humanize_size ()

gchar*              thunar_vfs_humanize_size            (ThunarVfsFileSize size,
                                                         gchar *buffer,
                                                         gsize buflen);

The caller is responsible to free the returned string using g_free() if you pass NULL for buffer. Else the returned string will be a pointer to buffer.

size :

size in bytes.

buffer :

destination buffer or NULL to dynamically allocate a buffer.

buflen :

length of buffer in bytes.

Returns :

a string containing a human readable description of size.