← Back to branch summary

~ubuntu-branches/ubuntu/trusty/glib2.0/trusty-proposed

« back to all changes in this revision

Viewing changes to docs/reference/glib/html/glib-File-Utilities.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-03-09 11:28:22 UTC
  • mfrom: (3.4.8 experimental)
  • Revision ID: james.westby@ubuntu.com-20100309112822-j4n0v3xbtsup8s97
Tags: 2.23.5-1ubuntu1
* Resync on Debian
* debian/patches/01_gettext-desktopfiles.patch:
  - updated to use gettext for X-GNOME-Fullname too
* debian/patches/71_gio_launch_handler.patch:
  - new gio default launch handle feature required for wncksync
* debian/control.in, 
  debian/patches/80-gtester-subunit.patch:
  - gtester-report subunit support
* debian/libglib2.0-0.symbols:
  - updated the symbols list for the gio launcher handler
* debian/rules:
  - don't break build on test suite errors, debian recently activated this but
    the build breaks even when there is no error in the testsuite

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/glib/html/glib-File-Utilities.html
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>File Utilities</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
7
7
<link rel="home" href="index.html" title="GLib Reference Manual">
8
8
<link rel="up" href="glib-utilities.html" title="GLib Utilities">
9
9
<link rel="prev" href="glib-Spawning-Processes.html" title="Spawning Processes">
10
10
<link rel="next" href="glib-URI-Functions.html" title="URI Functions">
11
 
<meta name="generator" content="GTK-Doc V1.13 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="glib.html" title="GLib Overview">
14
14
<link rel="chapter" href="glib-fundamentals.html" title="GLib Fundamentals">
42
42
</tr>
43
43
<tr><td colspan="5" class="shortcuts">
44
44
<a href="#glib-File-Utilities.synopsis" class="shortcut">Top</a>
45
 
                   | 
46
 
                  <a href="#glib-File-Utilities.description" class="shortcut">Description</a>
 
45
                 | 
 
46
                <a href="#glib-File-Utilities.description" class="shortcut">Description</a>
47
47
</td></tr>
48
48
</table>
49
49
<div class="refentry" title="File Utilities">
58
58
<div class="refsynopsisdiv" title="Synopsis">
59
59
<a name="glib-File-Utilities.synopsis"></a><h2>Synopsis</h2>
60
60
<pre class="synopsis">
 
61
 
61
62
#include &lt;glib.h&gt;
62
63
#include &lt;glib/gstdio.h&gt;
63
64
 
64
65
enum                <a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError">GFileError</a>;
65
 
#define             <a class="link" href="glib-File-Utilities.html#G-FILE-ERROR:CAPS" title="G_FILE_ERROR">G_FILE_ERROR</a>
 
66
#define             <a class="link" href="glib-File-Utilities.html#G-FILE-ERROR--CAPS" title="G_FILE_ERROR">G_FILE_ERROR</a>
66
67
enum                <a class="link" href="glib-File-Utilities.html#GFileTest" title="enum GFileTest">GFileTest</a>;
67
 
<a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError"><span class="returnvalue">GFileError</span></a>          <a class="link" href="glib-File-Utilities.html#g-file-error-from-errno" title="g_file_error_from_errno ()">g_file_error_from_errno</a>             (<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> err_no);
68
 
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-File-Utilities.html#g-file-get-contents" title="g_file_get_contents ()">g_file_get_contents</a>                 (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
69
 
                                                         <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **contents,
70
 
                                                         <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> *length,
71
 
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);
72
 
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-File-Utilities.html#g-file-set-contents" title="g_file_set_contents ()">g_file_set_contents</a>                 (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
73
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *contents,
74
 
                                                         <a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> length,
75
 
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);
76
 
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-File-Utilities.html#g-file-test" title="g_file_test ()">g_file_test</a>                         (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
77
 
                                                         <a class="link" href="glib-File-Utilities.html#GFileTest" title="enum GFileTest"><span class="returnvalue">GFileTest</span></a> test);
78
 
<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>                <a class="link" href="glib-File-Utilities.html#g-mkstemp" title="g_mkstemp ()">g_mkstemp</a>                           (<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *tmpl);
79
 
<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>                <a class="link" href="glib-File-Utilities.html#g-mkstemp-full" title="g_mkstemp_full ()">g_mkstemp_full</a>                      (<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *tmpl,
80
 
                                                         <span class="returnvalue">int</span> flags,
81
 
                                                         <span class="returnvalue">int</span> mode);
82
 
<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>                <a class="link" href="glib-File-Utilities.html#g-file-open-tmp" title="g_file_open_tmp ()">g_file_open_tmp</a>                     (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *tmpl,
83
 
                                                         <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **name_used,
84
 
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);
85
 
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="glib-File-Utilities.html#g-file-read-link" title="g_file_read_link ()">g_file_read_link</a>                    (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
86
 
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);
87
 
<span class="returnvalue">int</span>                 <a class="link" href="glib-File-Utilities.html#g-mkdir-with-parents" title="g_mkdir_with_parents ()">g_mkdir_with_parents</a>                (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *pathname,
88
 
                                                         <span class="returnvalue">int</span> mode);
 
68
<a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError">GFileError</a>          <a class="link" href="glib-File-Utilities.html#g-file-error-from-errno" title="g_file_error_from_errno ()">g_file_error_from_errno</a>             (<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> err_no);
 
69
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            <a class="link" href="glib-File-Utilities.html#g-file-get-contents" title="g_file_get_contents ()">g_file_get_contents</a>                 (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
70
                                                         <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> **contents,
 
71
                                                         <a class="link" href="glib-Basic-Types.html#gsize" title="gsize">gsize</a> *length,
 
72
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);
 
73
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            <a class="link" href="glib-File-Utilities.html#g-file-set-contents" title="g_file_set_contents ()">g_file_set_contents</a>                 (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
74
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *contents,
 
75
                                                         <a class="link" href="glib-Basic-Types.html#gssize" title="gssize">gssize</a> length,
 
76
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);
 
77
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            <a class="link" href="glib-File-Utilities.html#g-file-test" title="g_file_test ()">g_file_test</a>                         (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
78
                                                         <a class="link" href="glib-File-Utilities.html#GFileTest" title="enum GFileTest">GFileTest</a> test);
 
79
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a>                <a class="link" href="glib-File-Utilities.html#g-mkstemp" title="g_mkstemp ()">g_mkstemp</a>                           (<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *tmpl);
 
80
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a>                <a class="link" href="glib-File-Utilities.html#g-mkstemp-full" title="g_mkstemp_full ()">g_mkstemp_full</a>                      (<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *tmpl,
 
81
                                                         int flags,
 
82
                                                         int mode);
 
83
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a>                <a class="link" href="glib-File-Utilities.html#g-file-open-tmp" title="g_file_open_tmp ()">g_file_open_tmp</a>                     (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *tmpl,
 
84
                                                         <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> **name_used,
 
85
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);
 
86
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *             <a class="link" href="glib-File-Utilities.html#g-file-read-link" title="g_file_read_link ()">g_file_read_link</a>                    (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
87
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);
 
88
int                 <a class="link" href="glib-File-Utilities.html#g-mkdir-with-parents" title="g_mkdir_with_parents ()">g_mkdir_with_parents</a>                (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *pathname,
 
89
                                                         int mode);
89
90
 
90
91
                    <a class="link" href="glib-File-Utilities.html#GDir" title="GDir">GDir</a>;
91
 
<a class="link" href="glib-File-Utilities.html#GDir" title="GDir"><span class="returnvalue">GDir</span></a> *              <a class="link" href="glib-File-Utilities.html#g-dir-open" title="g_dir_open ()">g_dir_open</a>                          (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *path,
92
 
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> flags,
93
 
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);
94
 
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="glib-File-Utilities.html#g-dir-read-name" title="g_dir_read_name ()">g_dir_read_name</a>                     (<a class="link" href="glib-File-Utilities.html#GDir" title="GDir"><span class="returnvalue">GDir</span></a> *dir);
95
 
<span class="returnvalue">void</span>                <a class="link" href="glib-File-Utilities.html#g-dir-rewind" title="g_dir_rewind ()">g_dir_rewind</a>                        (<a class="link" href="glib-File-Utilities.html#GDir" title="GDir"><span class="returnvalue">GDir</span></a> *dir);
96
 
<span class="returnvalue">void</span>                <a class="link" href="glib-File-Utilities.html#g-dir-close" title="g_dir_close ()">g_dir_close</a>                         (<a class="link" href="glib-File-Utilities.html#GDir" title="GDir"><span class="returnvalue">GDir</span></a> *dir);
 
92
<a class="link" href="glib-File-Utilities.html#GDir" title="GDir">GDir</a> *              <a class="link" href="glib-File-Utilities.html#g-dir-open" title="g_dir_open ()">g_dir_open</a>                          (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *path,
 
93
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> flags,
 
94
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);
 
95
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *       <a class="link" href="glib-File-Utilities.html#g-dir-read-name" title="g_dir_read_name ()">g_dir_read_name</a>                     (<a class="link" href="glib-File-Utilities.html#GDir" title="GDir">GDir</a> *dir);
 
96
void                <a class="link" href="glib-File-Utilities.html#g-dir-rewind" title="g_dir_rewind ()">g_dir_rewind</a>                        (<a class="link" href="glib-File-Utilities.html#GDir" title="GDir">GDir</a> *dir);
 
97
void                <a class="link" href="glib-File-Utilities.html#g-dir-close" title="g_dir_close ()">g_dir_close</a>                         (<a class="link" href="glib-File-Utilities.html#GDir" title="GDir">GDir</a> *dir);
97
98
 
98
99
                    <a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile">GMappedFile</a>;
99
 
<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="returnvalue">GMappedFile</span></a> *       <a class="link" href="glib-File-Utilities.html#g-mapped-file-new" title="g_mapped_file_new ()">g_mapped_file_new</a>                   (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
100
 
                                                         <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> writable,
101
 
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);
102
 
<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="returnvalue">GMappedFile</span></a> *       <a class="link" href="glib-File-Utilities.html#g-mapped-file-ref" title="g_mapped_file_ref ()">g_mapped_file_ref</a>                   (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="returnvalue">GMappedFile</span></a> *file);
103
 
