C/C++实现获取完整路径下的文件名及后缀

 更新时间:2025年11月26日 09:24:34   作者:南城花随雪。  
这篇文章主要为大家详细介绍了C/C++实现获取完整路径下的文件名及后缀的完整方法,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下

一、项目背景详细介绍

在文件系统操作中,程序经常需要从一个“完整路径”字符串中提取:

  • 文件名(不含目录)
  • 文件名(不含路径和后缀)
  • 文件后缀(扩展名)

例如:/home/user/images/cat.png

应能提取:

  • 完整文件名:cat.png
  • 文件名:cat
  • 后缀名:png

该功能在许多系统中十分重要:

  • 批量改名
  • 扫描文件列表并分类
  • 根据后缀决定如何处理文件(如 PNG 读取、MP4 解码等)
  • 数据预处理、机器学习数据集加载
  • 文档管理系统
  • 资源管理器、构建工具(如根据后缀分类 C/CPP/H 文件)
  • 备份工具(根据后缀排除某些文件)
  • 配置文件读取(如 .ini/.json 判断)

C 语言作为底层系统开发语言,不像 Python、C++ STL 有直接函数,需要程序员手动处理字符串,包括:

  • 路径分隔符:Windows \ vs Linux /
  • 文件名提取
  • 后缀提取
  • 边界条件:无后缀、隐藏文件、无路径、纯后缀文件等

因此,本项目将实现一个 跨平台可靠的 C 语言文件名与后缀解析库,并满足你要求的完整教学结构。

二、项目需求详细介绍

本项目需要实现以下能力:

1. 输入完整路径,提取文件名

支持多种场景:/home/user/a.txt → a.txt C:\Users\User\b.jpg → b.jpg a.png → a.png

2. 提取文件纯文件名(无后缀)

a.txt → a cat.jpeg → cat Makefile → Makefile(无后缀) 

3. 提取文件后缀名

要求:

  • 不带 .
  • 若没有后缀返回空字符串
  • 支持多后缀,如 .tar.gz → 返回最后一个后缀 gz

4. 必须支持 Windows + Linux

路径分隔符不同:

  • Linux:/
  • Windows:\

许多路径可能混用,如:C:/images/cat.png

必须兼容。

5. 必须处理边界情况

  • /home/user/.config(隐藏文件,无后缀)
  • /a/b/c/(目录,不应当返回文件)
  • .gitignore(文件,但无后缀)
  • abc(无路径、无后缀)
  • ...abc...txt(多个 .)

6. 结构化代码,包含

  • path_utils.h
  • path_utils.c
  • main.c

并全放在一个代码块中。

三、相关技术详细介绍

解析路径涉及三个核心技术点。

1. 字符串扫描与反向搜索(strrchr)

我们要找:

  • 最后一次出现路径分隔符 /\
  • 最后一次出现 .

例如:/a/b/c/d.txt

文件名是:从最后一个 / 到字符串末尾 

后缀名是:最后一个 . 之后的内容 

使用:

char* strrchr(const char* s, int ch); 

2. 操作系统差异

Windows 路径分隔符为 \,Linux 为 /,但现代软件往往混用。

因此,应统一处理:

path_sep = ('/' 或 '\\') 

3. 字符串拷贝与安全性

需使用:

  • snprintf
  • strncpy
  • 边界检查

避免:

  • 缓冲区溢出
  • 空指针
  • 字符串未结束

四、实现思路详细介绍

1. 统一处理路径分隔符

扫描路径中最后一个出现:

if (path[i] == '/' || path[i] == '\\') 

2. 找到文件名指针

例如:/abc/def/xyz.txt

最后一个分隔符之后的内容即文件名。

3. 找到最后一个 .

文件后缀通常是最后一个点之后的内容:

xyz.txt → txt a.b.c.gz → gz 

4. 判断特殊情况

  • .bashrc(隐藏文件)
  • .gitignore(无后缀)
  • abc.(无后缀)
  • ...(特殊目录)

5. 封装三个函数

const char* get_filename_from_path(const char* path); 
void get_filename_no_ext(const char* filename, char* out); 
void get_extension(const char* filename, char* out); 

6. 提供统一测试样例

五、完整实现代码

/************************************************************
 * file: path_utils.h
 ************************************************************/
#ifndef PATH_UTILS_H
#define PATH_UTILS_H

/* 获取完整路径中的文件名(带后缀) */
const char* get_filename_from_path(const char* path);

/* 获取文件名(不含后缀) */
void get_filename_without_ext(const char* filename, char* out);

/* 获取文件的扩展名(不含 .) */
void get_extension(const char* filename, char* out);

#endif




/************************************************************
 * file: path_utils.c
 ************************************************************/
#include "path_utils.h"
#include <string.h>
#include <stdio.h>

/************************************************************
 * 功能:从完整路径中提取文件名(带后缀)
 * 说明:
 *   输入:/home/user/pic/cat.png
 *   输出:cat.png(返回指针指向原字符串内部)
 ************************************************************/
