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.
28 #include <string.h> /* strcmp */
31 #include <sys/types.h>
51 gchar utf8_buf
[FILENAME_MAX
*4];
57 * @path: the path to the directory you are interested in. On Unix
58 * in the on-disk encoding. On Windows in UTF-8
59 * @flags: Currently must be set to 0. Reserved for future use.
60 * @error: return location for a #GError, or %NULL.
61 * If non-%NULL, an error will be set if and only if
64 * Opens a directory for reading. The names of the files in the
65 * directory can then be retrieved using g_dir_read_name().
67 * Return value: a newly allocated #GDir on success, %NULL on failure.
68 * If non-%NULL, you must free the result with g_dir_close()
69 * when you are finished with it.
72 g_dir_open (const gchar
*path
,
81 g_return_val_if_fail (path
!= NULL
, NULL
);
84 if (G_WIN32_HAVE_WIDECHAR_API ())
86 wchar_t *wpath
= g_utf8_to_utf16 (path
, -1, NULL
, NULL
, error
);
91 dir
= g_new (GDir
, 1);
93 dir
->u
.wdirp
= _wopendir (wpath
);
101 gchar
*cp_path
= g_locale_from_utf8 (path
, -1, NULL
, NULL
, error
);
106 dir
= g_new (GDir
, 1);
108 dir
->u
.dirp
= opendir (cp_path
);
120 g_file_error_from_errno (errno
),
121 _("Error opening directory '%s': %s"),
122 path
, g_strerror (errno
));
128 dir
= g_new (GDir
, 1);
130 dir
->u
.dirp
= opendir (path
);
136 utf8_path
= g_filename_to_utf8 (path
, -1,
140 g_file_error_from_errno (errno
),
141 _("Error opening directory '%s': %s"),
142 utf8_path
, g_strerror (errno
));
153 /* The above function actually is called g_dir_open_utf8, and it's
154 * that what applications compiled with this GLib version will
160 /* Binary compatibility version. Not for newly compiled code. */
163 g_dir_open (const gchar
*path
,
167 gchar
*utf8_path
= g_locale_to_utf8 (path
, -1, NULL
, NULL
, error
);
170 if (utf8_path
== NULL
)
173 retval
= g_dir_open_utf8 (utf8_path
, flags
, error
);
183 * @dir: a #GDir* created by g_dir_open()
185 * Retrieves the name of the next entry in the directory. The '.' and
186 * '..' entries are omitted. On Windows, the returned name is in
187 * UTF-8. On Unix, it is in the on-disk encoding.
189 * Return value: The entry's name or %NULL if there are no
190 * more entries. The return value is owned by GLib and
191 * must not be modified or freed.
193 G_CONST_RETURN gchar
*
194 g_dir_read_name (GDir
*dir
)
196 struct dirent
*entry
;
198 g_return_val_if_fail (dir
!= NULL
, NULL
);
201 if (G_WIN32_HAVE_WIDECHAR_API ())
204 struct _wdirent
*wentry
;
208 wentry
= _wreaddir (dir
->u
.wdirp
);
210 && (0 == wcscmp (wentry
->d_name
, L
".") ||
211 0 == wcscmp (wentry
->d_name
, L
"..")))
212 wentry
= _wreaddir (dir
->u
.wdirp
);
217 utf8_name
= g_utf16_to_utf8 (wentry
->d_name
, -1, NULL
, NULL
, NULL
);
219 if (utf8_name
== NULL
)
220 continue; /* Huh, impossible? Skip it anyway */
222 strcpy (dir
->utf8_buf
, utf8_name
);
225 return dir
->utf8_buf
;
234 entry
= readdir (dir
->u
.dirp
);
236 && (0 == strcmp (entry
->d_name
, ".") ||
237 0 == strcmp (entry
->d_name
, "..")))
238 entry
= readdir (dir
->u
.dirp
);
243 utf8_name
= g_locale_to_utf8 (entry
->d_name
, -1, NULL
, NULL
, NULL
);
245 if (utf8_name
!= NULL
)
247 strcpy (dir
->utf8_buf
, utf8_name
);
250 return dir
->utf8_buf
;
255 entry
= readdir (dir
->u
.dirp
);
257 && (0 == strcmp (entry
->d_name
, ".") ||
258 0 == strcmp (entry
->d_name
, "..")))
259 entry
= readdir (dir
->u
.dirp
);
262 return entry
->d_name
;
270 /* Ditto for g_dir_read_name */
272 #undef g_dir_read_name
274 /* Binary compatibility version. Not for newly compiled code. */
276 G_CONST_RETURN gchar
*
277 g_dir_read_name (GDir
*dir
)
281 const gchar
*utf8_name
= g_dir_read_name_utf8 (dir
);
284 if (utf8_name
== NULL
)
287 retval
= g_locale_from_utf8 (utf8_name
, -1, NULL
, NULL
, NULL
);
291 strcpy (dir
->utf8_buf
, retval
);
294 return dir
->utf8_buf
;
303 * @dir: a #GDir* created by g_dir_open()
305 * Resets the given directory. The next call to g_dir_read_name()
306 * will return the first entry again.
309 g_dir_rewind (GDir
*dir
)
311 g_return_if_fail (dir
!= NULL
);
314 if (G_WIN32_HAVE_WIDECHAR_API ())
316 _wrewinddir (dir
->u
.wdirp
);
321 rewinddir (dir
->u
.dirp
);
326 * @dir: a #GDir* created by g_dir_open()
328 * Closes the directory and deallocates all related resources.
331 g_dir_close (GDir
*dir
)
333 g_return_if_fail (dir
!= NULL
);
336 if (G_WIN32_HAVE_WIDECHAR_API ())
338 _wclosedir (dir
->u
.wdirp
);
344 closedir (dir
->u
.dirp
);
349 #include "galiasdef.c"