一句话理解 rename

「rename 就像文件系统的“改名大师”，不仅能给文件/目录换名字，还能帮它们“搬家”到不同路径，但搬家前要确保新家地址合法且没被占用！」

函数原型

#include 
int rename(const char *oldname, const char *newname);

入口参数

返回参数

核心功能图解

rename("old.txt", "new.txt");       // 改名  
rename("data/file.txt", "backup/file.txt");  // 移动+改名

代码实例：文件改名与搬家实战

场景1：基础改名（文件重命名）

#include 

int main() {
    const char *old_name = "draft.txt";
    const char *new_name = "final_report.txt";
    
    if (rename(old_name, new_name) == 0) {
        printf(" 文件已从 [%s] 更名为 [%s]\n", old_name, new_name);
    } else {
        perror(" 改名失败");  // 打印错误详情
    }
    return 0;
}

成功输出：

 文件已从 [draft.txt] 更名为 [final_report.txt]

场景2：跨目录移动文件（文件“搬家”）

#include 
#include 

int main() {
    // 确保目标目录存在（Linux/macOS）
    system("mkdir -p backup");  // 创建backup目录
    
    if (rename("data.log", "backup/data_2023.log") == 0) {
        printf(" 文件已归档到 backup 目录\n");
    } else {
        perror(" 文件搬家失败");
    }
    return 0;
}

场景3：错误处理（覆盖保护）

#include 
#include 
#include 

void safe_rename(const char *oldname, const char *newname) {
    if (rename(oldname, newname) == 0) {
        printf(" 操作成功\n");
    } else {
        // 根据错误码提示具体原因
        switch(errno) {
            case ENOENT:
                printf(" 原文件不存在：%s\n", oldname);
                break;
            case EACCES:
                printf(" 权限不足，无法操作：%s → %s\n", oldname, newname);
                break;
            case EEXIST:
                printf(" 目标文件已存在，拒绝覆盖：%s\n", newname);
                break;
            default:
                printf(" 未知错误：[%d] %s\n", errno, strerror(errno));
        }
    }
}

int main() {
    safe_rename("ghost.txt", "new_ghost.txt");  // 原文件不存在
    safe_rename("/etc/passwd", "hack.txt");     // 权限不足
    safe_rename("data.txt", "existing.txt");    // 目标文件已存在
    return 0;
}

输出示例：

 原文件不存在：ghost.txt  
 权限不足，无法操作：/etc/passwd → hack.txt  
 目标文件已存在，拒绝覆盖：existing.txt

技术细节剖析

1. 跨文件系统的限制

• 同一磁盘：rename 可以自由移动文件。
• 跨磁盘操作：部分系统可能失败，需手动复制+删除。

2. 原子性保证

• 操作不可中断：rename 是原子操作，要么完全成功，要么完全失败，不会出现中间状态。

3. 目录操作

• 重命名目录：可以直接重命名空目录。
• 移动非空目录：需确保目标文件系统支持。

常见错误

1. 路径分隔符混淆

// Windows中错误写法（应用\\或/）
rename("data\\old.txt", "data/new.txt");  

修复：

rename("data/old.txt", "data/new.txt");  // 统一使用正斜杠

2. 目标文件已存在

// 若 new.txt 已存在，默认覆盖（Linux）或失败（Windows）
rename("old.txt", "new.txt");  

安全策略：

// 先检查目标是否存在
if (access(newname, F_OK) == 0) {
    printf("目标文件已存在，请手动确认！\n");
} else {
    rename(oldname, newname);
}

高级技巧：批量重命名

#include 
#include   // 目录操作

void batch_rename(const char *dir, const char *prefix) {
    DIR *d = opendir(dir);
    if (!d) return;

    struct dirent *entry;
    int count = 1;
    char old_path[256], new_path[256];
    
    while ((entry = readdir(d)) != NULL) {
        if (entry->d_type == DT_REG) {  // 只处理普通文件
            snprintf(old_path, sizeof(old_path), "%s/%s", dir, entry->d_name);
            snprintf(new_path, sizeof(new_path), "%s/%s%d.txt", dir, prefix, count++);
            rename(old_path, new_path);
        }
    }
    closedir(d);
}

int main() {
    batch_rename("docs", "document_");  // 重命名为 document_1.txt, document_2.txt...
    return 0;
}

总结表格

总结

• 像文件管家：rename 是C语言中最高效的文件管理工具，特点：
  1 一键操作：改名和移动一气呵成
  2 原子安全：无中间状态，数据安全
  3 跨平台差异：需注意路径格式和覆盖行为
• 使用口诀：
  「路径合法，目标无主；权限在手，改名无忧！」