ฟังก์ชันไลบรารี C การเปลี่ยนชื่อ int (const char *old_filename, const char *new_filename) ทำให้ชื่อไฟล์อ้างอิงโดย old_filename จะถูกเปลี่ยนเป็น new_filename
ต่อไปนี้เป็นการประกาศฟังก์ชัน rename()
int rename(const char *old_filename, const char *new_filename)
พารามิเตอร์คือ old_filename − นี่คือสตริง C ที่มีชื่อของไฟล์ที่จะเปลี่ยนชื่อและ/หรือย้าย new_filename − นี่คือสตริง C ที่มีชื่อใหม่สำหรับไฟล์
เมื่อสำเร็จ ระบบจะคืนค่าศูนย์ เมื่อมีข้อผิดพลาด -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.txt มีเนื้อหาบางส่วน ดังนั้น เราจะเปลี่ยนชื่อไฟล์นี้ โดยใช้โปรแกรมข้างต้น ให้เราคอมไพล์และรันโปรแกรมข้างต้นเพื่อสร้างข้อความต่อไปนี้ และไฟล์จะถูกเปลี่ยนชื่อเป็นไฟล์ newfile.txt
ผลลัพธ์
File renamed successfully