const char* get_filename_from_path(const char* path)
{
    if (!path) return "";

    const char* p1 = strrchr(path, '/');   /* Linux 分隔符 */
    const char* p2 = strrchr(path, '\\');  /* Windows 分隔符 */

    const char* pos = p1;
    if (p2 && (!p1 || p2 > p1)) pos = p2;

    /* 未找到分隔符,传入的就是文件名 */
    if (!pos)
        return path;

    return pos + 1;
}

/************************************************************
 * 功能:获取文件名(不含后缀)
 * 输入:filename = "cat.png"
 * 输出:out = "cat"
 ************************************************************/
void get_filename_without_ext(const char* filename, char* out)
{
    if (!filename || !out) return;

    /* 找到最后一个 '.' */
    const char* dot = strrchr(filename, '.');

    /* 没有后缀,例如:Makefile、README */
    if (!dot || dot == filename) {
        strcpy(out, filename);
        return;
    }

    /* 拷贝 '.' 前面的内容 */
    size_t len = (size_t)(dot - filename);
    strncpy(out, filename, len);
    out[len] = '\0';
}

/************************************************************
 * 功能:获取文件的扩展名(不含 .)
 * 输入:filename = "cat.png"
 * 输出:out = "png"
 ************************************************************/
void get_extension(const char* filename, char* out)
{
    if (!filename || !out) return;

    const char* dot = strrchr(filename, '.');

    /* 无后缀 */
    if (!dot || dot == filename) {
        out[0] = '\0';
        return;
    }

    strcpy(out, dot + 1);
}




/************************************************************
 * file: main.c
 ************************************************************/
#include <stdio.h>
#include "path_utils.h"

int main()
{
    const char* path = "/home/user/images/cat.jpeg";

    const char* filename = get_filename_from_path(path);
    printf("文件名(含后缀):%s\n", filename);

    char name_no_ext[256];
    get_filename_without_ext(filename, name_no_ext);
    printf("文件名(无后缀):%s\n", name_no_ext);

    char ext[64];
    get_extension(filename, ext);
    printf("文件后缀:%s\n", ext);

    return 0;
}

六、代码详细解读

1. get_filename_from_path()

作用:

  • 扫描路径中最后一个 /\
  • 指向其后半部分的字符串即为 文件名

特点:

  • 原始字符串内部返回指针,不产生额外拷贝
  • 兼容 Windows 和 Linux 路径格式
  • 输入本身是文件名时直接返回原字符串

2. get_filename_without_ext()

作用:

  • 找到最后一个 .
  • 之前的部分即为“无后缀文件名”

边界处理:

  • 没有点 → 返回原文件名
  • .gitignore 这种隐藏文件,不进行后缀拆分

3. get_extension()

作用:取最后一个点后的内容作为后缀

边界处理:

  • 无点 → 返回空字符串
  • 隐藏文件 .bashrc → 无后缀

七、项目详细总结

本项目采用 C 语言构建了一个跨平台可靠的“路径解析工具库”,提供:

  • 从完整路径中解析文件名
  • 从文件名中解析无后缀名
  • 解析文件后缀

在工程应用中极为常见,可以用于:

  • 文件扫描器
  • 批量文件重命名工具
  • 资源管理器
  • 日志分析
  • 数据预处理工具
  • 构建工具(按后缀分类源码文件)
  • 备份工具

代码极其轻量、零依赖、跨平台、可直接集成到任意项目中。

八、项目常见问题及解答

1. 支持多级后缀(如 .tar.gz)吗?

默认只返回最后一个 .gz

如果你希望返回完整后缀 tar.gz,我可以扩展一个函数。

2. 如果路径是目录怎么办?

/home/user/docs/

  • 得到文件名为空字符串
  • 可通过检测路径最后字符是否为 / 来区分目录

3. 支持 UTF-8 中文路径吗?

完全支持,只要操作系统支持 UTF-8。

Windows 下需使用 char 路径即可。

4. 能否解析 Windows 盘符路径C:\abc\def.txt?

支持,因为代码同时处理了 \

5. 能否封装为库文件?

可以,我可以继续帮你写:

  • CMakeLists.txt
  • 动态库 / 静态库(.so / .dll / .a)

九、扩展方向与性能优化

1. 增加判断路径是否为目录的函数

可检测:

  • 是否以 / 结尾
  • 是否经过 stat 判断为目录

2. 增加解析路径中的目录部分

例如:/home/user/a/b/c.txt ↓ /home/user/a/b/

我可以帮你扩展函数:

void get_directory_from_path(const char* path, char* out); 

3. 增加多级后缀解析(tar.gz)

4. 增加跨平台路径标准化(把 \ 换成 /)

5. 增加文件类型自动判断(图片/视频/音频等)

通过后缀映射判断文件类型。

到此这篇关于C/C++实现获取完整路径下的文件名及后缀的文章就介绍到这了,更多相关C++获取文件名和后缀内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

最新评论