{"id":3252,"date":"2018-09-01T00:01:03","date_gmt":"2018-09-01T07:01:03","guid":{"rendered":"https:\/\/c-for-dummies.com\/blog\/?p=3252"},"modified":"2021-10-30T15:30:26","modified_gmt":"2021-10-30T22:30:26","slug":"directory-entry-file-types","status":"publish","type":"post","link":"https:\/\/c-for-dummies.com\/blog\/?p=3252","title":{"rendered":"Directory Entry File Types"},"content":{"rendered":"

Not every file listed in a directory is the same. Some entries represent other directories, subdirectories, for example. To determine which entries are mere mortal files and which are directories, you must examine the file type.
\n
\nThe good news is that file type information is held in the same dirent<\/code> structure that yields the file’s name. The structure member is d_type<\/code>. The bad news is that not every operating system features the d_type<\/code> member in its dirent<\/code> structure.<\/p>\n

The following code modifies the second example from last week’s Lesson<\/a> to display the d_type<\/code> member’s value for the current directory:<\/p>\n

\r\n#include <stdio.h>\r\n#include <dirent.h>\r\n\r\nint main()\r\n{\r\n    DIR *folder;\r\n    struct dirent *entry;\r\n    int files = 0;\r\n\r\n    folder = opendir(\".\");\r\n    if(folder == NULL)\r\n    {\r\n        perror(\"Unable to read directory\");\r\n        return(1);\r\n    }\r\n\r\n    while( (entry=readdir(folder)) )\r\n    {\r\n        files++;\r\n        printf(\"File %3d: %s, %d\\n\",\r\n                files,\r\n                entry->d_name,\r\n                entry->d_type\r\n              );\r\n    }\r\n\r\n    closedir(folder);\r\n\r\n    return(0);\r\n}<\/pre>\n
The only modification to this code from what was shown last week is the printf()<\/em> statement starting at Line 20. I added the entry->d_type<\/code> item and used the %d<\/code> placeholder to display its integer value. Here’s sample output:<\/p>\n
File   1: .,4\r\nFile   2: ..,4\r\nFile   3: 0825a.c,8\r\nFile   4: 0825b.c,8\r\nFile   5: 08exercise-a.c,8\r\nFile   6: 08exercise-b.c,8\r\nFile   7: 0901.c,8\r\nFile   8: 0908.c,8\r\nFile   9: a.out,8\r\nFile  10: gettysburg.txt,8\r\nFile  11: sto,4<\/code><\/pre>\n
The values returned are specific to the operating system. Under Unix, value 8 is a regular file and 4 is a directory. On my PC, the MinGW compiler’s C library lacks the dirent->d_type<\/code> member. So the code doesn’t compile. That’s okay, because a better way is available to read whether a directory entry is a file or directory: Use the stat()<\/em> function, as defined in the sys\/stat.h<\/code> header file:<\/p>\n
int stat(const char *restrict path, struct stat *restrict buf);<\/code><\/p>\n
The stat()<\/em> function requires two arguments. The first is the name (or pathname) to a filename. The second argument is the address of a stat<\/code> structure. This structure is filled with oodles of good info about a directory entry and it’s consistent across all file systems.<\/p>\n
The sys\/stat.h<\/code> header file also defines macros to test for file type, which work similarly to the ctype.h<\/code> macros that examine characters. For a directory entry, the S_ISDIR<\/code> macro is used:<\/p>\n
\r\n#include <stdio.h>\r\n#include <dirent.h>\r\n#include <sys\/stat.h>\r\n\r\nint main()\r\n{\r\n    DIR *folder;\r\n    struct dirent *entry;\r\n    struct stat filestat;\r\n\r\n    folder = opendir(\".\");\r\n    if(folder == NULL)\r\n    {\r\n        perror(\"Unable to read directory\");\r\n        return(1);\r\n    }\r\n\r\n    \/* Read directory entries *\/<\/span>\r\n    while( (entry=readdir(folder)) )\r\n    {\r\n        stat(entry->d_name,&filestat);\r\n        if( S_ISDIR(filestat.st_mode) )\r\n            printf(\"%4s: %s\\n\",\"Dir\",entry->d_name);\r\n        else\r\n            printf(\"%4s: %s\\n\",\"File\",entry->d_name);\r\n    }\r\n    closedir(folder);\r\n\r\n    return(0);\r\n}<\/pre>\n
The stat()<\/em> function appears at Line 21. Its arguments are the name of the file located in the directory (entry->d_name<\/code>) and the address of the stat<\/code> structure filestat<\/code>, declared at Line 9.<\/p>\n
In Line 22, the S_ISDIR<\/code> macro tests the filestat.st_mode<\/code> member. If true, the entry is a directory and it’s flagged as such in the output. Otherwise, the else<\/em> statement flags the entry as a standard file.<\/p>\n
Here’s sample output:<\/p>\n
 Dir: .\r\n Dir: ..\r\nFile: 0825a.c\r\nFile: 0825b.c\r\nFile: 08exercise-a.c\r\nFile: 08exercise-b.c\r\nFile: 0901a.c\r\nFile: 0901b.c\r\nFile: 0908.c\r\nFile: a.out\r\nFile: gettysburg.txt\r\n Dir: sto<\/code><\/pre>\n
This code runs on both the PC and Unix systems, thanks to the stat()<\/em> function.<\/p>\n
You can pull more details from the stat()<\/em> function, including file size and timestamps. I’ll cover that process in next week’s Lesson<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"
The dirent<\/code> structure contains not only a directory entry’s filename, but what kind of file it is. Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-3252","post","type-post","status-publish","format-standard","hentry","category-main"],"_links":{"self":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/3252","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=3252"}],"version-history":[{"count":7,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/3252\/revisions"}],"predecessor-version":[{"id":5055,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/3252\/revisions\/5055"}],"wp:attachment":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=3252"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=3252"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=3252"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}