/* gstdio.h - GFilename wrappers for C library functions * * Copyright 2004 Tor Lillqvist * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_STDIO_H__ #define __G_STDIO_H__ #include <glib/gprintf.h> #include <sys/stat.h> G_BEGIN_DECLS #if (defined (__MINGW64_VERSION_MAJOR) || defined (_MSC_VER)) && !defined(_WIN64) /* Make it clear that we mean the struct with 32-bit st_size and * 32-bit st_*time fields as that is how the 32-bit GLib DLL normally * has been compiled. If you get a compiler warning when calling * g_stat(), do take it seriously and make sure that the type of * struct stat the code in GLib fills in matches the struct the type * of struct stat you pass to g_stat(). To avoid hassle, to get file * attributes just use the GIO API instead which doesn't use struct * stat. * * Sure, it would be nicer to use a struct with 64-bit st_size and * 64-bit st_*time fields, but changing that now would break ABI. And * in MinGW, a plain "struct stat" is the one with 32-bit st_size and * st_*time fields. */ typedef struct _stat32 GStatBuf; #elif defined(__MINGW64_VERSION_MAJOR) && defined(_WIN64) typedef struct _stat64 GStatBuf; #else typedef struct stat GStatBuf; #endif #if defined(G_OS_UNIX) && !defined(G_STDIO_WRAP_ON_UNIX) /* Just pass on to the system functions, so there's no potential for data * format mismatches, especially with large file interfaces. * A few functions can't be handled in this way, since they are not defined * in a portable system header that we could include here. * * #G_STDIO_WRAP_ON_UNIX is not public API and its behaviour is not guaranteed * in future. */ #ifndef __GTK_DOC_IGNORE__ #define g_chmod chmod #define g_open open #define g_creat creat #define g_rename rename #define g_mkdir mkdir #define g_stat stat #define g_lstat lstat #define g_remove remove #define g_fopen fopen #define g_freopen freopen #define g_fsync fsync #define g_utime utime #endif GLIB_AVAILABLE_IN_ALL int g_access (const gchar *filename, int mode); GLIB_AVAILABLE_IN_ALL int g_chdir (const gchar *path); GLIB_AVAILABLE_IN_ALL int g_unlink (const gchar *filename); GLIB_AVAILABLE_IN_ALL int g_rmdir (const gchar *filename); #else /* ! G_OS_UNIX */ /* Wrappers for C library functions that take pathname arguments. On * Unix, the pathname is a file name as it literally is in the file * system. On well-maintained systems with consistent users who know * what they are doing and no exchange of files with others this would * be a well-defined encoding, preferably UTF-8. On Windows, the * pathname is always in UTF-8, even if that is not the on-disk * encoding, and not the encoding accepted by the C library or Win32 * API. */ GLIB_AVAILABLE_IN_ALL int g_access (const gchar *filename, int mode); GLIB_AVAILABLE_IN_ALL int g_chmod (const gchar *filename, int mode); GLIB_AVAILABLE_IN_ALL int g_open (const gchar *filename, int flags, int mode); GLIB_AVAILABLE_IN_ALL int g_creat (const gchar *filename, int mode); GLIB_AVAILABLE_IN_ALL int g_rename (const gchar *oldfilename, const gchar *newfilename); GLIB_AVAILABLE_IN_ALL int g_mkdir (const gchar *filename, int mode); GLIB_AVAILABLE_IN_ALL int g_chdir (const gchar *path); GLIB_AVAILABLE_IN_ALL int g_stat (const gchar *filename, GStatBuf *buf); GLIB_AVAILABLE_IN_ALL int g_lstat (const gchar *filename, GStatBuf *buf); GLIB_AVAILABLE_IN_ALL int g_unlink (const gchar *filename); GLIB_AVAILABLE_IN_ALL int g_remove (const gchar *filename); GLIB_AVAILABLE_IN_ALL int g_rmdir (const gchar *filename); GLIB_AVAILABLE_IN_ALL FILE *g_fopen (const gchar *filename, const gchar *mode); GLIB_AVAILABLE_IN_ALL FILE *g_freopen (const gchar *filename, const gchar *mode, FILE *stream); GLIB_AVAILABLE_IN_2_64 gint g_fsync (gint fd); struct utimbuf; /* Don't need the real definition of struct utimbuf when just * including this header. */ GLIB_AVAILABLE_IN_ALL int g_utime (const gchar *filename, struct utimbuf *utb); #endif /* G_OS_UNIX */ GLIB_AVAILABLE_IN_2_36 gboolean g_close (gint fd, GError **error); G_END_DECLS #endif /* __G_STDIO_H__ */