sprintf函数、snprintf函数、asprintf函数、vsprintf

灰太狼 2022-01-28 00:39 429阅读 0赞

### **sprintf函数:** ###

### 功能 ###

把格式化的数据写入某个[字符串][Link 1][缓冲区][Link 2]。

### 头文件 ###

[stdio.h][]

### 原型 ###

int sprintf( char \*buffer, const char \*format, \[ argument\] … );

### 参数列表 ###

***buffer***：[char][]型指针，指向将要写入的字符串的缓冲区。

***format***：格式化字符串。

***\[argument\]..******.***：可选参数，可以是任何类型的数据。

返回值：字符串长度（[strlen][]）

**snprintf函数:**

数原型：  
**int snprintf(char \*str, size\_t size, const char \*format, ...);**

size 的作用就是限制往str写入不超过size个字节(包括了结尾的'/0')。

因为sprintf()函数如果成功的话，返回成功写入的字节数(字符数)，我就一直以为snprintf()函数也是如此，也就是snprintf()函数不会返回大于size的整数。

……如果输出因为size的限制而被截断，返回值将是“如果有足够空间存储，所 **应** 能输出的字符数(不包括字符串结尾的'/0')”，这个值和size相等或者比size大！也就是说，如果可以写入的字符串是 "0123456789ABCDEF" 共16位，但是size限制了是10，这样 snprintf() 的返回值将会是**16 **而不是 10 ！

上面的内容还说，如果返回值等于或者大于size，则表明输出字符串被截断了(truncated)。

**asprintf函数**

函数原型：

**int asprintf(char \*\****strp***, const char \****fmt***, ...);**

功能：

asprintf()可以说是一个增强版的sprintf(),在不确定字符串的长度时，非常灵活方便，能够根据格式化的字符串长度，申请足够的内存空间。此外，使用完后，必须通过free()释放空间。不过，这是GNU扩展的C函数库，不是标准C函数库或者POSIX。

头文件：asprintf.h

vtid的common.h中例子：

![复制代码][copycode.gif]

template<typename T>
    string String(const T& t, const string& fmt)
    {
        char* buf;
        if (asprintf(&buf, fmt.c_str(), t) < 0) {
            fprintf(stderr, "asprintf(%s) : %s\n", fmt.c_str(), strerror(errno));
            return "";
        }
        string str(buf);
        free(buf);
        return str;
    }

![复制代码][copycode.gif]

**vsprintf函数**

vsprintf()函数中的自变量是位于数组中的，数组元素的字符串之前都要加上百分号（%）。这个函数是“一步一步\[step-by-step\]”按顺序执行。在第一个%后，将插入第一个数组元素；在第二个%后，将插入第二个数组元素，依次类推。

vsprintf是sprintf的一个变形，它只有三个参数。vsprintf用于执行有多个参数的自订函式，类似printf格式。vsprintf的前两个参数与sprintf相同：一个用于保存结果的字元缓冲区和一个格式字串。第三个参数是指向格式化参数阵列的指标。实际上，该指标指向在堆叠中供函式呼叫的变数。va\_list、va\_start和va\_end巨集（在STDARG.H中定义）帮助我们处理堆叠指标。本章最后的SCRNSIZE程式展示了使用这些巨集的方法。使用vsprintf函式，sprintf函式可以这样编写：

int sprintf (char \* szBuffer, const char \* szFormat, ...)\{ int iReturn ; va\_list pArgs ; va\_start (pArgs, szFormat) ; iReturn = vsprintf (szBuffer, szFormat, pArgs) ; va\_end (pArgs) ; return iReturn ;\}

va\_start巨集将pArg设置为指向一个堆叠变数，该变数位址在堆叠参数szFormat的上面。

函数名: vsprintf

功 能: 送格式化输出到串中

用 法: int vsprintf(char \*string, char \*format, va\_list param);

vsprintf(buffer, fmt, argptr);

fmt="%d %f %s"

就是把后面的参数按照 "%d %f %s" 这个格式输出到 buffer 中。

[Link 1]: http://baike.baidu.com/view/56072.htm
[Link 2]: http://baike.baidu.com/view/266782.htm
[stdio.h]: http://baike.baidu.com/view/538727.htm
[char]: http://baike.baidu.com/view/1006519.htm
[strlen]: http://baike.baidu.com/subview/736226/5092486.htm
[copycode.gif]: /images/20220128/eb27bb8ef71644ffbb185afccb1d642b.png