# util

**Repository Path**: ztwlla/util

## Basic Information

- **Project Name**: util
- **Description**: No description available
- **Primary Language**: C++
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-14
- **Last Updated**: 2026-06-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# util

C++ 基础工具库，提供字符串操作、时间格式化、编码转换、内存缓冲、网络流序列化、线程同步、GUID 生成等功能。

## 编译要求

- C++20
- CMake ≥ 3.14

## 依赖

无外部依赖，纯自包含实现。

## 编译安装

```bash
mkdir build && cd build
cmake .. -DCMAKE_INSTALL_PREFIX=$HOME/install -DCMAKE_BUILD_TYPE=Release
make
make install
```

安装后头文件位于 `<prefix>/include/util/`，库文件位于 `<prefix>/lib/libutil.a`。

## 主要模块

| 头文件 | 说明 |
|---|---|
| `util_string.h` | 字符串工具：`split()`, `replace()`, `Trim()`, `htoi()`, `StringFormat()` |
| `util_time_format.h` | 时间格式化：`DateTime`, `CTimeFormat` |
| `util_encode_conv.h` | 编码转换：`EncodeConvert::WtoUTF8()`, `AtoUTF8()` 等 |
| `util_membuf.h` | 链表式内存缓冲区 |
| `util_memfile.h` | 连续内存文件 |
| `util_netstream.h` | 网络字节流序列化/反序列化 |
| `util_mutex.h` | 线程同步：`CriticalSection`, `SlimRWLock`, `Cond` |
| `util_thread.h` | 线程工具：`GetCurrentThreadId()` |
| `util_clock.h` | 高精度计时器 |
| `util_guid.h` | GUID/UUID 生成 |
| `util_endian.h` | 字节序转换 |
| `util_def.h` | 基础宏：`SAFE_DELETE`, `SAFE_FREE`, `MAX_PATH` |
| `util_public.h` | 平台检测：`WINDOWS_IMPL`/`LINUX_IMPL`，`strcasecmp` 兼容宏 |
| `util_singleton.h` | 线程安全单例模板 |
| `util_settings.h` | INI 配置文件读取 |