rename() फ़ंक्शन
C लाइब्रेरी फ़ंक्शन int rename(const char *old_filename, const char *new_filename) old_filename द्वारा संदर्भित फाइलनाम को new_filename में बदल देता है।
डिक्लेरेशन
int rename(const char *old_filename, const char *new_filename)
पैरामीटर्स
old_filename- रीनेम/मूव की जाने वाली फाइल का नाम रखने वाला C स्ट्रिंगnew_filename- फाइल के लिए नया नाम रखने वाला C स्ट्रिंग
रिटर्न वैल्यू
- सफलता पर:
0 - एरर पर:
-1, औरerrnoउचित रूप से सेट होता है
उदाहरण
#include <stdio.h>
int main() {
int ret;
char oldname[] = "file.txt";
char newname[] = "newfile.txt";
ret = rename(oldname, newname);
if (ret == 0) {
printf("File renamed successfully");
} else {
printf("Error: unable to rename the file");
}
return 0;
}
आउटपुट
File renamed successfully
व्यवहार नोट्स
- यदि
new_filenameपहले से मौजूद है, तो व्यवहार सिस्टम-निर्भर है (POSIX: परमाणु रूप से प्रतिस्थापित करता है, विंडोज: विफल होता है) - समान फाइलसिस्टम पर होने पर फाइल्स को डायरेक्टरीज के बीच मूव कर सकता है
- ओपन फाइल हैंडल्स: POSIX पर काम करता है, विंडोज पर विफल हो सकता है
- C++17 में:
std::filesystem::rename()(पसंदीदा, क्रॉस-प्लेटफॉर्म)
C++17 फाइलसिस्टम दृष्टिकोण (पसंदीदा)
#include <iostream>
#include <filesystem>
#include <fstream>
namespace fs = std::filesystem;
int main() {
fs::path oldname = "file.txt";
fs::path newname = "newfile.txt";
// फाइल बनाएं
{
ofstream ofs(oldname);
ofs << "Content";
}
try {
fs::rename(oldname, newname);
cout << "File renamed successfully" << endl;
} catch (const fs::filesystem_error& e) {
cout << "Error: " << e.what() << endl;
// e.code() एरर कोड देता है
}
return 0;
}
rename vs remove + write
rename() परमाणु है (समान फाइलसिस्टम पर) - या तो पूरी तरह सफल होता है या बिल्कुल नहीं। यह डेटा इंटीग्रिटी के लिए महत्वपूर्ण है।
सामान्य errno मान
| errno | अर्थ |
|---|---|
ENOENT | सोर्स फाइल मौजूद नहीं है |
EEXIST | डेस्टिनेशन मौजूद है (विंडोज/कुछ सिस्टम्स) |
EXDEV | क्रॉस-डिवाइस (अलग फाइलसिस्टम) |
EACCES | अनुमति अस्वीकृत |
EBUSY | फाइल उपयोग में है (विंडोज) |