<span class="returnvalue">void</span>                <a class="link" href="glib-File-Utilities.html#g-mapped-file-unref" title="g_mapped_file_unref ()">g_mapped_file_unref</a>                 (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="returnvalue">GMappedFile</span></a> *file);
104
 
<span class="returnvalue">void</span>                <a class="link" href="glib-File-Utilities.html#g-mapped-file-free" title="g_mapped_file_free ()">g_mapped_file_free</a>                  (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="returnvalue">GMappedFile</span></a> *file);
105
 
<a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a>               <a class="link" href="glib-File-Utilities.html#g-mapped-file-get-length" title="g_mapped_file_get_length ()">g_mapped_file_get_length</a>            (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="returnvalue">GMappedFile</span></a> *file);
106
 
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="glib-File-Utilities.html#g-mapped-file-get-contents" title="g_mapped_file_get_contents ()">g_mapped_file_get_contents</a>          (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="returnvalue">GMappedFile</span></a> *file);
 
100
<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile">GMappedFile</a> *       <a class="link" href="glib-File-Utilities.html#g-mapped-file-new" title="g_mapped_file_new ()">g_mapped_file_new</a>                   (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
101
                                                         <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> writable,
 
102
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);
 
103
<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile">GMappedFile</a> *       <a class="link" href="glib-File-Utilities.html#g-mapped-file-ref" title="g_mapped_file_ref ()">g_mapped_file_ref</a>                   (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile">GMappedFile</a> *file);
 
104
void                <a class="link" href="glib-File-Utilities.html#g-mapped-file-unref" title="g_mapped_file_unref ()">g_mapped_file_unref</a>                 (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile">GMappedFile</a> *file);
 
105
void                <a class="link" href="glib-File-Utilities.html#g-mapped-file-free" title="g_mapped_file_free ()">g_mapped_file_free</a>                  (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile">GMappedFile</a> *file);
 
106
<a class="link" href="glib-Basic-Types.html#gsize" title="gsize">gsize</a>               <a class="link" href="glib-File-Utilities.html#g-mapped-file-get-length" title="g_mapped_file_get_length ()">g_mapped_file_get_length</a>            (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile">GMappedFile</a> *file);
 
107
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *             <a class="link" href="glib-File-Utilities.html#g-mapped-file-get-contents" title="g_mapped_file_get_contents ()">g_mapped_file_get_contents</a>          (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile">GMappedFile</a> *file);
107
108
 
108
 
<span class="returnvalue">int</span>                 <a class="link" href="glib-File-Utilities.html#g-open" title="g_open ()">g_open</a>                              (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
109
 
                                                         <span class="returnvalue">int</span> flags,
110
 
                                                         <span class="returnvalue">int</span> mode);
111
 
<span class="returnvalue">int</span>                 <a class="link" href="glib-File-Utilities.html#g-rename" title="g_rename ()">g_rename</a>                            (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *oldfilename,
112
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *newfilename);
113
 
<span class="returnvalue">int</span>                 <a class="link" href="glib-File-Utilities.html#g-mkdir" title="g_mkdir ()">g_mkdir</a>                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
114
 
                                                         <span class="returnvalue">int</span> mode);
115
 
<span class="returnvalue">int</span>                 <a class="link" href="glib-File-Utilities.html#g-stat" title="g_stat ()">g_stat</a>                              (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
116
 
                                                         <span class="returnvalue">struct _g_stat_struct</span> *buf);
117
 
<span class="returnvalue">int</span>                 <a class="link" href="glib-File-Utilities.html#g-lstat" title="g_lstat ()">g_lstat</a>                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
118
 
                                                         <span class="returnvalue">struct _g_stat_struct</span> *buf);
119
 
<span class="returnvalue">int</span>                 <a class="link" href="glib-File-Utilities.html#g-unlink" title="g_unlink ()">g_unlink</a>                            (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename);
120
 
<span class="returnvalue">int</span>                 <a class="link" href="glib-File-Utilities.html#g-remove" title="g_remove ()">g_remove</a>                            (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename);
121
 
<span class="returnvalue">int</span>                 <a class="link" href="glib-File-Utilities.html#g-rmdir" title="g_rmdir ()">g_rmdir</a>                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename);
122
 
<span class="returnvalue">FILE</span> *              <a class="link" href="glib-File-Utilities.html#g-fopen" title="g_fopen ()">g_fopen</a>                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
123
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *mode);
124
 
<span class="returnvalue">FILE</span> *              <a class="link" href="glib-File-Utilities.html#g-freopen" title="g_freopen ()">g_freopen</a>                           (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
125
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *mode,
126
 
                                                         <span class="returnvalue">FILE</span> *stream);
127
 
<span class="returnvalue">int</span>                 <a class="link" href="glib-File-Utilities.html#g-chmod" title="g_chmod ()">g_chmod</a>                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
128
 
                                                         <span class="returnvalue">int</span> mode);
129
 
<span class="returnvalue">int</span>                 <a class="link" href="glib-File-Utilities.html#g-access" title="g_access ()">g_access</a>                            (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
130
 
                                                         <span class="returnvalue">int</span> mode);
131
 
<span class="returnvalue">int</span>                 <a class="link" href="glib-File-Utilities.html#g-creat" title="g_creat ()">g_creat</a>                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
132
 
                                                         <span class="returnvalue">int</span> mode);
133
 
<span class="returnvalue">int</span>                 <a class="link" href="glib-File-Utilities.html#g-chdir" title="g_chdir ()">g_chdir</a>                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *path);
134
 
<span class="returnvalue">int</span>                 <a class="link" href="glib-File-Utilities.html#g-utime" title="g_utime ()">g_utime</a>                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
135
 
                                                         <span class="returnvalue">struct utimbuf</span> *utb);
 
109
int                 <a class="link" href="glib-File-Utilities.html#g-open" title="g_open ()">g_open</a>                              (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
110
                                                         int flags,
 
111
                                                         int mode);
 
112
int                 <a class="link" href="glib-File-Utilities.html#g-rename" title="g_rename ()">g_rename</a>                            (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *oldfilename,
 
113
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *newfilename);
 
114
int                 <a class="link" href="glib-File-Utilities.html#g-mkdir" title="g_mkdir ()">g_mkdir</a>                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
115
                                                         int mode);
 
116
int                 <a class="link" href="glib-File-Utilities.html#g-stat" title="g_stat ()">g_stat</a>                              (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
117
                                                         struct _g_stat_struct *buf);
 
118
int                 <a class="link" href="glib-File-Utilities.html#g-lstat" title="g_lstat ()">g_lstat</a>                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
119
                                                         struct _g_stat_struct *buf);
 
120
int                 <a class="link" href="glib-File-Utilities.html#g-unlink" title="g_unlink ()">g_unlink</a>                            (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename);
 
121
int                 <a class="link" href="glib-File-Utilities.html#g-remove" title="g_remove ()">g_remove</a>                            (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename);
 
122
int                 <a class="link" href="glib-File-Utilities.html#g-rmdir" title="g_rmdir ()">g_rmdir</a>                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename);
 
123
FILE *              <a class="link" href="glib-File-Utilities.html#g-fopen" title="g_fopen ()">g_fopen</a>                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
124
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *mode);
 
125
FILE *              <a class="link" href="glib-File-Utilities.html#g-freopen" title="g_freopen ()">g_freopen</a>                           (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
126
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *mode,
 
127
                                                         FILE *stream);
 
128
int                 <a class="link" href="glib-File-Utilities.html#g-chmod" title="g_chmod ()">g_chmod</a>                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
129
                                                         int mode);
 
130
int                 <a class="link" href="glib-File-Utilities.html#g-access" title="g_access ()">g_access</a>                            (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
131
                                                         int mode);
 
132
int                 <a class="link" href="glib-File-Utilities.html#g-creat" title="g_creat ()">g_creat</a>                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
133
                                                         int mode);
 
134
int                 <a class="link" href="glib-File-Utilities.html#g-chdir" title="g_chdir ()">g_chdir</a>                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *path);
 
135
int                 <a class="link" href="glib-File-Utilities.html#g-utime" title="g_utime ()">g_utime</a>                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
136
                                                         struct utimbuf *utb);
136
137
</pre>
137
138
</div>
138
139
<div class="refsect1" title="Description">
216
217
<col align="left" valign="top">
217
218
<tbody>
218
219
<tr>
219
 
<td><p><a name="G-FILE-ERROR-EXIST:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_EXIST</code></span></p></td>
 
220
<td><p><a name="G-FILE-ERROR-EXIST--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_EXIST</code></span></p></td>
220
221
<td>Operation not permitted; only the owner of the
221
222
     file (or other resource) or processes with special privileges can
222
223
     perform the operation.
223
224
</td>
224
225
</tr>
225
226
<tr>
226
 
<td><p><a name="G-FILE-ERROR-ISDIR:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_ISDIR</code></span></p></td>
 
227
<td><p><a name="G-FILE-ERROR-ISDIR--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_ISDIR</code></span></p></td>
227
228
<td>File is a directory; you cannot open a directory
228
229
     for writing, or create or remove hard links to it.
229
230
</td>
230
231
</tr>
231
232
<tr>
232
 
<td><p><a name="G-FILE-ERROR-ACCES:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_ACCES</code></span></p></td>
 
233
<td><p><a name="G-FILE-ERROR-ACCES--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_ACCES</code></span></p></td>
233
234
<td>Permission denied; the file permissions do not
234
235
     allow the attempted operation.
235
236
</td>
236
237
</tr>
237
238
<tr>
238
 
<td><p><a name="G-FILE-ERROR-NAMETOOLONG:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NAMETOOLONG</code></span></p></td>
 
239
<td><p><a name="G-FILE-ERROR-NAMETOOLONG--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NAMETOOLONG</code></span></p></td>
239
240
<td>Filename too long.
240
241
</td>
241
242
</tr>
242
243
<tr>
243
 
<td><p><a name="G-FILE-ERROR-NOENT:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NOENT</code></span></p></td>
 
244
<td><p><a name="G-FILE-ERROR-NOENT--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NOENT</code></span></p></td>
244
245
<td>No such file or directory.  This is a "file
245
246
     doesn't exist" error for ordinary files that are referenced in
246
247
     contexts where they are expected to already exist.
