sprintf返回值

function

<cstdio>

sprintf

int sprintf ( char * str, const char * format, ... );

Write formatted data to string

Composes a string with the same text that would be printed if format was used on printf, but instead of being printed, the content is stored as a C string in the buffer pointed by str.

The size of the buffer should be large enough to contain the entire resulting string (see snprintf for a safer version).

A terminating null character is automatically appended after the content.

After the format parameter, the function expects at least as many additional arguments as needed for format.

 

Parameters

str

Pointer to a buffer where the resulting C-string is stored.
The buffer should be large enough to contain the resulting string.

format

C string that contains a format string that follows the same specifications as format in printf (see printf for details).

... (additional arguments)

Depending on the format string, the function may expect a sequence of additional arguments, each containing a value to be used to replace a format specifier in the format string (or a pointer to a storage location, for n).
There should be at least as many of these arguments as the number of values specified in the format specifiers. Additional arguments are ignored by the function.

 

Return Value

On success, the total number of characters written is returned. This count does not include the additional null-character automatically appended at the end of the string.

如果成果，返回写入的字符总数。字符总数不包括结尾自动添加的空字符。
On failure, a negative number is returned.

如果失败，返回负数。

 

Example

1 2 3 4 5 6 7 8 9 10 11

/* sprintf example */ #include <stdio.h> int main () { char buffer [50]; int n, a=5, b=3; n=sprintf (buffer, "%d plus %d is %d", a, b, a+b); printf ("[%s] is a string %d chars long\n",buffer,n); return 0; }

Edit & Run

Output:

[5 plus 3 is 8] is a string 13 chars long

 

See also

snprintf

Write formatted output to sized buffer (function )

printf

Print formatted data to stdout (function )

sscanf

Read formatted data from string (function )