| C++ Builder 串口控件 | | C++ Builder 编程技巧 | | C++ Builder 操作指南 | | C++ Builder 参考手册 | | 基础知识 | | cfloat 浮点数 | | cmath 数学函数 | | cstdlib 标准库函数 | | • atof, _ttof, _wtof | | • _atold, _ttold, _wtold | | • atoi, _ttoi, _wtoi | | • atol, _ttol, _wtol | | • _atoi64, _ttoi64, _wtoi64 | | • strtod, _tcstod, wcstod | | • strtof, _tcstof, wcstof | | • strtold, _strtold, _tcstold, wcstold, _wcstold | | • strtol, _tcstol, wcstol | | • strtoll, _tcstoll, wcstoll | | • strtoul, _tcstoul, wcstoul | | • strtoull, _tcstoull, wcstoull | | • itoa, _itot, _itow | | • ltoa, _ltoa, _ltot, _ltow | | • ultoa, _ultot, _ultow | | • _i64toa, _i64tot, _i64tow | | • _ui64toa, _ui64tot, _ui64tow | | • ecvt, _ecvt | | • fcvt, _fcvt | | • gcvt, _gcvt | | • abs, labs, llabs | | • div, ldiv, lldiv | | • div_t, ldiv_t, lldiv_t | | • _rotl, _crotl, _lrotl | | • _rotr, _crotr, _lrotr | | • rand, _lrand | | • srand | | • random | | • randomize | | • mbstowcs | | • mblen | | • mbtowc | | • mbtowc_cp | | • wcstombs | | • wctomb | | • wctomb_cp | | • swab, _swab | | • _fullpath, _tfullpath, _wfullpath | | • _makepath, _tmakepath, _wmakepath | | • _splitpath, _tsplitpath, _wsplitpath | | • getenv, _tgetenv, _wgetenv | | • putenv, _putenv, _tputenv, _wputenv | | • _searchenv, _tsearchenv, _wsearchenv | | • _searchstr, _tsearchstr, _wsearchstr | | • system, _tsystem, _wsystem | | • abort | | • atexit | | • atexit_t | | • exit, _exit | | • abort_handler_s | | • ignore_handler_s | | • constraint_handler_t | | • set_constraint_handler_s | | • _argc | | • _argv, _targv, _wargv; | | • _environ, _tenviron, _wenviron | | • EXIT_SUCCESS, EXIT_FAILURE | | • _MAX_PATH, _MAX_DRIVE, _MAX_DIR, _MAX_FNAME, _MAX_EXT | | • MB_CUR_MAX | | • RAND_MAX, LRAND_MAX | | System 字符串 | | System 日期和时间 | | System.Math.hpp 数学函数 | | 其他数据类型 | | VCL 基础类 | | VCL 应用程序 | | Pictures 图片 | | Graphics 绘图 | | Additional 控件 | | System 控件 | | A ~ Z 字母顺序排列的目录 | | 网友留言/技术支持 |
|
| strtoul, _tcstoul, wcstoul - 字符串转 32 位无符号长整数 (unsigned long), 支持 2 ~ 36 进位制 |
strtoul, _tcstoul, wcstoul：字符串转 32 位无符号长整数 (unsigned long), 支持 2 ~ 36 进位制
函数原型：
| unsigned long strtoul(const char *s, char **endptr, int radix); |
| unsigned long wcstoul(const wchar_t *s, wchar_t **endptr, int radix); |
头文件：
#include <cstdlib>
命名空间：
std
参数：
s：整数字符串，格式："[空白字符][符号][数字]"
endptr：是一个指针，这个指针指向一个字符指针，用来返回当解析结束时指向参数 s 当中的字符的指针。如果指向 s 字符串的结束符，说明没有错误，如果指向 s 当中的其他字符，说明解析到这个字符出错而停止解析。
radix：进位制，范围：2 ~ 36，表示二进制到三十六进制。如果 radix 等于 0，字符串 s 开头字符为 "0x" 或 "0X" 认为是十六进制，开头字符为 "0" 认为是八进制，开头字符 1 ~ 9 认为是十进制。
返回值：
无符号长整数，unsigned long 类型
如果参数 s 包含不可识别的字符，会终止于第一个不可识别的字符，返回前面可识别部分转为整数的值，如果第一个字符不可识别返回值为 0；
如果参数 s 是负数，返回值为这个负数的补码。
如果数值超出了无符号长整数范围会溢出，返回值为 4294967295 (0xFFFFFFFF)，全局变量 errno 的值为 ERANGE。
| s |
radix |
转换结果 |
说明 |
| " 12345" |
0 |
12345 |
|
| "-54321" |
0 |
4294912975 |
4294912975 是 -54321 的补码 |
| "4000000000" |
0 |
4000000000 |
|
| "5000000000" |
0 |
4294967295 |
5000000000 超出了 unsigned long 范围，返回值为 4294967295 (0xFFFFFFFF) |
| "-7777777777" |
0 |
4294967295 |
-7777777777 的补码超出了 unsigned long 长整数范围，返回值为 4294967295 (0xFFFFFFFF) |
| "-1111111111" |
0 |
3183856185 |
3183856185 是 -1111111111 的补码 |
| "123e45" |
0 |
123 |
终止于不可识别的字符 'e'，前面的内容转换结果为 123 |
| "a56789" |
0 |
0 |
第一个字符不可识别，转换结果为 0 |
| "123e45" |
16 |
1195589 |
十六进制数字包含字母 'e'，得到正确的结果 |
| "a56789" |
16 |
10839945 |
十六进制数字包含字母 'a'，得到正确的结果 |
| "0xa56789" |
0 |
10839945 |
"0x" 开头认为是十六进制，得到正确的结果 |
| "087654321" |
0 |
0 |
'0' 开头的字符串认为是八进制，遇到错误的八进制字符 '8' 停止解析 |
| "087654321" |
10 |
87654321 |
指定了进位制为十进制，087654321 是正确的十进制数 |
例1：
void __fastcall TForm1::Button1Click(TObject *Sender)
{
UnicodeString s = Edit1->Text;
wchar_t *wp;
long x = wcstol(s.c_str(), &wp, 0);
int e = errno;
if(e == ERANGE)
ShowMessage(UnicodeString().sprintf(L"转换溢出，转换结果：x = %ld", x));
else if(*wp)
ShowMessage(UnicodeString().sprintf(L"错误字符：'%c', 转换结果：x = %ld", *wp, x));
else
ShowMessage(UnicodeString().sprintf(L"转换结果：x = %ld", x));
} |
 |
