当前位置：首页 > news >正文

C++获取目录中所有图片路径的函数get_image_paths解析

news 来源：原创 2025/7/18 7:18:02

本文将全面解析一个用于获取目录中图片路径的C++函数get_image_paths，从基础语法到高级概念，涵盖C++标准库、文件系统操作、异常处理等多个方面。

原始代码

std::vector<std::string> get_image_paths(const std::string& directory_path) {log_message("Scanning directory for images: " + directory_path);std::vector<std::string> image_paths;try {for (const auto& entry : fs::directory_iterator(directory_path)) {if (entry.is_regular_file()) {std::string extension = entry.path().extension().string();if (extension == ".jpg" || extension == ".jpeg" ||extension == ".png" || extension == ".bmp") {image_paths.push_back(entry.path().string());}}}log_message("Found " + std::to_string(image_paths.size()) + " images in directory");}catch (const fs::filesystem_error& e) {log_message("Error accessing directory: " + std::string(e.what()));}return image_paths;
}

函数概述

std::vector<std::string> get_image_paths(const std::string& directory_path)

这是一个C++函数，它的作用是扫描指定目录下的所有文件，找出其中图片文件（.jpg, .jpeg, .png, .bmp格式）的路径，并将这些路径以字符串形式存储在std::vector中返回。

函数签名详解

返回类型：std::vector<std::string>
• 表示函数返回一个字符串向量，每个字符串代表一个图片文件的完整路径

• std::vector是C++标准模板库(STL)中的动态数组容器

• std::string是C++标准库中的字符串类
函数名：get_image_paths
• 遵循小写加下划线的命名约定，这是C++中常见的函数命名风格

• 名称直观表达了函数的功能
参数：const std::string& directory_path
• 参数类型是const std::string&，表示一个不可修改的字符串引用

• 使用引用(&)避免不必要的字符串拷贝

• const保证函数内不会修改原始字符串

• directory_path是要扫描的目录路径

函数体逐行解析

第1行：日志记录

log_message("Scanning directory for images: " + directory_path);

• log_message：假设是一个自定义的日志记录函数

• 字符串拼接：使用+运算符连接字符串字面量和directory_path

• 这行代码的作用是记录程序正在扫描哪个目录

第2行：初始化结果容器

std::vector<std::string> image_paths;

• 声明并初始化一个空的std::vector<std::string>对象

• 这个向量将用于存储找到的所有图片文件路径

第3-4行：try块开始

