Reading and Writing from local files and directories 3 GSF Library Reading and Writing from local files and directories Synopsis GsfInputStdio; GsfInput* gsf_input_stdio_new (char const *filename, GError **err); GsfOutputStdio; GsfOutput* gsf_output_stdio_new (char const *filename, GError **err); GsfOutput* gsf_output_stdio_new_full (char const *filename, GError **err, char const *first_property_name, ...); GsfOutput* gsf_output_stdio_new_valist (char const *filename, GError **err, char const *first_property_name, va_list var_args); GsfOutput* gsf_output_stdio_new_FILE (char const *filename, FILE *file, gboolean keep_open); GsfOutfileStdio; GsfOutfile* gsf_outfile_stdio_new (char const *root, GError **err); GsfOutfile* gsf_outfile_stdio_new_full (char const *root, GError **err, char const *first_property_name, ...); GsfOutfile* gsf_outfile_stdio_new_valist (char const *root, GError **err, char const *first_property_name, va_list var_args); GsfInfileStdio; GsfInfile* gsf_infile_stdio_new (char const *root, GError **err); Object Hierarchy GObject +----GsfInput +----GsfInputStdio GObject +----GsfOutput +----GsfOutputStdio GObject +----GsfOutput +----GsfOutfile +----GsfOutfileStdio GObject +----GsfInput +----GsfInfile +----GsfInfileStdio Description Details <anchor id="GsfInputStdio-struct"/>GsfInputStdio GsfInputStdiotypedef struct _GsfInputStdio GsfInputStdio; <anchor id="gsf-input-stdio-new"/>gsf_input_stdio_new () gsf_input_stdio_newGsfInput* gsf_input_stdio_new (char const *filename, GError **err); filename : in utf8. err : optionally NULL. Returns :a new file or NULL. <anchor id="GsfOutputStdio-struct"/>GsfOutputStdio GsfOutputStdiotypedef struct _GsfOutputStdio GsfOutputStdio; <anchor id="gsf-output-stdio-new"/>gsf_output_stdio_new () gsf_output_stdio_newGsfOutput* gsf_output_stdio_new (char const *filename, GError **err); filename : name of file to create or replace. err : optionally NULL. Returns :a new file or NULL. <anchor id="gsf-output-stdio-new-full"/>gsf_output_stdio_new_full () gsf_output_stdio_new_fullGsfOutput* gsf_output_stdio_new_full (char const *filename, GError **err, char const *first_property_name, ...); filename : name of file to create or replace. err : optionally NULL. first_property_name : NULL terminated list of properties ... : Returns :a new file or NULL. <anchor id="gsf-output-stdio-new-valist"/>gsf_output_stdio_new_valist () gsf_output_stdio_new_valistGsfOutput* gsf_output_stdio_new_valist (char const *filename, GError **err, char const *first_property_name, va_list var_args); filename : err : first_property_name : var_args : Returns : <anchor id="gsf-output-stdio-new-FILE"/>gsf_output_stdio_new_FILE () gsf_output_stdio_new_FILEGsfOutput* gsf_output_stdio_new_FILE (char const *filename, FILE *file, gboolean keep_open); Assumes ownership of file. If keep_open is true, ownership reverts to caller when the GsfObject is closed. filename : The filename corresponding to file. file : an existing stdio FILE * keep_open : Should file be closed when the wrapper is closed Returns :a new GsfOutput wrapper for file. Warning: the result will be seekable only if file is seekable. If it is seekable, the resulting GsfOutput object will seek relative to file's beginning, not its current location at the time the GsfOutput object is created. <anchor id="GsfOutfileStdio-struct"/>GsfOutfileStdio GsfOutfileStdiotypedef struct _GsfOutfileStdio GsfOutfileStdio; <anchor id="gsf-outfile-stdio-new"/>gsf_outfile_stdio_new () gsf_outfile_stdio_newGsfOutfile* gsf_outfile_stdio_new (char const *root, GError **err); root : root directory in utf8. err : optionally NULL. Returns :a new outfile or NULL. <anchor id="gsf-outfile-stdio-new-full"/>gsf_outfile_stdio_new_full () gsf_outfile_stdio_new_fullGsfOutfile* gsf_outfile_stdio_new_full (char const *root, GError **err, char const *first_property_name, ...); root : err : first_property_name : ... : Returns : <anchor id="gsf-outfile-stdio-new-valist"/>gsf_outfile_stdio_new_valist () gsf_outfile_stdio_new_valistGsfOutfile* gsf_outfile_stdio_new_valist (char const *root, GError **err, char const *first_property_name, va_list var_args); root : err : first_property_name : var_args : Returns : <anchor id="GsfInfileStdio-struct"/>GsfInfileStdio GsfInfileStdiotypedef struct _GsfInfileStdio GsfInfileStdio; <anchor id="gsf-infile-stdio-new"/>gsf_infile_stdio_new () gsf_infile_stdio_newGsfInfile* gsf_infile_stdio_new (char const *root, GError **err); root : in locale dependent encoding err : optionally NULL. Returns :a new file or NULL.