| Types and objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defined in header <stdio.h> | ||
int remove(constchar* pathname); | ||
Deletes the file identified by the character string pointed to bypathname.
If the file is currently open by any process, the behavior of this function is implementation-defined. POSIX systems unlink the file name (directory entry), but the filesystem space used by the file is not reclaimed while it is open in any process and while other hard links to the file exist. Windows does not allow the file to be deleted in such cases.
Contents |
| pathname | - | pointer to a null-terminated string containing the path identifying the file to delete |
0 upon success or non-zero value on error.
POSIX specifies many additional details for the behavior of this function.
#include <stdio.h>#include <stdlib.h> int main(void){FILE* fp=fopen("file1.txt","w");// create fileif(!fp){perror("file1.txt");returnEXIT_FAILURE;}puts("Created file1.txt");fclose(fp); int rc= remove("file1.txt");if(rc){perror("remove");returnEXIT_FAILURE;}puts("Removed file1.txt"); fp=fopen("file1.txt","r");// Failure: file does not existif(!fp)perror("Opening removed file failed"); rc= remove("file1.txt");// Failure: file does not existif(rc)perror("Double-remove failed"); returnEXIT_SUCCESS;}
Possible output:
Created file1.txtRemoved file1.txtOpening removed file failed: No such file or directoryDouble-remove failed: No such file or directory
| renames a file (function)[edit] | |
C++ documentation forremove | |