|
 |
| 正确的转换结果 |
|
9876543210 超过了 long 的范围，溢出，结果为 0 |
| |
|
|
 |
|
 |
参数 radix 为 0，认为 0 开头的字符串为八进制，
如果避免这种错误，把 radix 参数设为 10，始终认为是十进制 |
|
默认按照十进制转换，字符 'a' 为错误字符，
转换结果为字符 'a' 之前的内容：12345 |
例2：
void __fastcall TForm1::Button1Click(TObject *Sender)
{
UnicodeString s;
wchar_t *wp; _TCHAR *tp; char *cp;
s.cat_sprintf(L" wcstoul(L\" 12345\", &wp, 0) = %lu\r\n", wcstoul(L" 12345", &wp, 0) );
s.cat_sprintf(L" wcstoul(L\"-54321\", &wp, 0) = %lu\r\n", wcstoul(L"-54321", &wp, 0) );
s.cat_sprintf(L"_tcstoul(_T(\"4000000000\"), &tp, 0) = %lu\r\n", _tcstoul(_T("4000000000"), &tp, 0) );
s.cat_sprintf(L"_tcstoul(_T(\"5000000000\"), &tp, 0) = %lu\r\n", _tcstoul(_T("5000000000"), &tp, 0) );
s.cat_sprintf(L" strtoul(\"-7777777777\", &cp, 0) = %lu\r\n", strtoul("-7777777777", &cp, 0) );
s.cat_sprintf(L" strtoul(\"-1111111111\", &cp, 0) = %lu\r\n", strtoul("-1111111111", &cp, 0) );
s.cat_sprintf(L" wcstoul(L\"123e45\", &wp, 0) = %lu\r\n", wcstoul(L"123e45", &wp, 0) );
s.cat_sprintf(L" wcstoul(L\"a56789\", &wp, 0) = %lu\r\n", wcstoul(L"a56789", &wp, 0) );
s.cat_sprintf(L" wcstoul(L\"123e45\", &wp, 16) = %lu\r\n", wcstoul(L"123e45", &wp, 16) );
s.cat_sprintf(L" wcstoul(L\"a56789\", &wp, 16) = %lu\r\n", wcstoul(L"a56789", &wp, 16) );
s.cat_sprintf(L" wcstoul(L\"0xa56789\", &wp, 0) = %lu\r\n", wcstoul(L"0xa56789", &wp, 0) );
s.cat_sprintf(L" wcstoul(L\"087654321\", &wp, 0) = %lu\r\n", wcstoul(L"087654321", &wp, 0) );
s.cat_sprintf(L" wcstoul(L\"087654321\", &wp, 10) = %lu\r\n", wcstoul(L"087654321", &wp, 10) );
Memo1->Lines->Text = s;
} |
兼容性：
| 函数 \ C++ Builder 编译器 |
bcc32 |
clang32 |
clang64 |
| strtoul |
√ |
√ |
√ |
| _tcstoul |
√ |
√ |
√ |
| wcstoul |
√ |
√ |
√ |
相关链接：
• atoi • atol • _atoi64 • strtol • strtoll • strtoul • strtoull
• itoa • ltoa • ultoa • _i64toa • _ui64toa
• IntToStr • UIntToStr • IntToHex
• StrToInt • StrToIntDef • StrToInt64 • StrToInt64Def • StrToUInt64 • StrToUInt64Def
• EnumToStr • StrToEnum
|
|
|
|