247
248
</td>
248
249
</tr>
249
250
<tr>
250
 
<td><p><a name="G-FILE-ERROR-NOTDIR:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NOTDIR</code></span></p></td>
 
251
<td><p><a name="G-FILE-ERROR-NOTDIR--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NOTDIR</code></span></p></td>
251
252
<td>A file that isn't a directory was specified when
252
253
     a directory is required.
253
254
</td>
254
255
</tr>
255
256
<tr>
256
 
<td><p><a name="G-FILE-ERROR-NXIO:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NXIO</code></span></p></td>
 
257
<td><p><a name="G-FILE-ERROR-NXIO--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NXIO</code></span></p></td>
257
258
<td>No such device or address.  The system tried to
258
259
     use the device represented by a file you specified, and it
259
260
     couldn't find the device.  This can mean that the device file was
262
263
</td>
263
264
</tr>
264
265
<tr>
265
 
<td><p><a name="G-FILE-ERROR-NODEV:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NODEV</code></span></p></td>
 
266
<td><p><a name="G-FILE-ERROR-NODEV--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NODEV</code></span></p></td>
266
267
<td>This file is of a type that doesn't support
267
268
     mapping.
268
269
</td>
269
270
</tr>
270
271
<tr>
271
 
<td><p><a name="G-FILE-ERROR-ROFS:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_ROFS</code></span></p></td>
 
272
<td><p><a name="G-FILE-ERROR-ROFS--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_ROFS</code></span></p></td>
272
273
<td>The directory containing the new link can't be
273
274
          modified because it's on a read-only file system.
274
275
</td>
275
276
</tr>
276
277
<tr>
277
 
<td><p><a name="G-FILE-ERROR-TXTBSY:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_TXTBSY</code></span></p></td>
 
278
<td><p><a name="G-FILE-ERROR-TXTBSY--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_TXTBSY</code></span></p></td>
278
279
<td>Text file busy.
279
280
</td>
280
281
</tr>
281
282
<tr>
282
 
<td><p><a name="G-FILE-ERROR-FAULT:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_FAULT</code></span></p></td>
 
283
<td><p><a name="G-FILE-ERROR-FAULT--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_FAULT</code></span></p></td>
283
284
<td>You passed in a pointer to bad memory.
284
285
  (GLib won't reliably return this, don't pass in pointers to bad
285
286
  memory.)
286
287
</td>
287
288
</tr>
288
289
<tr>
289
 
<td><p><a name="G-FILE-ERROR-LOOP:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_LOOP</code></span></p></td>
 
290
<td><p><a name="G-FILE-ERROR-LOOP--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_LOOP</code></span></p></td>
290
291
<td>Too many levels of symbolic links were encountered
291
292
  in looking up a file name.  This often indicates a cycle of symbolic
292
293
  links.
293
294
</td>
294
295
</tr>
295
296
<tr>
296
 
<td><p><a name="G-FILE-ERROR-NOSPC:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NOSPC</code></span></p></td>
 
297
<td><p><a name="G-FILE-ERROR-NOSPC--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NOSPC</code></span></p></td>
297
298
<td>No space left on device; write operation on a
298
299
  file failed because the disk is full.
299
300
</td>
300
301
</tr>
301
302
<tr>
302
 
<td><p><a name="G-FILE-ERROR-NOMEM:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NOMEM</code></span></p></td>
 
303
<td><p><a name="G-FILE-ERROR-NOMEM--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NOMEM</code></span></p></td>
303
304
<td>No memory available.  The system cannot allocate
304
305
     more virtual memory because its capacity is full.
305
306
</td>
306
307
</tr>
307
308
<tr>
308
 
<td><p><a name="G-FILE-ERROR-MFILE:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_MFILE</code></span></p></td>
 
309
<td><p><a name="G-FILE-ERROR-MFILE--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_MFILE</code></span></p></td>
309
310
<td>The current process has too many files open and
310
311
     can't open any more.  Duplicate descriptors do count toward this
311
312
     limit.
312
313
</td>
313
314
</tr>
314
315
<tr>
315
 
<td><p><a name="G-FILE-ERROR-NFILE:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NFILE</code></span></p></td>
 
316
<td><p><a name="G-FILE-ERROR-NFILE--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NFILE</code></span></p></td>
316
317
<td>There are too many distinct file openings in the
317
318
     entire system.
318
319
</td>
319
320
</tr>
320
321
<tr>
321
 
<td><p><a name="G-FILE-ERROR-BADF:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_BADF</code></span></p></td>
 
322
<td><p><a name="G-FILE-ERROR-BADF--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_BADF</code></span></p></td>
322
323
<td>Bad file descriptor; for example, I/O on a
323
324
     descriptor that has been closed or reading from a descriptor open
324
325
     only for writing (or vice versa).
325
326
</td>
326
327
</tr>
327
328
<tr>
328
 
<td><p><a name="G-FILE-ERROR-INVAL:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_INVAL</code></span></p></td>
 
329
<td><p><a name="G-FILE-ERROR-INVAL--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_INVAL</code></span></p></td>
329
330
<td>Invalid argument.  This is used to indicate
330
331
     various kinds of problems with passing the wrong argument to a
331
332
     library function.
332
333
</td>
333
334
</tr>
334
335
<tr>
335
 
<td><p><a name="G-FILE-ERROR-PIPE:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_PIPE</code></span></p></td>
 
336
<td><p><a name="G-FILE-ERROR-PIPE--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_PIPE</code></span></p></td>
336
337
<td>Broken pipe; there is no process reading from the
337
338
     other end of a pipe.  Every library function that returns this
