*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Linux man pages -> scandir (3)              



NAME    [Toc]    [Back]

       scandir, alphasort, versionsort - scan a directory for matching entries

SYNOPSIS    [Toc]    [Back]

       #include <dirent.h>

       int scandir(const char *dir, struct dirent ***namelist,
	      int (*select)(const struct dirent *),
	      int (*compar)(const void *, const void *));

       int alphasort(const void *a, const void *b);
       int versionsort(const void *a, const void *b);

DESCRIPTION    [Toc]    [Back]

       The scandir() function scans the directory  dir,  calling  select()  on
       each  directory entry.  Entries for which select() returns non-zero are
       stored in strings allocated via malloc(), sorted using qsort() with the
       comparison  function compar(), and collected in array namelist which is
       allocated via malloc().

       The alphasort() and versionsort() functions can be used as the comparison
  function  for the scandir() function to sort the directory entries
       into alphabetical order.  Although they parameters point to void,  they
       are  in	fact  pointers	to pointers (struct dirent**) to two directory
       entries, a and b, to compare.

       alphasort() will order the files with strcoll(3),  while  versionsort()
       will use strverscmp(3).

RETURN VALUE    [Toc]    [Back]

       The scandir() function returns the number of directory entries selected
       or -1 if an error occurs.

       The alphasort() and versionsort()  functions  return  an  integer  less
       than,  equal  to, or greater than zero if the first argument is considered
 to be respectively less than, equal to, or greater than  the  second.

ERRORS    [Toc]    [Back]

       ENOMEM Insufficient memory to complete the operation.

CONFORMING TO    [Toc]    [Back]

       BSD 4.3

EXAMPLE    [Toc]    [Back]

       /* print files in current directory in reverse order */
       #include <dirent.h>
	   struct dirent **namelist;
	   int n;

	   n = scandir(".", &namelist, 0, alphasort);
	   if (n < 0)
	   else {
	       while(n--) {
		   printf("%s\n", namelist[n]->d_name);

SEE ALSO    [Toc]    [Back]

       opendir(3),    readdir(3),   closedir(3),   rewinddir(3),   telldir(3),

GNU				  1996-04-11			    SCANDIR(3)
[ Back ]
 Similar pages
Name OS Title
dmParamsScan IRIX scan all entries of a digital media parameter/value list
alphasort OpenBSD scan a directory
scandir IRIX scan a directory
scandir OpenBSD scan a directory
alphasort FreeBSD scan a directory
alphasort NetBSD scan a directory
scandir FreeBSD scan a directory
scandir NetBSD scan a directory
scandir Tru64 Scan or sorts directory contents
alphasort Tru64 Scan or sorts directory contents
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service