glib/gstdio.h

   1 /* gstdio.h - GFilename wrappers for C library functions
   2  *
   3  * Copyright 2004 Tor Lillqvist
   4  *
   5  * GLib is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU Lesser General Public License as
   7  * published by the Free Software Foundation; either version 2 of the
   8  * License, or (at your option) any later version.
   9  *
  10  * GLib is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * Lesser General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU Lesser General Public
  16  * License along with GLib; see the file COPYING.LIB.  If not,
  17  * write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  18  * Boston, MA 02111-1307, USA.
  19  */
  20
  21 #ifndef __G_STDIO_H__
  22 #define __G_STDIO_H__
  23
  24 #include <glib/gprintf.h>
  25
  26 #include <sys/stat.h>
  27
  28 G_BEGIN_DECLS
  29
  30 #if defined(G_OS_UNIX) && !defined(G_STDIO_NO_WRAP_ON_UNIX)
  31
  32 /* Just pass on to the system functions, so there's no potential for data
  33  * format mismatches, especially with large file interfaces.
  34  * A few functions can't be handled in this way, since they are not defined
  35  * in a portable system header that we could include here.
  36  */
  37
  38 #define g_chmod   chmod
  39 #define g_open    open
  40 #define g_creat   creat
  41 #define g_rename  rename
  42 #define g_mkdir   mkdir
  43 #define g_stat    stat
  44 #define g_lstat   lstat
  45 #define g_remove  remove
  46 #define g_fopen   fopen
  47 #define g_freopen freopen
  48 #define g_utime   utime
  49
  50 int g_access (const gchar *filename,
  51               int          mode);
  52
  53 int g_chdir  (const gchar *path);
  54
  55 int g_unlink (const gchar *filename);
  56
  57 int g_rmdir  (const gchar *filename);
  58
  59 #else /* ! G_OS_UNIX */
  60
  61 /* Wrappers for C library functions that take pathname arguments. On
  62  * Unix, the pathname is a file name as it literally is in the file
  63  * system. On well-maintained systems with consistent users who know
  64  * what they are doing and no exchange of files with others this would
  65  * be a well-defined encoding, preferrably UTF-8. On Windows, the
  66  * pathname is always in UTF-8, even if that is not the on-disk
  67  * encoding, and not the encoding accepted by the C library or Win32
  68  * API.
  69  */
  70
  71 int g_access    (const gchar *filename,
  72                  int          mode);
  73
  74 int g_chmod     (const gchar *filename,
  75                  int          mode);
  76
  77 int g_open      (const gchar *filename,
  78                  int          flags,
  79                  int          mode);
  80
  81 int g_creat     (const gchar *filename,
  82                  int          mode);
  83
  84 int g_rename    (const gchar *oldfilename,
  85                  const gchar *newfilename);
  86
  87 int g_mkdir     (const gchar *filename,
  88                  int          mode);
  89
  90 int g_chdir     (const gchar *path);
  91
  92 #ifdef G_OS_WIN32
  93
  94 /* The _g_stat_struct struct tag is an internal implementation detail
  95  * and not part of the public GLib API.
  96  */
  97
  98 #if defined (_MSC_VER) && !defined(_WIN64)
  99
 100 /* Make it clear that we mean the struct with 32-bit st_size and
 101  * 32-bit st_*time fields as that is how the 32-bit GLib DLL normally
 102  * has been compiled. If you get a compiler warning when calling
 103  * g_stat(), do take it seriously and make sure that the type of
 104  * struct stat the code in GLib fills in matches the struct the type
 105  * of struct stat you pass to g_stat(). To avoid hassle, just use the
 106  * GIO API instead which doesn't use struct stat to get file
 107  * attributes, .
 108  */
 109 #define _g_stat_struct _stat32
 110
 111 #else
 112
 113 #define _g_stat_struct _stat
 114
 115 #endif
 116
 117 int g_stat      (const gchar           *filename,
 118                  struct _g_stat_struct *buf);
 119
 120 int g_lstat     (const gchar           *filename,
 121                  struct _g_stat_struct *buf);
 122
 123 #else
 124
 125 /* No _g_stat_struct used on Unix */
 126
 127 int g_stat      (const gchar *filename,
 128                  struct stat *buf);
 129
 130 int g_lstat     (const gchar *filename,
 131                  struct stat *buf);
 132
 133 #endif
 134
 135 int g_unlink    (const gchar *filename);
 136
 137 int g_remove    (const gchar *filename);
 138
 139 int g_rmdir     (const gchar *filename);
 140
 141 FILE *g_fopen   (const gchar *filename,
 142                  const gchar *mode);
 143
 144 FILE *g_freopen (const gchar *filename,
 145                  const gchar *mode,
 146                  FILE        *stream);
 147
 148 struct utimbuf;                 /* Don't need the real definition of struct utimbuf when just
 149                                  * including this header.
 150                                  */
 151
 152 int g_utime     (const gchar    *filename,
 153                  struct utimbuf *utb);
 154
 155 #endif /* G_OS_UNIX */
 156
 157 G_END_DECLS
 158
 159 #endif /* __G_STDIO_H__ */