scandir

SCANDIR

章节：Linux 程序员手册 (3)
更新：2009-02-10

到 易美翻译 翻译 本页

---

名字

scandir, alphasort, versionsort - 为寻找项目扫描目录

概要

#include <dirent.h>

int scandir(const char *dirp, struct dirent ***namelist,

int (* filter )(const struct dirent *), int (* compar )(const struct dirent **, const struct dirent **));

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

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

glibc 需要特性测试宏(参看 feature_test_macros(7))：

scandir()、alphasort()：_BSD_SOURCE || _SVID_SOURCE
versionsort()：_GNU_SOURCE

描述

scandir() 函数扫描目录 dirp，对每一个目录项 （文件名）调用 filter()。把每一个 filter() 返回非零项目保存在一个通过 malloc(3) 分配的缓存区里，再通过比较函数是 compar() 的 qsort(3) 函数排序，最后收集在 namelist 的数组里，这个数组也是通过 malloc(3) 分配的。如果 filter 是 NULL，所有项目都被选择。

alpthasort() 和 versionsort() 可以用作比较函数 compar()。前者通过strcoll(3) 来排序项目，后者使用字符串字段(*a)->d_name 和(*b)->d_name 上应用 strverscmp(3)。

返回值

scandir() 函数返回被选择的目录条数，或者如果出错返回 -1。

alphasort() 和 versionsort() 函数返回一个小于、等于或大于零的整数，当第一个参数被认为是小于、等于或大于第二个参数时。

错误

ENOMEM

没有足够的内存来完成操作。

版本

versionsort() 在 glibc 2.1 中首次出现。

遵循于

alphasort() 和 scandir() 由 POSIX.1-2008 定义，并且广泛存在。 versionsort() 是 GNU 扩展。

函数 scandir() 和 alphasort() 来自 4.3BSD，并且在 Linux libc4 里已经存在。libc4 和 libc5 使用更安全的原型：

    int alphasort(const struct dirent ** a, const struct dirent **b);

但 glibc 2.0 使用不太精确的 BSD 原型。

函数 versionsort() 是 GNU 扩展，从 glibc 2.1 开始有效。

从 glibc 2.1 开始，alphasort() 调用 strcoll(3)；之前的调用strcmp(3)。

示例

#define _SVID_SOURCE
/* 以反序打印当前目录里的文件名 */
#include <dirent.h>

int
main(void)
{
    struct dirent **namelist;
    int n;

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

 
 

  
  scandir()函数
 
 
 
 

  
  2011-08-24 14:20
 
 
 
 

     
     

      
      
#include <dirent.h> 
      
      

      
      
　　int scandir( const char *dir, 
      
      

      
      
　　struct dirent **namelist, 
      
      

      
      
　　int (*filter) (const void *b), 
      
      

      
      
　　int ( * compare )( const struct dirent **, const struct dirent ** ) ); 
      
      

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

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

      
      
　　函数scandir扫描dir目录下以及dir子目录下满足filter过滤模式的文件，返回的结果是compare函数经过排序的，并保存在namelist中。注意namelist是通过malloc动态分配内存的,所以在使用时要注意释放内存。alphasort和versionsort是使用到的两种排序的函数。 
      
      

      
      
　　当函数成功执行时返回找到匹配模式文件的个数，如果失败将返回-1。 
      
      

      
      
　　eg: 
      
      

      
      
　　#include <dirent.h> 
      
      

      
      
　　int main() 
      
      

      
      
　　{ 
      
      

      
      
　　struct dirent **namelist; 
      
      

      
      
　　int n; 
      
      

      
      
　　n = scandir(".", &namelist, 0, alphasort); 
      
      

      
      
　　if (n < 0) 
      
      

      
      
　　{ 
      
      

      
      
　　perror("not found\n"); 
      
      

      
      
　　} 
      
      

      
      
　　else 
      
      

      
      
　　{ 
      
      

      
      
　　while(n--) 
      
      

      
      
　　{ 
      
      

      
      
　　printf("%s\n", namelist[n]->d_name); 
      
      

      
      
　　free(namelist[n]); 
      
      

      
      
　　} 
      
      

      
      
　　free(namelist); 
      
      

      
      
　　} 
      
      

      
      
　　}
---------------------------------------------------------------------------------3
     
     
     
     

      
      

      
      
 
       dirent  结构体 介绍： 
      
      
      
 
       　　LINUX系统下的一个头文件,在这个目录下/usr/include 
      
      
      
 
       
 
      
      
      
 
       　　为了获取某文件夹目录内容，所使用的结构体。 
      
      
      
 
       
 
      
      
      
 
       　　引用头文件#include<dirent.h> 
      
      
      
结构体说明
      
      
 
       　　struct dirent 
      
      
      

          
      
      
      
 
       　　{ 
      
      
      
 
       
 
      
      
      
 
       　　long d_ino; /* inode number 索引节点号 */ 
      
      
      
 
       　　off_t d_off; /* offset to this dirent 在目录文件中的偏移 */ 
      
      
      
 
       　　unsigned short d_reclen; /* length of this d_name 文长  
      
      
      
 
       　　unsigned char d_type; /* the type of d_name 文件类型 */ 
      
      
      
 
       　　char d_name [NAME_MAX+1]; /* file name (null-terminated) 文件名，最长255字符 */ 
      
      
      
 
       　} 
      
      
      
相关函数
      
      
 
       　opendir()，readdir(),closedir(); 
      
      
      
 
       使用实例 
      
      
      
 
       　　#include <stdio.h> #include <errno.h> 
      
      
      
 
       　　#include <string.h> #include <sys/types.h> 
      
      
      
 
       　　#include <dirent.h> 
      
      
      
 
       　　#ifndef DT_DIR 
      
      
      
 
       　　#error "DT_DIR not defined, maybe d_type not a mumber of struct dirent!" 
      
      
      
 
       　　#endif 
      
      
      
 
       　int 
       main(int argc, char*argv[]) 
      
      
      
 
       　{ 
      
      
      

          
      
      
      
 
       　　staticchar dot[] =".", dotdot[] =".."; 
      
      
      
 
       　　constchar*name; 
      
      
      
 
       　　DIR *dirp; 
      
      
      
 
       　　struct dirent *dp; 
      
      
      
 
       　　if (argc ==2) 
      
      
      
 
       　　name = argv[1]; 
      
      
      
 
       　　else 
      
      
      
 
       　　name = dot; 
      
      
      
 
       　　dirp = opendir(name); 
      
      
      
 
       　　if (dirp == NULL) { 
      
      
      
 
       　　(void)fprintf(stderr, "%s: opendir(): %s: %s\n", 
      
      
      
 
       　　argv[0], name, strerror(errno)); 
      
      
      
 
       　　exit(errno); 
      
      
      
 
       　　} 
      
      
      

          
      
      
      
 
       　　while ((dp = readdir(dirp)) != NULL) { 
      
      
      
 
       　　if (dp->d_type == DT_DIR) 
      
      
      
 
       　　if ( strcmp(dp->d_name, dot) 
      
      
      
 
       　　&& strcmp(dp->d_name, dotdot) ) 
      
      
      
 
       　　(void)printf("%s/\n", dp->d_name); 
      
      
      
 
       　　} 
      
      
      
 
       　　(void)closedir(dirp); 
      
      
      
 
       　　return (0); 
      
      
      
 
       　　}