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

sprintf函数:

功能

把格式化的数据写入某个字符串缓冲区。

头文件

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中例子：

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;
}

 

 

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 中。