Função da biblioteca C vsprintf() e exemplo

Biblioteca Padrão C - <stdio.h>

função da biblioteca C int vsprintf(char *str, const char *format, va_list arg) Envia saída formatada para uma string usando uma lista de parâmetros.

declaração

Aqui está a declaração da função vsprintf().

int vsprintf(char *str, const char *format, va_list arg)

parâmetro

• str -- Esta é uma referência para um array de caracteres que armazena uma string C.
• format -- Esta é uma string que contém o texto a ser escrito na string str. Pode conter etiquetas format, que podem ser substituídas pelos valores especificados nos parâmetros subsequentes e formatadas conforme necessário. As propriedades das etiquetas format são %[flags][width][.precision][length]specifier，explicado detalhadamente a seguir:

specifier (indicador)	impressão
c	caractere
d ou i	inteiro decimal com sinal
e	usando o caractere e para notação científica (subscrito e expoente)
E	usando o caractere E para notação científica (subscrito e expoente)
f	número decimal de ponto flutuante
g	escolhe automaticamente a representação apropriada entre %e ou %f
G	escolhe automaticamente a representação apropriada entre %E ou %f
o	octal com sinal
s	string de caractere
u	inteiro decimal sem sinal
x	inteiro hexadecimal sem sinal
X	inteiro hexadecimal sem sinal (letras maiúsculas)
p	endereço de ponteiro
n	sem saída
%	caractere

flags (identificadores)	描述
-	Alinhamento à esquerda dentro do campo especificado, padrão é à direita (ver subindicador width).
+	Força a exibição de um sinal (+ ou -) no início do resultado (ver entre parênteses).+ ou -），isto é, números positivos terão + número. Padrãomente, apenas números negativos têm um - número.
(espaço)	Se nenhum símbolo for escrito, uma espaço em branco é inserida antes do valor.
#	Quando usado com o, x ou X, o valor não zero é precedido por 0, 0x ou 0X, respectivamente. Quando usado com e, E e f, força a impressão de um ponto decimal, mesmo que não haja números após ele. Padrãomente, se não houver números após ele, o ponto decimal não é impresso. Quando usado com g ou G, o resultado é o mesmo que ao usar e ou E, mas os zeros ao final não são removidos.
0	Coloca zeros (0) à esquerda do número especificado para preenchimento (ver subindicador width).

largura (largura)	描述
(número)	O número mínimo de caracteres a serem impressos. Se o valor impresso for menor que este número, o resultado será preenchido com espaços em branco. Se o valor impresso for maior que este número, o resultado não será truncado.
*	width（宽度）在 format 字符串中未指定，但是会作为附加整数值参数放置于要被格式化的参数之前。

.precision（精度）	描述
.number	对于整数说明符（d、i、o、u、x、X）：precision 指定了要写入的数字的最小位数。如果写入的值短于该数，结果会用前导零来填充。如果写入的值长于该数，结果不会被截断。精度为 0 意味着不写入任何字符。 对于 e、E 和 f 说明符：要在小数点后输出的小数位数。 对于 g 和 G 说明符：要输出的最大有效位数。 对于 s: 要输出的最大字符数。默认情况下，所有字符都会被输出，直到遇到末尾的空字符。 对于 c 类型：没有任何影响。 当未指定任何精度时，默认为 1。如果指定时不带有一个显式值，则假定为 0。
.*	精度在 format 字符串中未指定，但是会作为附加整数值参数放置于要被格式化的参数之前。

length（长度）	描述
h	参数被解释为短整型或无符号短整型（仅适用于整数说明符：i、d、o、u、x 和 X）。
l	参数被解释为长整型或无符号长整型，适用于整数说明符（i、d、o、u、x 和 X）及说明符 c（表示一个宽字符）和 s（表示宽字符字符串）。
L	参数被解释为长双精度型（仅适用于浮点数说明符：e、E、f、g 和 G）。

• arg -- 一个表示可变参数列表的对象。这应被 <stdarg> 中定义的 va_start 宏初始化。

返回值

如果成功，则返回写入的字符总数，否则返回一个负数。

在线示例

下面的示例演示了 vsprintf() 函数的用法。

#include <stdio.h>
#include <stdarg.h>
char buffer[80];
int vspfunc(char *format, ...)
{
   va_list aptr;
   int ret;
   va_start(aptr, format);
   ret = vsprintf(buffer, format, aptr);
   va_end(aptr);
   return(ret);
}
int main()
{
   int i = 5;
   float f = 27.0;
   char str[50] = "oldtoolbag.com";
   vspfunc("%d %f %s", i, f, str);
   printf("%s\n", buffer);
   return(0);
}

Vamos compilar e executar o programa acima, o que produzirá o seguinte resultado:

5 27.000000 oldtoolbag.com

Biblioteca Padrão C - <stdio.h>