更新代码

include/QCL_Include.hpp

@@ -1,48 +1,54 @@
-// 包含常用 STL 头文件 + c/c++开发中的核心组件
+/**
-
+ * @file qcl_include.hpp
+ * @brief 通用C++开发头文件集合（Linux环境）
+ * @note 使用前确保目标平台支持C++17标准
+ */
 #ifndef QCL_INCLUDE_HPP
 #define QCL_INCLUDE_HPP
 
-//  C++ 标准库 - 基础功能
+// ==================== C/C++基础运行时库 ====================
-#include <iostream>
+#include <iostream> // 标准输入输出流（cin/cout/cerr）
-#include <string>
+#include <string>   // std::string类及相关操作
-#include <cstring>
+#include <cstring>  // C风格字符串操作（strcpy/strcmp等）
-#include <cstdlib>
+#include <cstdlib>  // 通用工具函数（atoi/rand/malloc等）
-#include <cstdio>
+#include <cstdio>   // C风格IO（printf/scanf）
-#include <cassert>
+#include <cassert>  // 断言宏（调试期检查）
-#include <cmath>
+#include <cmath>    // 数学函数（sin/pow等）
-#include <ctime>
+#include <ctime>    // 时间处理（time/clock）
-#include <csignal>
+#include <csignal>  // 信号处理（signal/kill）
+#include <memory>   // 智能指针
 
-//  容器与算法
+// ==================== STL容器与算法 ====================
-#include <vector>
+#include <vector>        // 动态数组（连续内存容器）
-#include <list>
+#include <list>          // 双向链表
-#include <deque>
+#include <deque>         // 双端队列
-#include <map>
+#include <map>           // 有序键值对（红黑树实现）
-#include <set>
+#include <set>           // 有序集合
-#include <unordered_map>
+#include <unordered_map> // 哈希表实现的键值对
-#include <unordered_set>
+#include <unordered_set> // 哈希表实现的集合
-#include <stack>
+#include <stack>         // 栈适配器（LIFO）
-#include <queue>
+#include <queue>         // 队列适配器（FIFO）
-#include <algorithm>
+#include <algorithm>     // 通用算法（sort/find等）
-#include <numeric>
+#include <numeric>       // 数值算法（accumulate等）
-#include <iterator>
+#include <iterator>      // 迭代器相关
 
-// 字符串与流处理
+// ==================== 字符串与流处理 ====================
-#include <sstream>
+#include <sstream>    // 字符串流（内存IO）
-#include <fstream>
+#include <fstream>    // 文件流（文件IO）
-#include <iomanip>
+#include <iomanip>    // 流格式控制（setw/setprecision）
+#include <regex>      // 正则表达式
+#include <filesystem> // 文件系统(C++17)
 
-// 多线程支持（C++11 起）
+// ==================== 并发编程支持 ====================
-#include <thread>
+#include <thread>             // 线程管理（std::thread）
-#include <mutex>
+#include <mutex>              // 互斥锁（mutex/lock_guard）
-#include <atomic>
+#include <atomic>             // 原子操作（线程安全变量）
-#include <condition_variable>
+#include <condition_variable> // 条件变量（线程同步）
 
-// 网络支持（平台相关）
+// ==================== Linux网络编程 ====================
-#include <sys/socket.h>
+#include <sys/socket.h> // 套接字基础API（socket/bind）
-#include <netinet/in.h>
+#include <netinet/in.h> // IPV4/IPV6地址结构体
-#include <arpa/inet.h>
+#include <arpa/inet.h>  // 地址转换函数（inet_pton等）
-#include <unistd.h>
+#include <unistd.h>     // POSIX API（close/read/write）
 
 #endif // QCL_INCLUDE_HPP