_rtl_chmod, _wrtl_chmod
Remonter à Io.h - Index
Header File
io.h
Category
Input/output Routines
Prototype
int _rtl_chmod(const char *path, int func [, int attrib]);
int _wrtl_chmod(const wchar_t *path, int func, ... );
Description
Gets or sets file attributes.
Remarque : The _rtl_chmod function replaces _chmod which is obsolete
_rtl_chmod can either fetch or set file attributes. If func is 0, _rtl_chmod returns the current attributes for the file. If func is 1, the attribute is set to attrib.
attrib can be one of the following symbolic constants (defined in dos.h):
FA_RDONLY |
Read-only attribute |
FA_HIDDEN |
Hidden file |
FA_SYSTEM |
System file |
FA_LABEL |
Volume label |
FA_DIREC |
Directory |
FA_ARCH |
Archive |
Return Value
On success, _rtl_chmod returns the file attribute word.
On error, it returns a value of -1 and sets the global variable errno to one of the following values:
ENOENT |
Path or filename not found |
EACCES |
Permission denied |
Example
#include <errno.h>
#include <stdio.h>
#include <dir.h>
#include <io.h>
int get_file_attrib(char *filename);
int main(void)
{
char filename[128];
int attrib;
printf("Enter a filename:");
scanf("%s", filename);
attrib = get_file_attrib(filename);
if (attrib == -1)
switch(errno)
{
case ENOENT : printf("Path or file not found.\n");
break;
case EACCES : printf("Permission denied.\n");
break;
default: printf("Error number: %d", errno);
break;
}
else
{
if (attrib & FA_RDONLY)
printf("%s is read-only.\n", filename);
if (attrib & FA_HIDDEN)
printf("%s is hidden.\n", filename);
if (attrib & FA_SYSTEM)
printf("%s is a system file.\n", filename);
if (attrib & FA_DIREC)
printf("%s is a directory.\n", filename);
if (attrib & FA_ARCH)
printf("%s is an archive file.\n", filename);
}
return 0;
}
/* returns the attributes of a DOS file */
int get_file_attrib(char *filename)
{
return(_rtl_chmod(filename, 0));
}
Portability
POSIX | Win32 | ANSI C | ANSI C++ | |
---|---|---|---|---|
_rtl_chmod |
+ |
|||
_wrtl_chmod |
NT only |