在C++开发中，十六进制字符串转整数是非常常见的需求，比如解析配置文件中的十六进制数值、处理网络传输的十六进制数据等场景都会用到。标准库提供的stoul函数是实现该功能的常用工具，它支持灵活指定转换进制，能够高效完成转换工作。
stoul函数的基本定义
stoul是C++11标准引入的字符串转换函数，定义在<string>头文件中，主要功能是将字符串转换为无符号长整型（unsigned long）。它的函数原型如下：
#include <string> unsigned long stoul(const string& str, size_t* idx = 0, int base = 10);
参数说明：
- str：需要转换的输入字符串，支持包含十六进制前缀0x或者0X，也可以不包含。
- idx：可选参数，是一个指向size_t类型的指针，函数执行成功后会把第一个未被转换的字符的下标赋值给该指针指向的变量，如果不需要这个信息可以传入nullptr或者0。
- base：转换使用的进制，默认是10，当设置为0时，函数会根据字符串前缀自动判断进制，比如0x开头会按十六进制处理，0开头按八进制处理，其他情况按十进制处理；设置为16时则强制按十六进制转换。
十六进制字符串转整数的基础用法
使用stoul转换十六进制字符串非常简单，只需要将base参数设置为16即可，以下是最基础的转换示例：
#include <iostream>
#include <string>
using namespace std;
int main() {
string hexStr1 = "1A3F"; // 不带0x前缀的十六进制字符串
string hexStr2 = "0x2B7C"; // 带0x前缀的十六进制字符串
// 转换不带前缀的字符串，base设为16
unsigned long num1 = stoul(hexStr1, nullptr, 16);
// 转换带前缀的字符串，base设为0会自动识别进制
unsigned long num2 = stoul(hexStr2, nullptr, 0);
cout << "hexStr1转换结果：" << num1 << endl;
cout << "hexStr2转换结果：" << num2 << endl;
return 0;
}
上述代码的输出结果为：
hexStr1转换结果：6719 hexStr2转换结果：11132
使用idx参数获取未转换字符位置
当输入的字符串中包含非十六进制字符时，stoul会转换到第一个无效字符为止，此时可以通过idx参数获取转换停止的位置，示例代码如下：
#include <iostream>
#include <string>
using namespace std;
int main() {
string hexStr = "1A3Fxyz123";
size_t pos;
unsigned long num = stoul(hexStr, &pos, 16);
cout << "转换结果：" << num << endl;
cout << "第一个未转换字符的下标：" << pos << endl;
cout << "未转换的部分：" << hexStr.substr(pos) << endl;
return 0;
}
运行后输出：
转换结果：6719 第一个未转换字符的下标：4 未转换的部分：xyz123
异常处理注意事项
stoul在转换失败时会抛出两种异常，使用时需要注意捕获：
- invalid_argument异常：当输入字符串中没有有效的数字字符时抛出，比如字符串是空串或者全是字母。
- out_of_range异常：当转换后的数值超出了unsigned long的表示范围时抛出。
以下是异常处理的示例代码：
#include <iostream>
#include <string>
#include <stdexcept>
using namespace std;
int main() {
string invalidStr = "xyz";
try {
unsigned long num = stoul(invalidStr, nullptr, 16);
cout << "转换结果：" << num << endl;
} catch (const invalid_argument& e) {
cout << "转换失败：输入字符串无有效十六进制字符" << endl;
} catch (const out_of_range& e) {
cout << "转换失败：数值超出unsigned long范围" << endl;
}
return 0;
}
其他十六进制字符串转整数方式对比
除了stoul之外，C++中还有其他方式可以实现十六进制字符串转整数，以下是常见方式的对比：
| 实现方式 | 优点 | 缺点 |
|---|---|---|
| stoul函数 | 标准库支持，使用简单，支持异常提示，自动处理前缀 | 仅能转换为无符号长整型，超出范围会抛异常 |
| stringstream流转换 | 支持多种类型转换，使用灵活 | 需要手动设置进制，错误处理不够直观 |
| sscanf函数 | C语言兼容，使用简单 | 不支持异常，安全性较低，需要提前分配变量 |
stringstream的转换示例如下：
#include <iostream>
#include <sstream>
#include <string>
using namespace std;
int main() {
string hexStr = "1A3F";
stringstream ss;
ss << hex << hexStr;
unsigned int num;
ss >> num;
cout << "转换结果：" << num << endl;
return 0;
}
使用建议
在实际开发中，如果只需要将十六进制字符串转换为无符号长整型，优先选择stoul函数，它能够提供清晰的异常信息，使用起来也更简洁。如果转换的数值可能超出unsigned long的范围，或者需要转换为其他整数类型，可以考虑使用其他方法，或者先转换为更大的类型再进行处理。另外需要注意输入字符串的格式，避免出现无效的字符导致转换失败。
C++stoul十六进制字符串转整数字符串转换修改时间：2026-06-19 21:48:47