深入解析 C++中std::stoul 函数

更新时间：2025年04月21日 10:44:27 作者：极客晨风

std::stoul是 C++ 标准库中的一个字符串转换函数,它用于将 std::string 或 std::wstring 转换为 unsigned long 类型的整数,下面就来介绍一下

1. std::stoul 的基本介绍

std::stoul 定义在 <string> 头文件中，并位于 std 命名空间下。它的主要功能是将字符串转换为 unsigned long 类型的整数，并且支持不同进制的转换

1.1 std::stoul 的函数原型

unsigned long stoul(const std::string& str, size_t* pos = nullptr, int base = 10);
unsigned long stoul(const std::wstring& str, size_t* pos = nullptr, int base = 10);

1.2 参数解析

str：要转换的字符串，必须是有效的无符号整数格式。
pos（可选）：如果提供 pos，stoul 会在 *pos 中存储转换结束的位置（即最后一个转换的字符的下一个位置）。
base（可选）：表示字符串所使用的进制，默认值为 10（十进制），支持 2 到 36 进制。

1.3 返回值

成功：返回转换后的 unsigned long 类型整数。
失败：如果字符串不是有效的数字或超出了 unsigned long 类型的范围，会抛出异常。

2. std::stoul 的实现原理

在 GCC 标准库的 <string> 头文件中，std::stoul 的底层实现基于 std::strtoul，如下：

inline unsigned long
stoul(const string&amp; __str, size_t* __idx = 0, int __base = 10)
{
    return __gnu_cxx::__stoa(&amp;std::strtoul, "stoul", __str.c_str(),
                             __idx, __base);
}

2.1 解析实现代码

调用 std::strtoulstd::strtoul（String to Unsigned Long）是 C 语言中的标准库函数，它可以将 C 风格的字符串转换为 unsigned long 类型的整数，同时支持进制转换。
使用 __gnu_cxx::__stoa 进行封装__stoa 是 GNU C++ 扩展库中的一个工具函数，它用于将 unsigned long 转换为 unsigned long，并进行错误检查。
__str.c_str()std::string 的 .c_str() 方法返回一个 const char*，将 std::string 转换为 C 风格字符串，以便 std::strtoul 解析。

3. std::stoul 的实际用法

3.1 基础示例

#include <iostream>
#include <string>

int main() {
    std::string str = "123456789";
    unsigned long num = std::stoul(str);  // 默认10进制
    std::cout << "转换结果: " << num << std::endl;
    return 0;
}

输出：

转换结果: 123456789

3.2 使用 pos 参数记录转换结束的位置

#include <iostream>
#include <string>

int main() {
    std::string str = "12345xyz";
    std::size_t pos;
    unsigned long num = std::stoul(str, &pos);
    
    std::cout << "转换结果: " << num << std::endl;
    std::cout << "转换结束位置: " << pos << std::endl;
    
    return 0;
}

输出：

转换结果: 12345
转换结束位置: 5

解析：

stoul 解析 "12345" 后遇到 "xyz"，停止转换，并将 pos 设为 5。

3.3 处理不同进制的转换

#include <iostream>
#include <string>

int main() {
    std::string str = "1A";  // 16进制
    unsigned long num = std::stoul(str, nullptr, 16);  // 以16进制解析
    std::cout << "转换结果: " << num << std::endl;
    
    return 0;
}

输出：

转换结果: 26

解析：

1A 在十六进制中等于 26，所以 stoul 返回 26。

其他进制示例

std::stoul("1010", nullptr, 2);  // 以二进制解析，返回 10
std::stoul("75", nullptr, 8);    // 以八进制解析，返回 61
std::stoul("1F", nullptr, 16);   // 以十六进制解析，返回 31

4. 处理异常情况

4.1 输入不是有效的数字

如果 str 不是有效的整数格式，std::stoul 会抛出 std::invalid_argument 异常：

#include <iostream>
#include <string>
#include <stdexcept>

int main() {
    try {
        std::string str = "abc";  
        unsigned long num = std::stoul(str);
        std::cout << "转换结果: " << num << std::endl;
    } catch (const std::invalid_argument& e) {
        std::cerr << "错误: 无效的数字字符串 -> " << e.what() << std::endl;
    }

    return 0;
}

输出：

错误: 无效的数字字符串 -> stoul

4.2 数值超出 unsigned long 范围

如果字符串表示的数值超出 unsigned long 的范围，std::stoul 会抛出 std::out_of_range 异常：

#include <iostream>
#include <string>
#include <climits>

int main() {
    try {
        std::string str = "99999999999999999999";  
        unsigned long num = std::stoul(str);
        std::cout << "转换结果: " << num << std::endl;
    } catch (const std::out_of_range& e) {
        std::cerr << "错误: 数值超出范围 -> " << e.what() << std::endl;
    }

    return 0;
}

输出：

错误: 数值超出范围 -> stoul

5. std::stoul 相关函数

函数	作用	返回类型
`std::stoi`	转换为 `int`	`int`
`std::stol`	转换为 `long`	`long`
`std::stoll`	转换为 `long long`	`long long`
`std::stoul`	转换为 `unsigned long`	`unsigned long`
`std::stoull`	转换为 `unsigned long long`	`unsigned long long`

6. 结论

std::stoul 是 std::strtoul 的封装，支持进制转换。
提供 pos 参数记录转换位置。
可能抛出 std::invalid_argument 和 std::out_of_range 异常。
适用于转换无符号整数，如 unsigned long，如果数值更大，可以使用 std::stoull。

到此这篇关于深入解析 C++中std::stoul 函数的文章就介绍到这了,更多相关C++ std::stoul 内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Qt QChart实现折线图的绘制
QChart是常用的图表，这篇文章主要为大家详细介绍了Qt如何利用QChart实现折线图的绘制，文中的示例代码讲解详细，感兴趣的可以了解一下
2023-04-04
C++中单调栈的基本性质介绍
这篇文章主要介绍了单调栈的基本性质介绍,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下
2021-07-07
C++第三方日志库Glog基本语法详解
这篇文章主要介绍了C++第三方日志库Glog基本语法，本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2022-02-02
C语言字符串函数与内存函数精讲
这篇文章主要介绍一些c语言中常用字符串函数和内存函数的使用，并且为了帮助读者理解和使用，也都模拟实现了他们的代码,需要的朋友可以参考一下
2022-04-04
VS2019+MPI配置过程的实现步骤
本文介绍了在VS2019上配置MPI,包括下载和安装MPI、创建项目、配置属性、导入头文件和库文件、添加依赖项等步骤,具有一定的参考价值,感兴趣的可以了解一下
2024-12-12
C++ std::async的使用总结
这篇文章主要介绍了C++ std::async的使用总结,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2021-01-01
c语言随机数函数示例
这篇文章主要介绍了c语言随机数函数示例,需要的朋友可以参考下
2014-04-04
ffmpeg 在 win平台下的编译以及集成
这篇文章主要为大家介绍了ffmpeg 在 win平台下的编译以及集成详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步早日升职加薪
2023-05-05
C/C++通过IP获取局域网网卡MAC地址
这篇文章主要为大家详细介绍了C++如何通过Win32API函数SendARP从IP地址获取局域网内网卡的MAC地址,感兴趣的小伙伴可以跟随小编一起学习一下
2025-02-02
C语言字符串大小比较
本文给大家分享给大家的是C语言的字符串大小比较的函数，有需要的小伙伴可以参考下。
2015-07-07