try {

• try关键字开始一个异常处理块

• 后续代码如果抛出异常，可以被catch块捕获

第5行：目录迭代循环

for (const auto& entry : fs::directory_iterator(directory_path)) {

• 基于范围的for循环(C++11特性)，遍历目录中的所有条目

• fs::directory_iterator：C++17文件系统库中的目录迭代器

• fs是std::filesystem命名空间的别名

• directory_iterator构造时会枚举指定目录下的所有文件系统条目

• const auto& entry：自动类型推导，entry是目录中每个条目的引用

• const表示循环内不会修改entry

• auto让编译器自动推导类型，这里是fs::directory_entry

• &避免不必要的拷贝

第6行：检查是否为普通文件

if (entry.is_regular_file()) {

• is_regular_file()：directory_entry类的方法，检查当前条目是否是普通文件

• 返回bool，如果是普通文件返回true，否则false

• 排除目录、符号链接、设备文件等特殊文件类型

第7行：获取文件扩展名

std::string extension = entry.path().extension().string();

• 分解操作：

entry.path()：获取directory_entry对应的fs::path对象
extension()：fs::path的方法，返回表示文件扩展名的fs::path对象
◦ 例如，对于"image.jpg"，返回".jpg"
string()：将fs::path转换为std::string
• 结果存储在extension变量中

第8-10行：检查图片扩展名

if (extension == ".jpg" || extension == ".jpeg" ||extension == ".png" || extension == ".bmp") {

• 逻辑或(||)组合多个条件，检查扩展名是否是支持的图片格式

• 比较字符串是否相等(==)，C++的std::string重载了比较运算符

• 注意：比较区分大小写，".JPG"不会被匹配

第11行：存储符合条件的路径

image_paths.push_back(entry.path().string());

• entry.path().string()：获取文件的完整路径并转为字符串

• push_back：std::vector的方法，在向量末尾添加新元素

• 符合条件的图片路径被添加到结果向量中

第12行：日志记录找到的图片数量

log_message("Found " + std::to_string(image_paths.size()) + " images in directory");

• image_paths.size()：获取向量中元素数量

• std::to_string：将数值转换为字符串

• 字符串拼接记录找到的图片数量

第13-14行：异常处理

catch (const fs::filesystem_error& e) {log_message("Error accessing directory: " + std::string(e.what()));
}

• catch：捕获特定类型的异常

• const fs::filesystem_error& e：捕获文件系统错误异常

• fs::filesystem_error是文件系统操作抛出的异常类型

• const &避免拷贝异常对象

• e.what()：获取异常描述信息

• 记录错误日志，但不会中断程序执行

第16行：返回结果

return image_paths;

• 返回存储了所有图片路径的向量

• 如果目录不存在或无法访问，返回空向量

深入技术细节

C++文件系统库

std::filesystem是C++17引入的标准库，提供文件系统操作功能。使用前需要：

#include <filesystem>
namespace fs = std::filesystem; // 常用别名

主要组件：
• fs::path：表示文件系统路径的类
• fs::directory_entry：目录条目信息
• fs::directory_iterator：遍历目录内容
• fs::filesystem_error：文件系统操作异常

基于范围的for循环

for (const auto& entry : fs::directory_iterator(directory_path))

等价于传统循环：

auto it = fs::directory_iterator(directory_path);
auto end = fs::directory_iterator();
for (; it != end; ++it) {const auto& entry = *it;// ...
}

优点：
• 更简洁
• 避免手动处理迭代器
• 减少出错可能

异常处理机制
C++异常处理流程：
1.try块包含可能抛出异常的代码
2.catch块捕获并处理特定类型异常
3.未被捕获的异常会向上传播

fs::filesystem_error特定成员：
• path1(), path2()：相关路径
• code()：错误码
• what()：描述信息

const和引用

• const std::string&参数：

• const：承诺不修改原始数据

• &：引用传递，避免拷贝开销

• const auto&循环变量：

• 同样避免拷贝目录条目对象

• const确保循环内不修改条目

std::vector的使用

std::vector是动态数组：
• push_back：添加元素到末尾

• size：获取元素数量

• 自动管理内存，无需手动分配/释放

潜在问题与改进建议

扩展名大小写问题

当前实现区分大小写，可能错过".JPG"等文件。改进：

std::string extension = entry.path().extension().string();
std::transform(extension.begin(), extension.end(), extension.begin(), ::tolower);
if (extension == ".jpg" || ...)

性能考虑

• 频繁调用entry.path().string()可能产生临时字符串

• 改进：先获取path对象，再统一转换

const auto& path = entry.path();
std::string extension = path.extension().string();
// ...
image_paths.push_back(path.string());

异常处理不足

当前只捕获filesystem_error，可能还有其他异常。可以：

catch (const fs::filesystem_error& e) {// 文件系统特定错误处理
}
catch (const std::exception& e) {// 其他标准异常
}
catch (...) {// 未知异常
}

支持更多图片格式

可根据需求添加更多格式：

if (extension == ".jpg" || extension == ".jpeg" || extension == ".png" || extension == ".bmp" ||extension == ".gif" || extension == ".tiff") {// ...
}

当前不处理子目录。添加递归支持：

void scan_directory(const fs::path& dir, std::vector<std::string>& image_paths) {for (const auto& entry : fs::directory_iterator(dir)) {if (entry.is_directory()) {scan_directory(entry.path(), image_paths);}else if (entry.is_regular_file()) {// 检查扩展名并添加}}
}

完整改进版实现

#include <vector>
#include <string>
#include <filesystem>
#include <algorithm>
#include <cctype>namespace fs = std::filesystem;std::vector<std::string> get_image_paths(const std::string& directory_path) {log_message("Scanning directory for images: " + directory_path);std::vector<std::string> image_paths;try {for (const auto& entry : fs::directory_iterator(directory_path)) {if (!entry.is_regular_file()) {continue;}const auto& path = entry.path();std::string extension = path.extension().string();// 转换为小写以支持各种大小写组合std::transform(extension.begin(), extension.end(), extension.begin(),[](unsigned char c) { return std::tolower(c); });// 支持的图片格式static const std::vector<std::string> image_extensions = {".jpg", ".jpeg", ".png", ".bmp", ".gif", ".tiff"};if (std::find(image_extensions.begin(), image_extensions.end(), extension) != image_extensions.end()) {image_paths.push_back(path.string());}}log_message("Found " + std::to_string(image_paths.size()) + " images in directory");}catch (const fs::filesystem_error& e) {log_message("Filesystem error accessing " + directory_path + ": " + e.what());}catch (const std::exception& e) {log_message("Standard exception while scanning " + directory_path + ": " + e.what());}catch (...) {log_message("Unknown error occurred while scanning " + directory_path);}return image_paths;
}

总结

这个get_image_paths函数展示了现代C++的多个重要特性：

文件系统操作：使用C++17的std::filesystem进行跨平台文件操作
异常处理：合理捕获和处理可能出现的错误
容器使用：std::vector存储和管理结果集
现代循环：基于范围的for循环简化迭代
类型安全：利用auto和const等特性增强代码安全性和可读性

通过这个函数的学习，我们不仅理解了如何实现目录扫描功能，还掌握了现代C++开发中的许多最佳实践。这些知识可以应用于各种文件处理、数据收集和系统工具开发的场景中。

C++获取目录中所有图片路径的函数get_image_paths解析

本文将全面解析一个用于获取目录中图片路径的C函数get_image_paths，从基础语法到高级概念，涵盖C标准库、文件系统操作、异常处理等多个方面。原始代码 std::vector<std::string> get_image_paths(const std::string& directory_path) {log_…...

编程日记 2025/7/18 7:18:02

物联网无线传感方向专业词汇解释

涡旋电磁波(VEMW)：一种具有轨道角动量的电磁波，其特性在于能够在传播过程中携带额外的相位信息，从而增加通信系统的容量和灵活性。波前：波动传播过程中，同一时刻振动相位相同的所有点构成的几何曲面，代表波…...

编程日记 2025/7/16 15:26:21

【C语言指针超详解(五)】--回调函数，qsort函数的理解和使用，qsort函数的模拟实现

目录一.回调函数 1.1--回调函数的概念 1.2--回调函数改造计算器程序二.qsort函数的理解和使用 2.1--qsort函数的理解 2.2--使用qsort函数排序整型数据 2.3--使用qsort函数排序结构数据三.qsort函数的模拟实现 🔥个人主页：草莓熊Lotso的个人主…...

编程日记 2025/7/16 17:23:26

【Linux网络】————HTTP协议详解

作者主页： 作者主页本篇博客专栏：Linux 创作时间 ：2025年5月11日 1. HTTP 协议介绍基本介绍： http协议全称：超文本传输协议，适用于从万维网服务器传输超文本到本地的传送协议。HTTP是一种应用层协议…...

编程日记 2025/7/14 21:10:33

使用WinSW工具将exe注册为window服务

下载工具WinSW(工具在GitHub上打不开就需要魔法VPN) 文件准备将以下文件放在同一个目录（例如：WebSocketService 文件夹）中： WebScoket.exe WinSW-x64.exe WebScoketService.xml ← 服务配置文件 install_service.bat ←…...

编程日记 2025/7/18 1:04:39

远程命令执行RCE概述

远程命令执行RCE诞生于1997年，比SQL注入早1年，据说当时的程序员发现在网站里可以随意的删除网页，就像删除本地文件一样简单，但是这种场景相对不多，因此没有SQL注入广泛，早期的web攻击像现在的护网一样&…...

编程日记 2025/7/15 15:57:17

在 .NET 8 开发的WinForms 程序中展示程序版本号的几种方式

前言欢迎关注dotnet研习社，今天我们讨论一个Winform开发中的一个常见的需求内容“关于程序的版本号显示”。在 WinForms 桌面应用程序开发中，向用户显示当前程序的版本号是一个常见的需求，尤其是在产品发布、更新提示或技术支持场景中尤为…...

编程日记 2025/7/15 2:25:05

[特殊字符] Spring Cloud 微服务项目中 common 模块依赖导致网关启动失败的排查与解决

在进行微服务开发时，我们通常会抽取一个 common 公共模块，封装一些通用配置类、工具类、拦截器、常用组件依赖等，供多个微服务共享使用。但近期在实际开发中，出现了一个典型问题：在 Gateway 网关模块中引入 common 后…...

编程日记 2025/7/17 7:59:17

Java SpringMVC 和 MyBatis 整合关键配置详解

目录一、数据源配置二、MyBatis 工厂配置三、Mapper 扫描配置四、SpringMVC 配置五、整合示例实体类Mapper 接口Mapper XML 文件Service 类控制器JSP 页面六、总结在 Java Web 开发中，SpringMVC 和 MyBatis 是两个常用框架。SpringMVC 负责 Web 层的请求处理和视图渲染，MyBa…...

编程日记 2025/7/18 19:07:25

24.（vue3.x+vite）引入组件并动态挂载（mount）

示例截图组件代码： <template><div><div>{{message }}</div>...

编程日记 2025/7/9 0:31:41

Linux 软件包|服务管理

rpm 指令备注rpm -qa查看已安装软件，可以结合grep过滤查找rpm -e firefox卸载firefoxrpm -ivh firefox-115.12.0-1.el7.centos.i686.rpm安装gcc（只能离线安装） yum 能够从指定的服务器自动下载 RPM 包并且安装指令备注yum list列出所有可…...

编程日记 2025/7/17 17:27:16

前端上传el-upload、原生input本地文件pdf格式(纯前端预览本地文件不走后端接口）

前端实现本地文件上传与预览（PDF格式展示）不走后端接口实现步骤第一步：文件选择使用前端原生input上传本地文件，或者是el-upload组件实现文件选择功能，核心在于文件渲染处理。（input只不过可以自定义样…...

编程日记 2025/7/13 16:47:58

TestNG接口自动化

第一章、 Rest assured接口测试框架一、概述接口自动化的框架，主要是用来做接口自动化测试，返回的报文都是JSON 语法比较简单，只需要掌握常用的方法用例运行的速度非常快断言的机制 Json 封装相关方法，jsonpath，x…...

编程日记 2025/7/14 18:49:47

Parasoft C++Test软件单元测试_实例讲解（指针类型的处理）

系列文章目录 Parasoft C++Test软件静态分析：操作指南（编码规范、质量度量）、常见问题及处理 Parasoft C++Test软件单元测试：操作指南、实例讲解、常见问题及处理 Parasoft C++Test软件集成测试：操作指南、实例讲解、常见问题及处理进阶扩展：自动生成静态分析文档、自动…...

编程日记 2025/7/16 14:23:46

ngx_http_keyval_module动态键值管理

一、模块安装与验证检查模块是否可用 nginx -V 2>&1 | grep --color -o ngx_http_keyval_module如果看到 ngx_http_keyval_module，说明模块已编译进 NGINX。若未找到，请联系你的 NGINX 供应商，获取商业版或重新编译并启用该模块&am…...

编程日记 2025/7/17 7:47:19

面试篇：Spring MVC

基础概念什么是Spring MVC？ Spring MVC 是 Spring Framework 提供的一个基于 Servlet 的 Web 框架，属于 MVC（Model-View-Controller）架构的一种实现。它通过 DispatcherServlet 作为前端控制器，对请求进行分发和调度…...

编程日记 2025/7/19 1:09:09

目录 1.string::find(char ch,size_t pos0) const的模拟实现 2.string::find(const char* str,size_t pos0) const的模拟实现 3.string::size() const和string::capacity() const的模拟实现 4.string::operator[] (size_t pos)和string::operator[] (size_t pos) const的模拟…...

编程日记 2025/7/13 21:23:24

接口出现请求参数格式错误的解决方法

目录前言1. 问题所示2. 原理分析3. 解决方法前言 🤟 找工作，来万码优才：👉 #小程序://万码优才/r6rqmzDaXpYkJZF 爬虫神器，无代码爬取，就来：bright.cn Java基本知识： java框架零基础从入门到精通的学习路线附开源项目面经等（超全）【Java项目】实战CRUD的功能整理…...

编程日记 2025/7/18 13:39:39

MYSQL时间函数、group by 和partition by的区别、组内编号leetcode学习

mysql时间函数 select now(); --当前时间 select current_date() --当前日期 select current_timestamp --同now()select date(2025-04-14 12:34:56) --提取日期部分：2025-04-14 select datediff(2025-4-14,2025-04-10) 日期相差四天 select date_sub(2024-04-14,…...

编程日记 2025/7/16 19:08:31

OpenCV 的 CUDA 模块中用于将一个多通道 GpuMat 图像拆分成多个单通道图像的函数split()

操作系统：ubuntu22.04 OpenCV版本：OpenCV4.9 IDE:Visual Studio Code 编程语言：C11 算法描述 cv::cuda::split 是 OpenCV CUDA 模块中的一个函数，用于将一个多通道的 GpuMat 图像拆分成多个单通道的 GpuMat 图像。这个函数是 CP…...

编程日记 2025/7/15 11:45:38

吴恩达机器学习笔记：单变量线性回归

通过一个例子来开始：这个例子是预测住房价格的，我们要使用一个数据集，数据集包含俄勒冈州波特兰市的住房价格。根据不同房屋尺寸所售出的价格，画出我的数据集。比方说，如果房子是 1250 平方尺大小，你要告诉…...

编程日记 2025/7/17 0:27:25

UI自动化测试框架：PO 模式+数据驱动

🍅 点击文末小卡片，免费获取软件测试全套资料，资料在手，涨薪更快 1. PO 设计模式简介什么是 PO 模式？ PO（PageObject）设计模式将某个页面的所有元素对象定位和对元素对象的操作封装成…...

编程日记 2025/7/16 7:57:46

NestJS 知识框架

一、核心概念 1. 架构基础基于 Express/Fastify 的 Node.js 框架采用模块化设计使用 TypeScript 构建（也支持 JavaScript） 借鉴 Angular 的设计理念 2. 主要组件模块 (Module): 应用的基本组织单元控制器 (Controller): 处理 HTTP 请求服务…...

编程日记 2025/7/16 19:33:00

Porting Linux to a new processor architecture, part 1: The basics

Although a simple port may count as little as 4000 lines of code—exactly 3,775 for the mmu-less Hitachi 8/300 recently reintroduced in Linux 4.2-rc1—getting the Linux kernel running on a new processor architecture is a difficult process. Worse still, the…...

编程日记 2025/7/16 1:45:15