## 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`.