定义在 src\core\ngx_string.c
static u_char *
ngx_sprintf_num(u_char *buf, u_char *last, uint64_t ui64, u_char zero,
ngx_uint_t hexadecimal, ngx_uint_t width)
{
u_char *p, temp[NGX_INT64_LEN + 1];
/*
* we need temp[NGX_INT64_LEN] only,
* but icc issues the warning
*/
size_t len;
uint32_t ui32;
static u_char hex[] = "0123456789abcdef";
static u_char HEX[] = "0123456789ABCDEF";
p = temp + NGX_INT64_LEN;
if (hexadecimal == 0) {
if (ui64 <= (uint64_t) NGX_MAX_UINT32_VALUE) {
/*
* To divide 64-bit numbers and to find remainders
* on the x86 platform gcc and icc call the libc functions
* [u]divdi3() and [u]moddi3(), they call another function
* in its turn. On FreeBSD it is the qdivrem() function,
* its source code is about 170 lines of the code.
* The glibc counterpart is about 150 lines of the code.
*
* For 32-bit numbers and some divisors gcc and icc use
* a inlined multiplication and shifts. For example,
* unsigned "i32 / 10" is compiled to
*
* (i32 * 0xCCCCCCCD) >> 35
*/
ui32 = (uint32_t) ui64;
do {
*--p = (u_char) (ui32 % 10 + '0');
} while (ui32 /= 10);
} else {
do {
*--p = (u_char) (ui64 % 10 + '0');
} while (ui64 /= 10);
}
} else if (hexadecimal == 1) {
do {
/* the "(uint32_t)" cast disables the BCC's warning */
*--p = hex[(uint32_t) (ui64 & 0xf)];
} while (ui64 >>= 4);
} else { /* hexadecimal == 2 */
do {
/* the "(uint32_t)" cast disables the BCC's warning */
*--p = HEX[(uint32_t) (ui64 & 0xf)];
} while (ui64 >>= 4);
}
/* zero or space padding */
len = (temp + NGX_INT64_LEN) - p;
while (len++ < width && buf < last) {
*buf++ = zero;
}
/* number safe copy */
len = (temp + NGX_INT64_LEN) - p;
if (buf + len > last) {
len = last - buf;
}
return ngx_cpymem(buf, p, len);
}作用：将给定的 64 位无符号整数格式化为字符串，并填充到目标缓冲区
buf：目标缓冲区
last：目标缓冲区的最后一个有效位置的下一个位置（防止溢出）
ui64：64 位无符号整数，要转换的数值
zero：用于填充的字符
hexadecimal 决定进制（0=十进制，1=小写十六进制，2=大写十六进制）
width 是输出字符串的总宽度（不足时填充）
返回指针指向最后一个有效字符的下一个位置，便于链式调用
static u_char *
ngx_sprintf_num(u_char *buf, u_char *last, uint64_t ui64, u_char zero,
ngx_uint_t hexadecimal, ngx_uint_t width)
{
u_char *p, temp[NGX_INT64_LEN + 1];
/*
* we need temp[NGX_INT64_LEN] only,
* but icc issues the warning
*/
size_t len;
uint32_t ui32;
static u_char hex[] = "0123456789abcdef";
static u_char HEX[] = "0123456789ABCDEF";
p = temp + NGX_INT64_LEN;u_char *p, temp[NGX_INT64_LEN + 1];temp 临时存放转换后字符的地方
p 指向这个临时区的当前处理位置
NGX_INT64_LEN
64位整数转换成字符串后字符串的最大长度
初始化时，p 指向 temp 数组的末尾之后
if (hexadecimal == 0) {
hexadecimal == 0 表示采用十进制表示此时
hexadecimal=0
if (ui64 <= (uint64_t) NGX_MAX_UINT32_VALUE) {如果
ui64是 32 位以内的值（<= NGX_MAX_UINT32_VALUE），则转为uint32_t处理，以减少 64 位除法的性能损耗此时
ui32=2
do {
*--p = (u_char) (ui32 % 10 + '0');
} while (ui32 /= 10);通过循环取余 10，将每一位转为 ASCII 字符，从
temp数组末尾向前填充此时
循环了一次
*p=2
/* zero or space padding */
len = (temp + NGX_INT64_LEN) - p;计算转换后的数字字符串的长度
此时
len=1
while (len++ < width && buf < last) {
*buf++ = zero;
}这里len初始值是数字转换字符串后的长度，width是用户指定的总宽度。
如果数字长度小于width，就需要在数字前面填充zero字符（如'0'或空格），直到达到指定宽度。
每次循环填充一个字符，同时检查buf是否超过last，避免缓冲区溢出。
/* number safe copy */
len = (temp + NGX_INT64_LEN) - p;
if (buf + len > last) {
len = last - buf;
}
return ngx_cpymem(buf, p, len);前面的填充循环修改了len变量，因此需要重新获取正确的长度
检查if (buf + len > last)，确定缓冲区剩余空间是否足够复制整个数字字符串
如果不够，则调整len为剩余空间的大小，防止溢出
最后使用ngx_cpymem函数将转换后的字符串从临时区复制到缓冲区，并返回新的buf位置。