File utilities

Synopsis

#define             GO_F_OK
enum                GODotDot;
struct              GOFilePermissions;
#define             GO_R_OK
#define             GO_W_OK
#define             GO_X_OK
char *              go_basename_from_uri                (const char *uri);
char *              go_dirname_from_uri                 (const char *uri,
                                                         gboolean brief);
gint                go_file_access                      (char const *uri,
                                                         gint mode);
GsfOutput *         go_file_create                      (char const *uri,
                                                         GError **err);
time_t              go_file_get_date_accessed           (char const *uri);
time_t              go_file_get_date_changed            (char const *uri);
time_t              go_file_get_date_modified           (char const *uri);
gchar *             go_file_get_group_name              (char const *uri);
gchar *             go_file_get_owner_name              (char const *uri);
GsfInput *          go_file_open                        (char const *uri,
                                                         GError **err);
GSList *            go_file_split_urls                  (char const *data);
char *              go_filename_from_uri                (const char *uri);
char *              go_filename_simplify                (const char *filename,
                                                         GODotDot dotdot,
                                                         gboolean make_absolute);
char *              go_filename_to_uri                  (const char *filename);
GOFilePermissions * go_get_file_permissions             (char const *uri);
gchar *             go_get_mime_type                    (gchar const *uri);
gchar *             go_get_mime_type_for_data           (gconstpointer data,
                                                         int data_size);
gchar *             go_mime_type_get_description        (gchar const *mime_type);
void                go_set_file_permissions             (char const *uri,
                                                         GOFilePermissions *file_permissions);
char *              go_shell_arg_to_uri                 (const char *arg);
gchar const **      go_shell_argv_to_glib_encoding      (gint argc,
                                                         gchar const **argv);
void                go_shell_argv_to_glib_encoding_free (void);

Object Hierarchy

  GBoxed
   +----GOFilePermissions

Description

Details

GO_F_OK

#  define GO_F_OK F_OK

enum GODotDot

typedef enum {
	GO_DOTDOT_SYNTACTIC,    /* Assume no symlinks.  */
	GO_DOTDOT_TEST,         /* Check.  */
	GO_DOTDOT_LEAVE         /* Leave alone.  */
} GODotDot;

`GO_DOTDOT_SYNTACTIC`	assume no symlinks.
`GO_DOTDOT_TEST`	check.
`GO_DOTDOT_LEAVE`	leave alone.

struct GOFilePermissions

struct GOFilePermissions {
	gboolean owner_read;
	gboolean owner_write;
	gboolean owner_execute;

	gboolean group_read;
	gboolean group_write;
	gboolean group_execute;

	gboolean others_read;
	gboolean others_write;
	gboolean others_execute;
};

gboolean `owner_read`;	owner can read.
gboolean `owner_write`;	owner can write.
gboolean `owner_execute`;	owner can execute.
gboolean `group_read`;	group can read.
gboolean `group_write`;	group can write.
gboolean `group_execute`;	group can execute.
gboolean `others_read`;	everybody can read.
gboolean `others_write`;	everybody can write.
gboolean `others_execute`;	everybody can execute.

GO_R_OK

#  define GO_R_OK R_OK

GO_W_OK

#  define GO_W_OK W_OK

GO_X_OK

#  define GO_X_OK X_OK

go_basename_from_uri ()

char *              go_basename_from_uri                (const char *uri);

Decode the final path component. Returns as UTF-8 encoded suitable for display.

`uri` :	The uri
Returns :	a string that the caller is responsible for freeing.

go_dirname_from_uri ()

char *              go_dirname_from_uri                 (const char *uri,
                                                         gboolean brief);

Decode the all but the final path component. Returns as UTF-8 encoded suitable for display.

`uri` :	target
`brief` :	if TRUE, hide "file://" if present.
Returns :	dirname which the caller is responsible for freeing.

go_file_access ()

gint                go_file_access                      (char const *uri,
                                                         gint mode);

go_file_create ()

GsfOutput *         go_file_create                      (char const *uri,
                                                         GError **err);

Creates a file or return an error. If the file already exists, it is replaced.

`uri` :	target uri
`err` :	GError
Returns :	non-`NULL` on success. [transfer full]

go_file_get_date_accessed ()

time_t              go_file_get_date_accessed           (char const *uri);

go_file_get_date_changed ()

time_t              go_file_get_date_changed            (char const *uri);

go_file_get_date_modified ()

time_t              go_file_get_date_modified           (char const *uri);

go_file_get_group_name ()

gchar *             go_file_get_group_name              (char const *uri);

go_file_get_owner_name ()

gchar *             go_file_get_owner_name              (char const *uri);

go_file_open ()

GsfInput *          go_file_open                        (char const *uri,
                                                         GError **err);

Try all available methods to open a file or return an error

`uri` :	target uri
`err` :	GError
Returns :	non-`NULL` on success. [transfer full]

go_file_split_urls ()

GSList *            go_file_split_urls                  (char const *data);

Splits the chain into a list of URIs. Lines starting with '#' are ignored.

`data` :	a string filled with a list of URIs separated by new lines.
Returns :	the URIs list. [element-type char][transfer full]

go_filename_from_uri ()

char *              go_filename_from_uri                (const char *uri);

go_filename_simplify ()

char *              go_filename_simplify                (const char *filename,
                                                         GODotDot dotdot,
                                                         gboolean make_absolute);

go_filename_to_uri ()

char *              go_filename_to_uri                  (const char *filename);

go_get_file_permissions ()

GOFilePermissions * go_get_file_permissions             (char const *uri);

go_get_mime_type ()

gchar *             go_get_mime_type                    (gchar const *uri);

`uri` :	the uri.
Returns :	the mime type for the file as a newly allocated string. Needs to be freed with `g_free()`.

go_get_mime_type_for_data ()

gchar *             go_get_mime_type_for_data           (gconstpointer data,
                                                         int data_size);

`data` :	the data.
`data_size` :	the data size
Returns :	the mime type for the data as a newly allocated string. Needs to be freed with `g_free()`.

go_mime_type_get_description ()

gchar *             go_mime_type_get_description        (gchar const *mime_type);

`mime_type` :	the mime type to describe.
Returns :	the description for the mime type as a newly allocated string. Needs to be freed with `g_free()`. If the description is not found, the mime type itself will be returned.

go_set_file_permissions ()

void                go_set_file_permissions             (char const *uri,
                                                         GOFilePermissions *file_permissions);

go_shell_arg_to_uri ()

char *              go_shell_arg_to_uri                 (const char *arg);

go_shell_argv_to_glib_encoding ()

gchar const **      go_shell_argv_to_glib_encoding      (gint argc,
                                                         gchar const **argv);

Transform arguments to UTF-8 when needed.

`argc` :	arguments number
`argv` :	command line arguments
Returns :	the arguments in UTF-8 locale. [transfer none]

go_shell_argv_to_glib_encoding_free ()

void                go_shell_argv_to_glib_encoding_free (void);