file_functions

file_functions

Synopsis



#define             FILE_SEPARATOR
#define             PATH_SEPARATOR
gchar*              truepath                            (const gchar *path,
                                                         gchar *resolved_path);
gboolean            isReadable                          (const gchar *filename);
gboolean            isWritable                          (const gchar *filename);
gchar*              search_file_given_paths             (const gchar *filename,
                                                         const gchar *search_paths,
                                                         gboolean readable);
gchar*              filename_get_user_chosen_callback_open_TUI
                                                        (const gchar *defaultFilename,
                                                         const gchar **extensions,
                                                         const gchar *prompt,
                                                         gpointer option);
gchar*              filename_get_user_chosen_callback_save_TUI
                                                        (const gchar *defaultFilename,
                                                         const gchar **extensions,
                                                         const gchar *prompt,
                                                         gpointer option);
gchar*              filename_determine                  (gchar *filenameBuf,
                                                         const gchar *defaultFilename,
                                                         const gchar **extensions,
                                                         const gchar *prompt,
                                                         ChooseFilenameFunc callback,
                                                         gpointer option,
                                                         gboolean isRead);
gchar*              filename_determine_readable         (gchar *filenameBuf,
                                                         const gchar *defaultFilename,
                                                         const gchar **extensions,
                                                         const gchar *prompt,
                                                         ChooseFilenameFunc callback,
                                                         gpointer option);
gchar*              filename_determine_writable         (gchar *filenameBuf,
                                                         const gchar *defaultFilename,
                                                         const gchar **extensions,
                                                         const gchar *prompt,
                                                         ChooseFilenameFunc callback,
                                                         gpointer option);

Description

Details

FILE_SEPARATOR

#define             FILE_SEPARATOR

PATH_SEPARATOR

#define PATH_SEPARATOR ';'

truepath ()

gchar*              truepath                            (const gchar *path,
                                                         gchar *resolved_path);

path :

resolved_path :

Returns :

isReadable ()

gboolean            isReadable                          (const gchar *filename);

filename :

Returns :

isWritable ()

gboolean            isWritable                          (const gchar *filename);

filename :

Returns :

search_file_given_paths ()

gchar*              search_file_given_paths             (const gchar *filename,
                                                         const gchar *search_paths,
                                                         gboolean readable);

filename :

search_paths :

readable :

Returns :

filename_get_user_chosen_callback_open_TUI ()

gchar*              filename_get_user_chosen_callback_open_TUI
                                                        (const gchar *defaultFilename,
                                                         const gchar **extensions,
                                                         const gchar *prompt,
                                                         gpointer option);

Unlike its GUI counterparts, it merely tests the readability of filename.

returns: Returns the filename if it is readable; NULL otherwise.

defaultFilename :

 pre-selected filename. Can be NULL.

extensions :

 acceptable file extensions. NULL for don't care.

prompt :

 the string to be shown in UI, usually shown as dialog title for GUI.

option :

 Other custom option.

Returns :

filename_get_user_chosen_callback_save_TUI ()

gchar*              filename_get_user_chosen_callback_save_TUI
                                                        (const gchar *defaultFilename,
                                                         const gchar **extensions,
                                                         const gchar *prompt,
                                                         gpointer option);

defaultFilename :

extensions :

prompt :

option :

Returns :

filename_determine ()

gchar*              filename_determine                  (gchar *filenameBuf,
                                                         const gchar *defaultFilename,
                                                         const gchar **extensions,
                                                         const gchar *prompt,
                                                         ChooseFilenameFunc callback,
                                                         gpointer option,
                                                         gboolean isRead);

filenameBuf :

defaultFilename :

extensions :

prompt :

callback :

option :

isRead :

Returns :

filename_determine_readable ()

gchar*              filename_determine_readable         (gchar *filenameBuf,
                                                         const gchar *defaultFilename,
                                                         const gchar **extensions,
                                                         const gchar *prompt,
                                                         ChooseFilenameFunc callback,
                                                         gpointer option);

filenameBuf :

defaultFilename :

extensions :

prompt :

callback :

option :

Returns :

filename_determine_writable ()

gchar*              filename_determine_writable         (gchar *filenameBuf,
                                                         const gchar *defaultFilename,
                                                         const gchar **extensions,
                                                         const gchar *prompt,
                                                         ChooseFilenameFunc callback,
                                                         gpointer option);

filenameBuf :

defaultFilename :

extensions :

prompt :

callback :

option :

Returns :