1 /* GLIB - Library of useful routines for C programming
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * gdir.c: Simplified wrapper around the DIRENT functions.
6 * Copyright 2001 Hans Breuer
7 * Copyright 2004 Tor Lillqvist
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public
11 * License as published by the Free Software Foundation; either
12 * version 2 of the License, or (at your option) any later version.
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with this library; if not, write to the
21 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
22 * Boston, MA 02111-1307, USA.
33 #include <sys/types.h>
40 #include "gfileutils.h"
41 #include "gstrfuncs.h"
42 #include "gtestutils.h"
46 #if defined (_MSC_VER) && !defined (HAVE_DIRENT_H)
47 #include "../build/win32/dirent/dirent.h"
48 #include "../build/win32/dirent/wdirent.c"
59 gchar utf8_buf[FILENAME_MAX*4];
65 * @path: the path to the directory you are interested in. On Unix
66 * in the on-disk encoding. On Windows in UTF-8
67 * @flags: Currently must be set to 0. Reserved for future use.
68 * @error: return location for a #GError, or %NULL.
69 * If non-%NULL, an error will be set if and only if
72 * Opens a directory for reading. The names of the files in the
73 * directory can then be retrieved using g_dir_read_name(). Note
74 * that the ordering is not defined.
76 * Return value: a newly allocated #GDir on success, %NULL on failure.
77 * If non-%NULL, you must free the result with g_dir_close()
78 * when you are finished with it.
81 g_dir_open (const gchar *path,
93 g_return_val_if_fail (path != NULL, NULL);
96 wpath = g_utf8_to_utf16 (path, -1, NULL, NULL, error);
101 dir = g_new (GDir, 1);
103 dir->wdirp = _wopendir (wpath);
114 g_file_error_from_errno (errsv),
115 _("Error opening directory '%s': %s"),
116 path, g_strerror (errsv));
122 dir = g_new (GDir, 1);
124 dir->dirp = opendir (path);
132 utf8_path = g_filename_to_utf8 (path, -1,
137 g_file_error_from_errno (errsv),
138 _("Error opening directory '%s': %s"),
139 utf8_path, g_strerror (errsv));
148 #if defined (G_OS_WIN32) && !defined (_WIN64)
150 /* The above function actually is called g_dir_open_utf8, and it's
151 * that what applications compiled with this GLib version will
157 /* Binary compatibility version. Not for newly compiled code. */
160 g_dir_open (const gchar *path,
164 gchar *utf8_path = g_locale_to_utf8 (path, -1, NULL, NULL, error);
167 if (utf8_path == NULL)
170 retval = g_dir_open_utf8 (utf8_path, flags, error);
180 * @dir: a #GDir* created by g_dir_open()
182 * Retrieves the name of another entry in the directory, or %NULL.
183 * The order of entries returned from this function is not defined,
184 * and may vary by file system or other operating-system dependent
187 * On Unix, the '.' and '..' entries are omitted, and the returned
188 * name is in the on-disk encoding.
190 * On Windows, as is true of all GLib functions which operate on
191 * filenames, the returned name is in UTF-8.
193 * Return value: The entry's name or %NULL if there are no
194 * more entries. The return value is owned by GLib and
195 * must not be modified or freed.
197 G_CONST_RETURN gchar*
198 g_dir_read_name (GDir *dir)
202 struct _wdirent *wentry;
204 struct dirent *entry;
207 g_return_val_if_fail (dir != NULL, NULL);
212 wentry = _wreaddir (dir->wdirp);
214 && (0 == wcscmp (wentry->d_name, L".") ||
215 0 == wcscmp (wentry->d_name, L"..")))
216 wentry = _wreaddir (dir->wdirp);
221 utf8_name = g_utf16_to_utf8 (wentry->d_name, -1, NULL, NULL, NULL);
223 if (utf8_name == NULL)
224 continue; /* Huh, impossible? Skip it anyway */
226 strcpy (dir->utf8_buf, utf8_name);
229 return dir->utf8_buf;
232 entry = readdir (dir->dirp);
234 && (0 == strcmp (entry->d_name, ".") ||
235 0 == strcmp (entry->d_name, "..")))
236 entry = readdir (dir->dirp);
239 return entry->d_name;
245 #if defined (G_OS_WIN32) && !defined (_WIN64)
247 /* Ditto for g_dir_read_name */
249 #undef g_dir_read_name
251 /* Binary compatibility version. Not for newly compiled code. */
253 G_CONST_RETURN gchar*
254 g_dir_read_name (GDir *dir)
258 const gchar *utf8_name = g_dir_read_name_utf8 (dir);
261 if (utf8_name == NULL)
264 retval = g_locale_from_utf8 (utf8_name, -1, NULL, NULL, NULL);
268 strcpy (dir->utf8_buf, retval);
271 return dir->utf8_buf;
280 * @dir: a #GDir* created by g_dir_open()
282 * Resets the given directory. The next call to g_dir_read_name()
283 * will return the first entry again.
286 g_dir_rewind (GDir *dir)
288 g_return_if_fail (dir != NULL);
291 _wrewinddir (dir->wdirp);
293 rewinddir (dir->dirp);
299 * @dir: a #GDir* created by g_dir_open()
301 * Closes the directory and deallocates all related resources.
304 g_dir_close (GDir *dir)
306 g_return_if_fail (dir != NULL);
309 _wclosedir (dir->wdirp);
311 closedir (dir->dirp);