338
339
     error code also generates a `SIGPIPE' signal; this signal
342
343
</td>
343
344
</tr>
344
345
<tr>
345
 
<td><p><a name="G-FILE-ERROR-AGAIN:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_AGAIN</code></span></p></td>
 
346
<td><p><a name="G-FILE-ERROR-AGAIN--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_AGAIN</code></span></p></td>
346
347
<td>Resource temporarily unavailable; the call might
347
348
     work if you try again later.
348
349
</td>
349
350
</tr>
350
351
<tr>
351
 
<td><p><a name="G-FILE-ERROR-INTR:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_INTR</code></span></p></td>
 
352
<td><p><a name="G-FILE-ERROR-INTR--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_INTR</code></span></p></td>
352
353
<td>Interrupted function call; an asynchronous signal
353
354
     occurred and prevented completion of the call.  When this
354
355
     happens, you should try the call again.
355
356
</td>
356
357
</tr>
357
358
<tr>
358
 
<td><p><a name="G-FILE-ERROR-IO:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_IO</code></span></p></td>
 
359
<td><p><a name="G-FILE-ERROR-IO--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_IO</code></span></p></td>
359
360
<td>Input/output error; usually used for physical read
360
361
    or write errors. i.e. the disk or other physical device hardware
361
362
    is returning errors.
362
363
</td>
363
364
</tr>
364
365
<tr>
365
 
<td><p><a name="G-FILE-ERROR-PERM:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_PERM</code></span></p></td>
 
366
<td><p><a name="G-FILE-ERROR-PERM--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_PERM</code></span></p></td>
366
367
<td>Operation not permitted; only the owner of the
367
368
     file (or other resource) or processes with special privileges can
368
369
     perform the operation.
369
370
</td>
370
371
</tr>
371
372
<tr>
372
 
<td><p><a name="G-FILE-ERROR-NOSYS:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NOSYS</code></span></p></td>
 
373
<td><p><a name="G-FILE-ERROR-NOSYS--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_NOSYS</code></span></p></td>
373
374
<td>Function not implemented; this indicates that the
374
375
    system is missing some functionality.
375
376
</td>
376
377
</tr>
377
378
<tr>
378
 
<td><p><a name="G-FILE-ERROR-FAILED:CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_FAILED</code></span></p></td>
 
379
<td><p><a name="G-FILE-ERROR-FAILED--CAPS"></a><span class="term"><code class="literal">G_FILE_ERROR_FAILED</code></span></p></td>
379
380
<td>Does not correspond to a UNIX error code; this
380
381
  is the standard "failed for unspecified reason" error code present in
381
382
  all <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> error code enumerations. Returned if no specific
387
388
</div>
388
389
<hr>
389
390
<div class="refsect2" title="G_FILE_ERROR">
390
 
<a name="G-FILE-ERROR:CAPS"></a><h3>G_FILE_ERROR</h3>
391
 
<pre class="programlisting">#define             G_FILE_ERROR</pre>
 
391
<a name="G-FILE-ERROR--CAPS"></a><h3>G_FILE_ERROR</h3>
 
392
<pre class="programlisting">#define G_FILE_ERROR g_file_error_quark ()
 
393
</pre>
392
394
<p>
393
395
Error domain for file operations. Errors in this domain will
394
396
be from the <a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError"><span class="type">GFileError</span></a> enumeration. See <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> for information on
414
416
<col align="left" valign="top">
415
417
<tbody>
416
418
<tr>
417
 
<td><p><a name="G-FILE-TEST-IS-REGULAR:CAPS"></a><span class="term"><code class="literal">G_FILE_TEST_IS_REGULAR</code></span></p></td>
418
 
<td>
419
 
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the file is a regular file (not a directory).
420
 
    Note that this test will also return <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the tested file is a symlink
 
419
<td><p><a name="G-FILE-TEST-IS-REGULAR--CAPS"></a><span class="term"><code class="literal">G_FILE_TEST_IS_REGULAR</code></span></p></td>
 
420
<td>%TRUE if the file is a regular file (not a directory).
 
421
    Note that this test will also return <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the tested file is a symlink
421
422
    to a regular file.
422
423
</td>
423
424
</tr>
424
425
<tr>
425
 
<td><p><a name="G-FILE-TEST-IS-SYMLINK:CAPS"></a><span class="term"><code class="literal">G_FILE_TEST_IS_SYMLINK</code></span></p></td>
426
 
<td>
427
 
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the file is a symlink.
428
 
</td>
429
 
</tr>
430
 
<tr>
431
 
<td><p><a name="G-FILE-TEST-IS-DIR:CAPS"></a><span class="term"><code class="literal">G_FILE_TEST_IS_DIR</code></span></p></td>
432
 
<td>
433
 
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the file is a directory.
434
 
</td>
435
 
</tr>
436
 
<tr>
437
 
<td><p><a name="G-FILE-TEST-IS-EXECUTABLE:CAPS"></a><span class="term"><code class="literal">G_FILE_TEST_IS_EXECUTABLE</code></span></p></td>
438
 
<td>
439
 
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the file is executable.
440
 
</td>
441
 
</tr>
442
 
<tr>
443
 
<td><p><a name="G-FILE-TEST-EXISTS:CAPS"></a><span class="term"><code class="literal">G_FILE_TEST_EXISTS</code></span></p></td>
444
 
<td>
445
 
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the file exists. 
 
426
<td><p><a name="G-FILE-TEST-IS-SYMLINK--CAPS"></a><span class="term"><code class="literal">G_FILE_TEST_IS_SYMLINK</code></span></p></td>
 
427
<td>%TRUE if the file is a symlink.
 
428
</td>
 
429
</tr>
 
430
<tr>
 
431
<td><p><a name="G-FILE-TEST-IS-DIR--CAPS"></a><span class="term"><code class="literal">G_FILE_TEST_IS_DIR</code></span></p></td>
 
432
<td>%TRUE if the file is a directory.
 
433
</td>
 
434
</tr>
 
435
<tr>
 
436
<td><p><a name="G-FILE-TEST-IS-EXECUTABLE--CAPS"></a><span class="term"><code class="literal">G_FILE_TEST_IS_EXECUTABLE</code></span></p></td>
 
437
<td>%TRUE if the file is executable.
 
438
</td>
 
439
</tr>
 
440
<tr>
 
441
<td><p><a name="G-FILE-TEST-EXISTS--CAPS"></a><span class="term"><code class="literal">G_FILE_TEST_EXISTS</code></span></p></td>
 
442
<td>%TRUE if the file exists. 
446
443
    It may or may not be a regular file.
447
444
</td>
448
445
</tr>
452
449
<hr>
453
450
<div class="refsect2" title="g_file_error_from_errno ()">
454
451
<a name="g-file-error-from-errno"></a><h3>g_file_error_from_errno ()</h3>
455
 
<pre class="programlisting"><a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError"><span class="returnvalue">GFileError</span></a>          g_file_error_from_errno             (<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> err_no);</pre>
 
452
<pre class="programlisting"><a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError">GFileError</a>          g_file_error_from_errno             (<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> err_no);</pre>
456
453
<p>
457
454
Gets a <a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError"><span class="type">GFileError</span></a> constant based on the passed-in <em class="parameter"><code>errno</code></em>.
458
455
For example, if you pass in <code class="literal">EEXIST</code> this function returns
459
 
<a class="link" href="glib-File-Utilities.html#G-FILE-ERROR-EXIST:CAPS"><span class="type">G_FILE_ERROR_EXIST</span></a>. Unlike <em class="parameter"><code>errno</code></em> values, you can portably
 
456
<a class="link" href="glib-File-Utilities.html#G-FILE-ERROR-EXIST--CAPS"><span class="type">G_FILE_ERROR_EXIST</span></a>. Unlike <em class="parameter"><code>errno</code></em> values, you can portably
460
457
assume that all <a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError"><span class="type">GFileError</span></a> values will exist.
461
458
</p>
462
459
<p>
463
460
Normally a <a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError"><span class="type">GFileError</span></a> value goes into a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> returned
464
461
from a function that manipulates files. So you would use
465
462
<a class="link" href="glib-File-Utilities.html#g-file-error-from-errno" title="g_file_error_from_errno ()"><code class="function">g_file_error_from_errno()</code></a> when constructing a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>.</p>
 
463
<p>
 
464
</p>
466
465
<div class="variablelist"><table border="0">
467
466
<col align="left" valign="top">
468
467
<tbody>
482
481
<hr>
483
482
<div class="refsect2" title="g_file_get_contents ()">
484
483
<a name="g-file-get-contents"></a><h3>g_file_get_contents ()</h3>
485
 
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_file_get_contents                 (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
486
 
                                                         <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **contents,
487
 
                                                         <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> *length,
488
 
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);</pre>
 
484
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            g_file_get_contents                 (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
485
                                                         <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> **contents,
 
486
                                                         <a class="link" href="glib-Basic-Types.html#gsize" title="gsize">gsize</a> *length,
 
487
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);</pre>
489
488
<p>
490
489
Reads an entire file into allocated memory, with good error
491
490
checking.
492
491
</p>
493
492
<p>
494
 
If the call was successful, it returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> and sets <em class="parameter"><code>contents</code></em> to the file
 
493
If the call was successful, it returns <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> and sets <em class="parameter"><code>contents</code></em> to the file
495
494
contents and <em class="parameter"><code>length</code></em> to the length of the file contents in bytes. The string
496
495
stored in <em class="parameter"><code>contents</code></em> will be nul-terminated, so for text files you can pass
497
 
<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> for the <em class="parameter"><code>length</code></em> argument. If the call was not successful, it returns
498
 
<a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> and sets <em class="parameter"><code>error</code></em>. The error domain is <a class="link" href="glib-File-Utilities.html#G-FILE-ERROR:CAPS" title="G_FILE_ERROR"><span class="type">G_FILE_ERROR</span></a>. Possible error
 
496
<a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> for the <em class="parameter"><code>length</code></em> argument. If the call was not successful, it returns
 
497
<a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a> and sets <em class="parameter"><code>error</code></em>. The error domain is <a class="link" href="glib-File-Utilities.html#G-FILE-ERROR--CAPS" title="G_FILE_ERROR"><span class="type">G_FILE_ERROR</span></a>. Possible error
499
498
codes are those in the <a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError"><span class="type">GFileError</span></a> enumeration. In the error case,
500
 
<em class="parameter"><code>contents</code></em> is set to <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> and <em class="parameter"><code>length</code></em> is set to zero.</p>
 
499
<em class="parameter"><code>contents</code></em> is set to <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> and <em class="parameter"><code>length</code></em> is set to zero.</p>
 
500
<p>
 
501
</p>
501
502
<div class="variablelist"><table border="0">
502
503
<col align="left" valign="top">
503
504
<tbody>
514
515
</tr>
515
516
<tr>
516
517
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
517
 
<td> location to store length in bytes of the contents, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
 
518
<td> location to store length in bytes of the contents, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>
518
519
</td>
519
520
</tr>
520
521
<tr>
521
522
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
522
 
<td> return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
 
523
<td> return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>
523
524
</td>
524
525
</tr>
525
526
<tr>
526
527
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
527
 
<td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> on success, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> if an error occurred
 
528
<td> <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> on success, <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a> if an error occurred
528
529
</td>
529
530
</tr>
530
531
</tbody>
533
534
<hr>
534
535
<div class="refsect2" title="g_file_set_contents ()">
535
536
<a name="g-file-set-contents"></a><h3>g_file_set_contents ()</h3>
536
 
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_file_set_contents                 (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
537
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *contents,
538
 
                                                         <a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> length,
539
 
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);</pre>
 
537
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            g_file_set_contents                 (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
538
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *contents,
 
539
                                                         <a class="link" href="glib-Basic-Types.html#gssize" title="gssize">gssize</a> length,
 
540
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);</pre>
540
541
<p>
541
542
Writes all of <em class="parameter"><code>contents</code></em> to a file named <em class="parameter"><code>filename</code></em>, with good error checking.
542
543
If a file called <em class="parameter"><code>filename</code></em> already exists it will be overwritten.
566
567
<p>
567
568
</p>
568
569
<p>
569
 
If the call was sucessful, it returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>. If the call was not successful,
570
 
it returns <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> and sets <em class="parameter"><code>error</code></em>. The error domain is <a class="link" href="glib-File-Utilities.html#G-FILE-ERROR:CAPS" title="G_FILE_ERROR"><span class="type">G_FILE_ERROR</span></a>.
 
570
If the call was sucessful, it returns <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a>. If the call was not successful,
 
571
it returns <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a> and sets <em class="parameter"><code>error</code></em>. The error domain is <a class="link" href="glib-File-Utilities.html#G-FILE-ERROR--CAPS" title="G_FILE_ERROR"><span class="type">G_FILE_ERROR</span></a>.
571
572
Possible error codes are those in the <a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError"><span class="type">GFileError</span></a> enumeration.</p>
 
573
<p>
 
574
</p>
572
575
<div class="variablelist"><table border="0">
573
576
<col align="left" valign="top">
574
577
<tbody>
590
593
</tr>
591
594
<tr>
592
595
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
593
 
<td> return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
 
596
<td> return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>
594
597
</td>
595
598
</tr>
596
599
<tr>
597
600
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
598
 
<td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> on success, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> if an error occurred
 
601
<td> <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> on success, <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a> if an error occurred
599
602
 
600
603
</td>
601
604
</tr>
606
609
<hr>
607
610
<div class="refsect2" title="g_file_test ()">
608
611
<a name="g-file-test"></a><h3>g_file_test ()</h3>
609
 
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_file_test                         (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
610
 
                                                         <a class="link" href="glib-File-Utilities.html#GFileTest" title="enum GFileTest"><span class="returnvalue">GFileTest</span></a> test);</pre>
 
612
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            g_file_test                         (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
613
                                                         <a class="link" href="glib-File-Utilities.html#GFileTest" title="enum GFileTest">GFileTest</a> test);</pre>
611
614
<p>
612
 
Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if any of the tests in the bitfield <em class="parameter"><code>test</code></em> are
613
 
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>. For example, <code class="literal">(G_FILE_TEST_EXISTS | 
614
 
G_FILE_TEST_IS_DIR)</code> will return <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the file exists; 
 
615
Returns <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if any of the tests in the bitfield <em class="parameter"><code>test</code></em> are
 
616
<a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a>. For example, <code class="literal">(G_FILE_TEST_EXISTS | 
 
617
G_FILE_TEST_IS_DIR)</code> will return <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the file exists; 
615
618
the check whether it's a directory doesn't matter since the existence 
616
 
test is <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>. With the current set of available tests, there's no point
 
619
test is <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a>. With the current set of available tests, there's no point
617
620
passing in more than one test at a time.
618
621
</p>
619
622
<p>
620
 
Apart from <a class="link" href="glib-File-Utilities.html#G-FILE-TEST-IS-SYMLINK:CAPS"><code class="literal">G_FILE_TEST_IS_SYMLINK</code></a> all tests follow symbolic links,
 
623
Apart from <a class="link" href="glib-File-Utilities.html#G-FILE-TEST-IS-SYMLINK--CAPS"><code class="literal">G_FILE_TEST_IS_SYMLINK</code></a> all tests follow symbolic links,
621
624
so for a symbolic link to a regular file <a class="link" href="glib-File-Utilities.html#g-file-test" title="g_file_test ()"><code class="function">g_file_test()</code></a> will return
622
 
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> for both <a class="link" href="glib-File-Utilities.html#G-FILE-TEST-IS-SYMLINK:CAPS"><code class="literal">G_FILE_TEST_IS_SYMLINK</code></a> and <a class="link" href="glib-File-Utilities.html#G-FILE-TEST-IS-REGULAR:CAPS"><code class="literal">G_FILE_TEST_IS_REGULAR</code></a>.
 
625
<a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> for both <a class="link" href="glib-File-Utilities.html#G-FILE-TEST-IS-SYMLINK--CAPS"><code class="literal">G_FILE_TEST_IS_SYMLINK</code></a> and <a class="link" href="glib-File-Utilities.html#G-FILE-TEST-IS-REGULAR--CAPS"><code class="literal">G_FILE_TEST_IS_REGULAR</code></a>.
623
626
</p>
624
627
<p>
625
628
Note, that for a dangling symbolic link <a class="link" href="glib-File-Utilities.html#g-file-test" title="g_file_test ()"><code class="function">g_file_test()</code></a> will return
626
 
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> for <a class="link" href="glib-File-Utilities.html#G-FILE-TEST-IS-SYMLINK:CAPS"><code class="literal">G_FILE_TEST_IS_SYMLINK</code></a> and <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> for all other flags.
 
629
<a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> for <a class="link" href="glib-File-Utilities.html#G-FILE-TEST-IS-SYMLINK--CAPS"><code class="literal">G_FILE_TEST_IS_SYMLINK</code></a> and <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a> for all other flags.
627
630
</p>
628
631
<p>
629
632
You should never use <a class="link" href="glib-File-Utilities.html#g-file-test" title="g_file_test ()"><code class="function">g_file_test()</code></a> to test whether it is safe
630
633
to perform an operation, because there is always the possibility
631
634
of the condition changing before you actually perform the operation.
632
 
For example, you might think you could use <a class="link" href="glib-File-Utilities.html#G-FILE-TEST-IS-SYMLINK:CAPS"><code class="literal">G_FILE_TEST_IS_SYMLINK</code></a>
 
635
For example, you might think you could use <a class="link" href="glib-File-Utilities.html#G-FILE-TEST-IS-SYMLINK--CAPS"><code class="literal">G_FILE_TEST_IS_SYMLINK</code></a>
633
636
to know whether it is safe to write to a file without being
634
637
tricked into writing into a different location. It doesn't work!
635
638
</p>
644
647
<p>
645
648
</p>
646
649
<p>
647
 
Another thing to note is that <a class="link" href="glib-File-Utilities.html#G-FILE-TEST-EXISTS:CAPS"><code class="literal">G_FILE_TEST_EXISTS</code></a> and
648
 
<a class="link" href="glib-File-Utilities.html#G-FILE-TEST-IS-EXECUTABLE:CAPS"><code class="literal">G_FILE_TEST_IS_EXECUTABLE</code></a> are implemented using the <code class="function">access()</code>
 
650
Another thing to note is that <a class="link" href="glib-File-Utilities.html#G-FILE-TEST-EXISTS--CAPS"><code class="literal">G_FILE_TEST_EXISTS</code></a> and
 
651
<a class="link" href="glib-File-Utilities.html#G-FILE-TEST-IS-EXECUTABLE--CAPS"><code class="literal">G_FILE_TEST_IS_EXECUTABLE</code></a> are implemented using the <code class="function">access()</code>
649
652
system call. This usually doesn't matter, but if your program
650
653
is setuid or setgid it means that these tests will give you
651
654
the answer for the real user ID and group ID, rather than the
653
656
</p>
654
657
<p>
655
658
On Windows, there are no symlinks, so testing for
656
 
<a class="link" href="glib-File-Utilities.html#G-FILE-TEST-IS-SYMLINK:CAPS"><code class="literal">G_FILE_TEST_IS_SYMLINK</code></a> will always return <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a>. Testing for
657
 
<a class="link" href="glib-File-Utilities.html#G-FILE-TEST-IS-EXECUTABLE:CAPS"><code class="literal">G_FILE_TEST_IS_EXECUTABLE</code></a> will just check that the file exists and
 
659
<a class="link" href="glib-File-Utilities.html#G-FILE-TEST-IS-SYMLINK--CAPS"><code class="literal">G_FILE_TEST_IS_SYMLINK</code></a> will always return <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a>. Testing for
 
660
<a class="link" href="glib-File-Utilities.html#G-FILE-TEST-IS-EXECUTABLE--CAPS"><code class="literal">G_FILE_TEST_IS_EXECUTABLE</code></a> will just check that the file exists and
658
661
its name indicates that it is executable, checking for well-known
659
662
extensions and those listed in the <code class="literal">PATHEXT</code> environment variable.</p>
 
663
<p>
 
664
</p>
660
665
<div class="variablelist"><table border="0">
661
666
<col align="left" valign="top">
662
667
<tbody>
672
677
</tr>
673
678
<tr>
674
679
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
675
 
<td> whether a test was <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>
 
680
<td> whether a test was <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a>
676
681
</td>
677
682
</tr>
678
683
</tbody>
681
686
<hr>
682
687
<div class="refsect2" title="g_mkstemp ()">
683
688
<a name="g-mkstemp"></a><h3>g_mkstemp ()</h3>
684
 
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>                g_mkstemp                           (<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *tmpl);</pre>
 
689
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a>                g_mkstemp                           (<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *tmpl);</pre>
685
690
<p>
686
691
Opens a temporary file. See the <code class="function">mkstemp()</code> documentation
687
692
on most UNIX-like systems. 
695
700
be modified to form the name of a file that didn't exist.
696
701
The string should be in the GLib file name encoding. Most importantly, 
697
702
on Windows it should be in UTF-8.</p>
 
703
<p>
 
704
</p>
698
705
<div class="variablelist"><table border="0">
699
706
<col align="left" valign="top">
700
707
<tbody>
717
724
<hr>
718
725
<div class="refsect2" title="g_mkstemp_full ()">
719
726
<a name="g-mkstemp-full"></a><h3>g_mkstemp_full ()</h3>
720
 
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>                g_mkstemp_full                      (<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *tmpl,
721
 
                                                         <span class="returnvalue">int</span> flags,
722
 
                                                         <span class="returnvalue">int</span> mode);</pre>
 
727
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a>                g_mkstemp_full                      (<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *tmpl,
 
728
                                                         int flags,
 
729
                                                         int mode);</pre>
723
730
<p>
724
731
Opens a temporary file. See the <code class="function">mkstemp()</code> documentation
725
732
on most UNIX-like systems.
733
740
string will be modified to form the name of a file that didn't exist.
734
741
The string should be in the GLib file name encoding. Most importantly,
735
742
on Windows it should be in UTF-8.</p>
 
743
<p>
 
744
</p>
736
745
<div class="variablelist"><table border="0">
737
746
<col align="left" valign="top">
738
747
<tbody>
767
776
<hr>
768
777
<div class="refsect2" title="g_file_open_tmp ()">
769
778
<a name="g-file-open-tmp"></a><h3>g_file_open_tmp ()</h3>
770
 
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>                g_file_open_tmp                     (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *tmpl,
771
 
                                                         <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **name_used,
772
 
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);</pre>
 
779
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a>                g_file_open_tmp                     (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *tmpl,
 
780
                                                         <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> **name_used,
 
781
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);</pre>
773
782
<p>
774
783
Opens a file for writing in the preferred directory for temporary
775
784
files (as returned by <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-tmp-dir" title="g_get_tmp_dir ()"><code class="function">g_get_tmp_dir()</code></a>). 
779
788
a sequence of six 'X' characters, as the parameter to <a class="link" href="glib-File-Utilities.html#g-mkstemp" title="g_mkstemp ()"><code class="function">g_mkstemp()</code></a>.
780
789
However, unlike these functions, the template should only be a
781
790
basename, no directory components are allowed. If template is
782
 
<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, a default template is used.
 
791
<a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>, a default template is used.
783
792
</p>
784
793
<p>
785
794
Note that in contrast to <a class="link" href="glib-File-Utilities.html#g-mkstemp" title="g_mkstemp ()"><code class="function">g_mkstemp()</code></a> (and <code class="function">mkstemp()</code>) 
786
795
<em class="parameter"><code>tmpl</code></em> is not modified, and might thus be a read-only literal string.
787
796
</p>
788
797
<p>
789
 
The actual name used is returned in <em class="parameter"><code>name_used</code></em> if non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. This
 
798
The actual name used is returned in <em class="parameter"><code>name_used</code></em> if non-<a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>. This
790
799
string should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a> when not needed any longer.
791
800
The returned name is in the GLib file name encoding.</p>
 
801
<p>
 
802
</p>
792
803
<div class="variablelist"><table border="0">
793
804
<col align="left" valign="top">
794
805
<tbody>
795
806
<tr>
796
807
<td><p><span class="term"><em class="parameter"><code>tmpl</code></em> :</span></p></td>
797
808
<td> Template for file name, as in <a class="link" href="glib-File-Utilities.html#g-mkstemp" title="g_mkstemp ()"><code class="function">g_mkstemp()</code></a>, basename only,
798
 
       or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, to a default template
 
809
       or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>, to a default template
799
810
</td>
800
811
</tr>
801
812
<tr>
802
813
<td><p><span class="term"><em class="parameter"><code>name_used</code></em> :</span></p></td>
803
 
<td> location to store actual name used, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
 
814
<td> location to store actual name used, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>
804
815
</td>
805
816
</tr>
806
817
<tr>
823
834
<hr>
824
835
<div class="refsect2" title="g_file_read_link ()">
825
836
<a name="g-file-read-link"></a><h3>g_file_read_link ()</h3>
826
 
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             g_file_read_link                    (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
827
 
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);</pre>
 
837
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *             g_file_read_link                    (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
838
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);</pre>
828
839
<p>
829
840
Reads the contents of the symbolic link <em class="parameter"><code>filename</code></em> like the POSIX
830
841
<code class="function">readlink()</code> function.  The returned string is in the encoding used
831
842
for filenames. Use <a class="link" href="glib-Character-Set-Conversion.html#g-filename-to-utf8" title="g_filename_to_utf8 ()"><code class="function">g_filename_to_utf8()</code></a> to convert it to UTF-8.</p>
 
843
<p>
 
844
</p>
832
845
<div class="variablelist"><table border="0">
833
846
<col align="left" valign="top">
834
847
<tbody>
845
858
<tr>
846
859
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
847
860
<td> A newly-allocated string with the contents of the symbolic link, 
848
 
         or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if an error occurred.
 
861
         or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if an error occurred.
849
862
 
850
863
</td>
851
864
</tr>
856
869
<hr>
857
870
<div class="refsect2" title="g_mkdir_with_parents ()">
858
871
<a name="g-mkdir-with-parents"></a><h3>g_mkdir_with_parents ()</h3>
859
 
<pre class="programlisting"><span class="returnvalue">int</span>                 g_mkdir_with_parents                (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *pathname,
860
 
                                                         <span class="returnvalue">int</span> mode);</pre>
 
872
<pre class="programlisting">int                 g_mkdir_with_parents                (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *pathname,
 
873
                                                         int mode);</pre>
861
874
<p>
862
875
Create a directory if it doesn't already exist. Create intermediate
863
876
parent directories as needed, too.</p>
 
877
<p>
 
878
</p>
864
879
<div class="variablelist"><table border="0">
865
880
<col align="left" valign="top">
866
881
<tbody>
896
911
<hr>
897
912
<div class="refsect2" title="g_dir_open ()">
898
913
<a name="g-dir-open"></a><h3>g_dir_open ()</h3>
899
 
<pre class="programlisting"><a class="link" href="glib-File-Utilities.html#GDir" title="GDir"><span class="returnvalue">GDir</span></a> *              g_dir_open                          (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *path,
900
 
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> flags,
901
 
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);</pre>
 
914
<pre class="programlisting"><a class="link" href="glib-File-Utilities.html#GDir" title="GDir">GDir</a> *              g_dir_open                          (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *path,
 
915
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> flags,
 
916
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);</pre>
902
917
<p>
903
918
Opens a directory for reading. The names of the files in the
904
919
directory can then be retrieved using <a class="link" href="glib-File-Utilities.html#g-dir-read-name" title="g_dir_read_name ()"><code class="function">g_dir_read_name()</code></a>.</p>
 
920
<p>
 
921
</p>
905
922
<div class="variablelist"><table border="0">
906
923
<col align="left" valign="top">
907
924
<tbody>
918
935
</tr>
919
936
<tr>
920
937
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
921
 
<td> return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
922
 
        If non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, an error will be set if and only if
 
938
<td> return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>.
 
939
        If non-<a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>, an error will be set if and only if
923
940
        <a class="link" href="glib-File-Utilities.html#g-dir-open" title="g_dir_open ()"><code class="function">g_dir_open()</code></a> fails.
924
941
</td>
925
942
</tr>
926
943
<tr>
927
944
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
928
 
<td> a newly allocated <a class="link" href="glib-File-Utilities.html#GDir" title="GDir"><span class="type">GDir</span></a> on success, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> on failure.
929
 
  If non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, you must free the result with <a class="link" href="glib-File-Utilities.html#g-dir-close" title="g_dir_close ()"><code class="function">g_dir_close()</code></a>
 
945
<td> a newly allocated <a class="link" href="glib-File-Utilities.html#GDir" title="GDir"><span class="type">GDir</span></a> on success, <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> on failure.
 
946
  If non-<a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>, you must free the result with <a class="link" href="glib-File-Utilities.html#g-dir-close" title="g_dir_close ()"><code class="function">g_dir_close()</code></a>
930
947
  when you are finished with it.
931
948
</td>
932
949
</tr>
936
953
<hr>
937
954
<div class="refsect2" title="g_dir_read_name ()">
938
955
<a name="g-dir-read-name"></a><h3>g_dir_read_name ()</h3>
939
 
<pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *       g_dir_read_name                     (<a class="link" href="glib-File-Utilities.html#GDir" title="GDir"><span class="returnvalue">GDir</span></a> *dir);</pre>
 
956
<pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *       g_dir_read_name                     (<a class="link" href="glib-File-Utilities.html#GDir" title="GDir">GDir</a> *dir);</pre>
940
957
<p>
941
958
Retrieves the name of the next entry in the directory.  The '.' and
942
959
'..' entries are omitted. On Windows, the returned name is in
943
960
UTF-8. On Unix, it is in the on-disk encoding.</p>
 
961
<p>
 
962
</p>
944
963
<div class="variablelist"><table border="0">
945
964
<col align="left" valign="top">
946
965
<tbody>
951
970
</tr>
952
971
<tr>
953
972
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
954
 
<td> The entry's name or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if there are no 
 
973
<td> The entry's name or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if there are no 
955
974
  more entries. The return value is owned by GLib and
956
975
  must not be modified or freed.
957
976
</td>
962
981
<hr>
963
982
<div class="refsect2" title="g_dir_rewind ()">
964
983
<a name="g-dir-rewind"></a><h3>g_dir_rewind ()</h3>
965
 
<pre class="programlisting"><span class="returnvalue">void</span>                g_dir_rewind                        (<a class="link" href="glib-File-Utilities.html#GDir" title="GDir"><span class="returnvalue">GDir</span></a> *dir);</pre>
 
984
<pre class="programlisting">void                g_dir_rewind                        (<a class="link" href="glib-File-Utilities.html#GDir" title="GDir">GDir</a> *dir);</pre>
966
985
<p>
967
986
Resets the given directory. The next call to <a class="link" href="glib-File-Utilities.html#g-dir-read-name" title="g_dir_read_name ()"><code class="function">g_dir_read_name()</code></a>
968
987
will return the first entry again.</p>
 
988
<p>
 
989
</p>
969
990
<div class="variablelist"><table border="0">
970
991
<col align="left" valign="top">
971
992
<tbody><tr>
978
999
<hr>
979
1000
<div class="refsect2" title="g_dir_close ()">
980
1001
<a name="g-dir-close"></a><h3>g_dir_close ()</h3>
981
 
<pre class="programlisting"><span class="returnvalue">void</span>                g_dir_close                         (<a class="link" href="glib-File-Utilities.html#GDir" title="GDir"><span class="returnvalue">GDir</span></a> *dir);</pre>
 
1002
<pre class="programlisting">void                g_dir_close                         (<a class="link" href="glib-File-Utilities.html#GDir" title="GDir">GDir</a> *dir);</pre>
982
1003
<p>
983
1004
Closes the directory and deallocates all related resources.</p>
 
1005
<p>
 
1006
</p>
984
1007
<div class="variablelist"><table border="0">
985
1008
<col align="left" valign="top">
986
1009
<tbody><tr>
1003
1026
<hr>
1004
1027
<div class="refsect2" title="g_mapped_file_new ()">
1005
1028
<a name="g-mapped-file-new"></a><h3>g_mapped_file_new ()</h3>
1006
 
<pre class="programlisting"><a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="returnvalue">GMappedFile</span></a> *       g_mapped_file_new                   (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
1007
 
                                                         <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> writable,
1008
 
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);</pre>
 
1029
<pre class="programlisting"><a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile">GMappedFile</a> *       g_mapped_file_new                   (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
1030
                                                         <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> writable,
 
1031
                                                         <a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);</pre>
1009
1032
<p>
1010
1033
Maps a file into memory. On UNIX, this is using the <code class="function">mmap()</code> function.
1011
1034
</p>
1012
1035
<p>
1013
 
If <em class="parameter"><code>writable</code></em> is <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>, the mapped buffer may be modified, otherwise
 
1036
If <em class="parameter"><code>writable</code></em> is <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a>, the mapped buffer may be modified, otherwise
1014
1037
it is an error to modify the mapped buffer. Modifications to the buffer 
1015
1038
are not visible to other processes mapping the same file, and are not 
1016
1039
written back to the file.
1020
1043
of the <a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="type">GMappedFile</span></a>. Therefore, mapping should only be used if the file 
1021
1044
will not be modified, or if all modifications of the file are done
1022
1045
atomically (e.g. using <a class="link" href="glib-File-Utilities.html#g-file-set-contents" title="g_file_set_contents ()"><code class="function">g_file_set_contents()</code></a>).</p>
 
1046
<p>
 
1047
</p>
1023
1048
<div class="variablelist"><table border="0">
1024
1049
<col align="left" valign="top">
1025
1050
<tbody>
1035
1060
</tr>
1036
1061
<tr>
1037
1062
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1038
 
<td> return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
 
1063
<td> return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>
1039
1064
</td>
1040
1065
</tr>
1041
1066
<tr>
1042
1067
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1043
1068
<td> a newly allocated <a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="type">GMappedFile</span></a> which must be unref'd
1044
 
   with <a class="link" href="glib-File-Utilities.html#g-mapped-file-unref" title="g_mapped_file_unref ()"><code class="function">g_mapped_file_unref()</code></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the mapping failed.
 
1069
   with <a class="link" href="glib-File-Utilities.html#g-mapped-file-unref" title="g_mapped_file_unref ()"><code class="function">g_mapped_file_unref()</code></a>, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if the mapping failed.
1045
1070
 
1046
1071
</td>
1047
1072
</tr>
1052
1077
<hr>
1053
1078
<div class="refsect2" title="g_mapped_file_ref ()">
1054
1079
<a name="g-mapped-file-ref"></a><h3>g_mapped_file_ref ()</h3>
1055
 
<pre class="programlisting"><a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="returnvalue">GMappedFile</span></a> *       g_mapped_file_ref                   (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="returnvalue">GMappedFile</span></a> *file);</pre>
 
1080
<pre class="programlisting"><a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile">GMappedFile</a> *       g_mapped_file_ref                   (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile">GMappedFile</a> *file);</pre>
1056
1081
<p>
1057
1082
Increments the reference count of <em class="parameter"><code>file</code></em> by one.  It is safe to call
1058
1083
this function from any thread.</p>
 
1084
<p>
 
1085
</p>
1059
1086
<div class="variablelist"><table border="0">
1060
1087
<col align="left" valign="top">
1061
1088
<tbody>
1077
1104
<hr>
1078
1105
<div class="refsect2" title="g_mapped_file_unref ()">
1079
1106
<a name="g-mapped-file-unref"></a><h3>g_mapped_file_unref ()</h3>
1080
 
<pre class="programlisting"><span class="returnvalue">void</span>                g_mapped_file_unref                 (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="returnvalue">GMappedFile</span></a> *file);</pre>
 
1107
<pre class="programlisting">void                g_mapped_file_unref                 (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile">GMappedFile</a> *file);</pre>
1081
1108
<p>
1082
1109
Decrements the reference count of <em class="parameter"><code>file</code></em> by one.  If the reference count
1083
1110
drops to 0, unmaps the buffer of <em class="parameter"><code>file</code></em> and frees it.
1087
1114
</p>
1088
1115
<p>
1089
1116
Since 2.22</p>
 
1117
<p>
 
1118
</p>
1090
1119
<div class="variablelist"><table border="0">
1091
1120
<col align="left" valign="top">
1092
1121
<tbody><tr>
1099
1128
<hr>
1100
1129
<div class="refsect2" title="g_mapped_file_free ()">
1101
1130
<a name="g-mapped-file-free"></a><h3>g_mapped_file_free ()</h3>
1102
 
<pre class="programlisting"><span class="returnvalue">void</span>                g_mapped_file_free                  (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="returnvalue">GMappedFile</span></a> *file);</pre>
 
1131
<pre class="programlisting">void                g_mapped_file_free                  (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile">GMappedFile</a> *file);</pre>
1103
1132
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1104
1133
<h3 class="title">Warning</h3>
1105
1134
<p><code class="literal">g_mapped_file_free</code> has been deprecated since version 2.22 and should not be used in newly-written code. Use <a class="link" href="glib-File-Utilities.html#g-mapped-file-unref" title="g_mapped_file_unref ()"><code class="function">g_mapped_file_unref()</code></a> instead.</p>
1107
1136
<p>
1108
1137
This call existed before <a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="type">GMappedFile</span></a> had refcounting and is currently
1109
1138
exactly the same as <a class="link" href="glib-File-Utilities.html#g-mapped-file-unref" title="g_mapped_file_unref ()"><code class="function">g_mapped_file_unref()</code></a>.</p>
 
1139
<p>
 
1140
</p>
1110
1141
<div class="variablelist"><table border="0">
1111
1142
<col align="left" valign="top">
1112
1143
<tbody><tr>
1120
1151
<hr>
1121
1152
<div class="refsect2" title="g_mapped_file_get_length ()">
1122
1153
<a name="g-mapped-file-get-length"></a><h3>g_mapped_file_get_length ()</h3>
1123
 
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a>               g_mapped_file_get_length            (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="returnvalue">GMappedFile</span></a> *file);</pre>
 
1154
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize" title="gsize">gsize</a>               g_mapped_file_get_length            (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile">GMappedFile</a> *file);</pre>
1124
1155
<p>
1125
1156
Returns the length of the contents of a <a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="type">GMappedFile</span></a>.</p>
 
1157
<p>
 
1158
</p>
1126
1159
<div class="variablelist"><table border="0">
1127
1160
<col align="left" valign="top">
1128
1161
<tbody>
1144
1177
<hr>
1145
1178
<div class="refsect2" title="g_mapped_file_get_contents ()">
1146
1179
<a name="g-mapped-file-get-contents"></a><h3>g_mapped_file_get_contents ()</h3>
1147
 
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             g_mapped_file_get_contents          (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="returnvalue">GMappedFile</span></a> *file);</pre>
 
1180
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *             g_mapped_file_get_contents          (<a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile">GMappedFile</a> *file);</pre>
1148
1181
<p>
1149
1182
Returns the contents of a <a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="type">GMappedFile</span></a>. 
1150
1183
</p>
1153
1186
even if the <a class="link" href="glib-File-Utilities.html#GMappedFile" title="GMappedFile"><span class="type">GMappedFile</span></a> is backed by a text file.
1154
1187
</p>
1155
1188
<p>
1156
 
If the file is empty then <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned.</p>
 
1189
If the file is empty then <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> is returned.</p>
 
1190
<p>
 
1191
</p>
1157
1192
<div class="variablelist"><table border="0">
1158
1193
<col align="left" valign="top">
1159
1194
<tbody>
1164
1199
</tr>
1165
1200
<tr>
1166
1201
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1167
 
<td> the contents of <em class="parameter"><code>file</code></em>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
 
1202
<td> the contents of <em class="parameter"><code>file</code></em>, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>.
1168
1203
 
1169
1204
</td>
1170
1205
</tr>
1175
1210
<hr>
1176
1211
<div class="refsect2" title="g_open ()">
1177
1212
<a name="g-open"></a><h3>g_open ()</h3>
1178
 
<pre class="programlisting"><span class="returnvalue">int</span>                 g_open                              (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
1179
 
                                                         <span class="returnvalue">int</span> flags,
1180
 
                                                         <span class="returnvalue">int</span> mode);</pre>
 
1213
<pre class="programlisting">int                 g_open                              (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
1214
                                                         int flags,
 
1215
                                                         int mode);</pre>
1181
1216
<p>
1182
1217
A wrapper for the POSIX <code class="function">open()</code> function. The <code class="function">open()</code> function is
1183
1218
used to convert a pathname into a file descriptor.
1200
1235
</p>
1201
1236
<p>
1202
1237
See your C library manual for more details about <code class="function">open()</code>.</p>
 
1238
<p>
 
1239
</p>
1203
1240
<div class="variablelist"><table border="0">
1204
1241
<col align="left" valign="top">
1205
1242
<tbody>
1232
1269
<hr>
1233
1270
<div class="refsect2" title="g_rename ()">
1234
1271
<a name="g-rename"></a><h3>g_rename ()</h3>
1235
 
<pre class="programlisting"><span class="returnvalue">int</span>                 g_rename                            (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *oldfilename,
1236
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *newfilename);</pre>
 
1272
<pre class="programlisting">int                 g_rename                            (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *oldfilename,
 
1273
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *newfilename);</pre>
1237
1274
<p>
1238
1275
A wrapper for the POSIX <code class="function">rename()</code> function. The <code class="function">rename()</code> function 
1239
1276
renames a file, moving it between directories if required.
1242
1279
See your C library manual for more details about how <code class="function">rename()</code> works
1243
1280
on your system. It is not possible in general on Windows to rename
1244
1281
a file that is open to some process.</p>
 
1282
<p>
 
1283
</p>
1245
1284
<div class="variablelist"><table border="0">
1246
1285
<col align="left" valign="top">
1247
1286
<tbody>
1268
1307
<hr>
1269
1308
<div class="refsect2" title="g_mkdir ()">
1270
1309
<a name="g-mkdir"></a><h3>g_mkdir ()</h3>
1271
 
<pre class="programlisting"><span class="returnvalue">int</span>                 g_mkdir                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
1272
 
                                                         <span class="returnvalue">int</span> mode);</pre>
 
1310
<pre class="programlisting">int                 g_mkdir                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
1311
                                                         int mode);</pre>
1273
1312
<p>
1274
1313
A wrapper for the POSIX <code class="function">mkdir()</code> function. The <code class="function">mkdir()</code> function 
1275
1314
attempts to create a directory with the given name and permissions.
1277
1316
</p>
1278
1317
<p>
1279
1318
See your C library manual for more details about <code class="function">mkdir()</code>.</p>
 
1319
<p>
 
1320
</p>
1280
1321
<div class="variablelist"><table border="0">
1281
1322
<col align="left" valign="top">
1282
1323
<tbody>
1304
1345
<hr>
1305
1346
<div class="refsect2" title="g_stat ()">
1306
1347
<a name="g-stat"></a><h3>g_stat ()</h3>
1307
 
<pre class="programlisting"><span class="returnvalue">int</span>                 g_stat                              (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
1308
 
                                                         <span class="returnvalue">struct _g_stat_struct</span> *buf);</pre>
 
1348
<pre class="programlisting">int                 g_stat                              (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
1349
                                                         struct _g_stat_struct *buf);</pre>
1309
1350
<p>
1310
1351
A wrapper for the POSIX <code class="function">stat()</code> function. The <code class="function">stat()</code> function
1311
1352
returns information about a file. On Windows the <code class="function">stat()</code> function in
1315
1356
</p>
1316
1357
<p>
1317
1358
See your C library manual for more details about <code class="function">stat()</code>.</p>
 
1359
<p>
 
1360
</p>
1318
1361
<div class="variablelist"><table border="0">
1319
1362
<col align="left" valign="top">
1320
1363
<tbody>
1343
1386
<hr>
1344
1387
<div class="refsect2" title="g_lstat ()">
1345
1388
<a name="g-lstat"></a><h3>g_lstat ()</h3>
1346
 
<pre class="programlisting"><span class="returnvalue">int</span>                 g_lstat                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
1347
 
                                                         <span class="returnvalue">struct _g_stat_struct</span> *buf);</pre>
 
1389
<pre class="programlisting">int                 g_lstat                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
1390
                                                         struct _g_stat_struct *buf);</pre>
1348
1391
<p>
1349
1392
A wrapper for the POSIX <code class="function">lstat()</code> function. The <code class="function">lstat()</code> function is
1350
1393
like <code class="function">stat()</code> except that in the case of symbolic links, it returns
1354
1397
</p>
1355
1398
<p>
1356
1399
See your C library manual for more details about <code class="function">lstat()</code>.</p>
 
1400
<p>
 
1401
</p>
1357
1402
<div class="variablelist"><table border="0">
1358
1403
<col align="left" valign="top">
1359
1404
<tbody>
1382
1427
<hr>
1383
1428
<div class="refsect2" title="g_unlink ()">
1384
1429
<a name="g-unlink"></a><h3>g_unlink ()</h3>
1385
 
<pre class="programlisting"><span class="returnvalue">int</span>                 g_unlink                            (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename);</pre>
 
1430
<pre class="programlisting">int                 g_unlink                            (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename);</pre>
1386
1431
<p>
1387
1432
A wrapper for the POSIX <code class="function">unlink()</code> function. The <code class="function">unlink()</code> function 
1388
1433
deletes a name from the filesystem. If this was the last link to the 
1393
1438
See your C library manual for more details about <code class="function">unlink()</code>. Note
1394
1439
that on Windows, it is in general not possible to delete files that
1395
1440
are open to some process, or mapped into memory.</p>
 
1441
<p>
 
1442
</p>
1396
1443
<div class="variablelist"><table border="0">
1397
1444
<col align="left" valign="top">
1398
1445
<tbody>
1415
1462
<hr>
1416
1463
<div class="refsect2" title="g_remove ()">
1417
1464
<a name="g-remove"></a><h3>g_remove ()</h3>
1418
 
<pre class="programlisting"><span class="returnvalue">int</span>                 g_remove                            (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename);</pre>
 
1465
<pre class="programlisting">int                 g_remove                            (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename);</pre>
1419
1466
<p>
1420
1467
A wrapper for the POSIX <code class="function">remove()</code> function. The <code class="function">remove()</code> function
1421
1468
deletes a name from the filesystem.
1435
1482
errno value. <code class="function">rmdir()</code> is tried regardless of what caused <code class="function">remove()</code> to
1436
1483
fail. Any errno value set by <code class="function">remove()</code> will be overwritten by that
1437
1484
set by <code class="function">rmdir()</code>.</p>
 
1485
<p>
 
1486
</p>
1438
1487
<div class="variablelist"><table border="0">
1439
1488
<col align="left" valign="top">
1440
1489
<tbody>
1457
1506
<hr>
1458
1507
<div class="refsect2" title="g_rmdir ()">
1459
1508
<a name="g-rmdir"></a><h3>g_rmdir ()</h3>
1460
 
<pre class="programlisting"><span class="returnvalue">int</span>                 g_rmdir                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename);</pre>
 
1509
<pre class="programlisting">int                 g_rmdir                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename);</pre>
1461
1510
<p>
1462
1511
A wrapper for the POSIX <code class="function">rmdir()</code> function. The <code class="function">rmdir()</code> function
1463
1512
deletes a directory from the filesystem.
1465
1514
<p>
1466
1515
See your C library manual for more details about how <code class="function">rmdir()</code> works
1467
1516
on your system.</p>
 
1517
<p>
 
1518
</p>
1468
1519
<div class="variablelist"><table border="0">
1469
1520
<col align="left" valign="top">
1470
1521
<tbody>
1487
1538
<hr>
1488
1539
<div class="refsect2" title="g_fopen ()">
1489
1540
<a name="g-fopen"></a><h3>g_fopen ()</h3>
1490
 
<pre class="programlisting"><span class="returnvalue">FILE</span> *              g_fopen                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
1491
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *mode);</pre>
 
1541
<pre class="programlisting">FILE *              g_fopen                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
1542
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *mode);</pre>
1492
1543
<p>
1493
1544
A wrapper for the stdio <code class="function">fopen()</code> function. The <code class="function">fopen()</code> function
1494
1545
opens a file and associates a new stream with it.
1504
1555
</p>
1505
1556
<p>
1506
1557
See your C library manual for more details about <code class="function">fopen()</code>.</p>
 
1558
<p>
 
1559
</p>
1507
1560
<div class="variablelist"><table border="0">
1508
1561
<col align="left" valign="top">
1509
1562
<tbody>
1521
1574
<tr>
1522
1575
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1523
1576
<td> A <span class="type">FILE</span> pointer if the file was successfully
1524
 
   opened, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if an error occurred
 
1577
   opened, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if an error occurred
1525
1578
 
1526
1579
</td>
1527
1580
</tr>
1532
1585
<hr>
1533
1586
<div class="refsect2" title="g_freopen ()">
1534
1587
<a name="g-freopen"></a><h3>g_freopen ()</h3>
1535
 
<pre class="programlisting"><span class="returnvalue">FILE</span> *              g_freopen                           (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
1536
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *mode,
1537
 
                                                         <span class="returnvalue">FILE</span> *stream);</pre>
 
1588
<pre class="programlisting">FILE *              g_freopen                           (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
1589
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *mode,
 
1590
                                                         FILE *stream);</pre>
1538
1591
<p>
1539
1592
A wrapper for the POSIX <code class="function">freopen()</code> function. The <code class="function">freopen()</code> function
1540
1593
opens a file and associates it with an existing stream.
1541
1594
</p>
1542
1595
<p>
1543
1596
See your C library manual for more details about <code class="function">freopen()</code>.</p>
 
1597
<p>
 
1598
</p>
1544
1599
<div class="variablelist"><table border="0">
1545
1600
<col align="left" valign="top">
1546
1601
<tbody>
1557
1612
</tr>
1558
1613
<tr>
1559
1614
<td><p><span class="term"><em class="parameter"><code>stream</code></em> :</span></p></td>
1560
 
<td> an existing stream which will be reused, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
 
1615
<td> an existing stream which will be reused, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>
1561
1616
</td>
1562
1617
</tr>
1563
1618
<tr>
1564
1619
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1565
1620
<td> A <span class="type">FILE</span> pointer if the file was successfully
1566
 
   opened, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if an error occurred.
 
1621
   opened, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if an error occurred.
1567
1622
 
1568
1623
</td>
1569
1624
</tr>
1574
1629
<hr>
1575
1630
<div class="refsect2" title="g_chmod ()">
1576
1631
<a name="g-chmod"></a><h3>g_chmod ()</h3>
1577
 
<pre class="programlisting"><span class="returnvalue">int</span>                 g_chmod                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
1578
 
                                                         <span class="returnvalue">int</span> mode);</pre>
 
1632
<pre class="programlisting">int                 g_chmod                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
1633
                                                         int mode);</pre>
1579
1634
<p>
1580
1635
A wrapper for the POSIX <code class="function">chmod()</code> function. The <code class="function">chmod()</code> function is
1581
1636
used to set the permissions of a file system object.
1589
1644
</p>
1590
1645
<p>
1591
1646
See your C library manual for more details about <code class="function">chmod()</code>.</p>
 
1647
<p>
 
1648
</p>
1592
1649
<div class="variablelist"><table border="0">
1593
1650
<col align="left" valign="top">
1594
1651
<tbody>
1615
1672
<hr>
1616
1673
<div class="refsect2" title="g_access ()">
1617
1674
<a name="g-access"></a><h3>g_access ()</h3>
1618
 
<pre class="programlisting"><span class="returnvalue">int</span>                 g_access                            (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
1619
 
                                                         <span class="returnvalue">int</span> mode);</pre>
 
1675
<pre class="programlisting">int                 g_access                            (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
1676
                                                         int mode);</pre>
1620
1677
<p>
1621
1678
A wrapper for the POSIX <code class="function">access()</code> function. This function is used to
1622
1679
test a pathname for one or several of read, write or execute
1632
1689
</p>
1633
1690
<p>
1634
1691
See your C library manual for more details about <code class="function">access()</code>.</p>
 
1692
<p>
 
1693
</p>
1635
1694
<div class="variablelist"><table border="0">
1636
1695
<col align="left" valign="top">
1637
1696
<tbody>
1660
1719
<hr>
1661
1720
<div class="refsect2" title="g_creat ()">
1662
1721
<a name="g-creat"></a><h3>g_creat ()</h3>
1663
 
<pre class="programlisting"><span class="returnvalue">int</span>                 g_creat                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
1664
 
                                                         <span class="returnvalue">int</span> mode);</pre>
 
1722
<pre class="programlisting">int                 g_creat                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
1723
                                                         int mode);</pre>
1665
1724
<p>
1666
1725
A wrapper for the POSIX <code class="function">creat()</code> function. The <code class="function">creat()</code> function is
1667
1726
used to convert a pathname into a file descriptor, creating a file
1685
1744
</p>
1686
1745
<p>
1687
1746
See your C library manual for more details about <code class="function">creat()</code>.</p>
 
1747
<p>
 
1748
</p>
1688
1749
<div class="variablelist"><table border="0">
1689
1750
<col align="left" valign="top">
1690
1751
<tbody>
1712
1773
<hr>
1713
1774
<div class="refsect2" title="g_chdir ()">
1714
1775
<a name="g-chdir"></a><h3>g_chdir ()</h3>
1715
 
<pre class="programlisting"><span class="returnvalue">int</span>                 g_chdir                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *path);</pre>
 
1776
<pre class="programlisting">int                 g_chdir                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *path);</pre>
1716
1777
<p>
1717
1778
A wrapper for the POSIX <code class="function">chdir()</code> function. The function changes the
1718
1779
current directory of the process to <em class="parameter"><code>path</code></em>.
1719
1780
</p>
1720
1781
<p>
1721
1782
See your C library manual for more details about <code class="function">chdir()</code>.</p>
 
1783
<p>
 
1784
</p>
1722
1785
<div class="variablelist"><table border="0">
1723
1786
<col align="left" valign="top">
1724
1787
<tbody>
1740
1803
<hr>
1741
1804
<div class="refsect2" title="g_utime ()">
1742
1805
<a name="g-utime"></a><h3>g_utime ()</h3>
1743
 
<pre class="programlisting"><span class="returnvalue">int</span>                 g_utime                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *filename,
1744
 
                                                         <span class="returnvalue">struct utimbuf</span> *utb);</pre>
 
1806
<pre class="programlisting">int                 g_utime                             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *filename,
 
1807
                                                         struct utimbuf *utb);</pre>
1745
1808
<p>
1746
1809
A wrapper for the POSIX <code class="function">utime()</code> function. The <code class="function">utime()</code> function
1747
1810
sets the access and modification timestamps of a file.
1749
1812
<p>
1750
1813
See your C library manual for more details about how <code class="function">utime()</code> works
1751
1814
on your system.</p>
 
1815
<p>
 
1816
</p>
1752
1817
<div class="variablelist"><table border="0">
1753
1818
<col align="left" valign="top">
1754
1819
<tbody>
1777
1842
</div>
1778
1843
<div class="footer">
1779
1844
<hr>
1780
 
          Generated by GTK-Doc V1.13</div>
 
1845
          Generated by GTK-Doc V1.11</div>
1781
1846
</body>
1782
 
</html>
 
 
b'\\ No newline at end of file'
 
1847
</html>