Función de la biblioteca C -sprintf()

C 标准库 - <stdio.h>Biblioteca estándar de C - <stdio.h>

Descripción

Función de la biblioteca Cint sprintf(char *str, const char *format, ...)Envía la salida formateada astrla cadena a la que se apunta.

Declaración

A continuación se muestra la declaración de la función sprintf().

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

Parámetros

  • str-- Este es un puntero a un arreglo de caracteres que almacena la cadena C.
  • format-- Esta es la cadena que contiene el texto que se escribirá en la cadena str. Puede contener etiquetas de formato incrustadas, las cuales pueden ser reemplazadas por los valores especificados en los parámetros adicionales posteriores y formateadas según sea necesario. Los atributos de la etiqueta de formato son %[flags][width][.precision][length]specifier, tal como se detalla a continuación:
especificadorSalida
cCarácter
d o iEntero decimal con signo
eNotación científica con el carácter e (mantisa y exponente)
ENotación científica con el carácter E (mantisa y exponente)
fNúmero de punto flotante decimal
gElige automáticamente la representación apropiada entre %e o %f
GElige automáticamente la representación apropiada entre %E o %f
oOctal con signo
sCadena de caracteres
uEntero decimal sin signo
xEntero hexadecimal sin signo
XEntero hexadecimal sin signo (letras mayúsculas)
pDirección de puntero
nSin salida
%Carácter

flags (indicadores)Descripción
-Alinear a la izquierda dentro del ancho de campo dado; por defecto se alinea a la derecha (ver subespecificador width).
+Fuerza a mostrar un signo más o menos (+ o -) antes del resultado; es decir, un signo + aparecerá antes de los números positivos. Por defecto, solo los números negativos muestran un signo - delante.
(space)Si no se escribe ningún signo, se inserta un espacio antes del valor.
#Cuando se usa con los especificadores o, x o X, se muestra 0, 0x o 0X respectivamente delante de valores distintos de cero.
Cuando se usa con e, E y f, fuerza la salida a incluir un punto decimal, incluso si no hay dígitos después. Por defecto, si no hay dígitos después, no se muestra el punto decimal.
Cuando se usa con g o G, el resultado es el mismo que con e o E, pero los ceros finales no se eliminan.
0Coloca ceros (0) a la izquierda de los números al especificar el relleno (padding), en lugar de espacios (ver subespecificador width).

width (ancho)Descripción
(number)El número mínimo de caracteres a imprimir. Si el valor de salida es más corto que este número, el resultado se rellena con espacios. Si el valor es más largo que este número, el resultado no se trunca.
*El ancho no se especifica en la cadena de formato, sino que se coloca como un parámetro de valor entero adicional antes del parámetro que se va a formatear.

.precision (precisión)Descripción
.numberPara los especificadores de entero (d, i, o, u, x, X): precision especifica el número mínimo de dígitos que se deben escribir. Si el valor escrito es más corto que ese número, el resultado se rellena con ceros a la izquierda. Si el valor es más largo, el resultado no se trunca. Una precisión de 0 significa que no se escribe ningún carácter.
Para los especificadores e, E y f: el número de dígitos decimales a imprimir después del punto decimal.
Para los especificadores g y G: el número máximo de dígitos significativos a imprimir.
Para s: el número máximo de caracteres a imprimir. Por defecto, se imprimen todos los caracteres hasta encontrar el carácter nulo final.
Para el tipo c: no tiene ningún efecto.
Cuando no se especifica precisión, el valor predeterminado es 1. Si se especifica sin un valor explícito, se asume 0.
.*La precisión no se especifica en la cadena de formato, sino que se coloca como un parámetro de valor entero adicional antes del parámetro a formatear.

length (longitud)Descripción
hEl argumento se interpreta como un entero corto o un entero corto sin signo (solo para especificadores de enteros: i, d, o, u, x y X).
lEl argumento se interpreta como un entero largo o un entero largo sin signo, aplicable a los especificadores de enteros (i, d, o, u, x y X) y a los especificadores c (que indica un carácter ancho) y s (que indica una cadena de caracteres anchos).
LEl argumento se interpreta como un doble largo (long double) (solo para especificadores de coma flotante: e, E, f, g y G).
  • Parámetros adicionales-- Dependiendo de la cadena de formato, la función puede requerir una serie de parámetros adicionales, cada uno contiene un valor que se insertará reemplazando cada etiqueta % especificada en el parámetro format. El número de parámetros debe ser el mismo que el número de etiquetas %.

Valor de retorno

Si tiene éxito, devuelve el número total de caracteres escritos, sin incluir el carácter nulo que se añade al final de la cadena. Si falla, devuelve un número negativo.

Ejemplo

El siguiente ejemplo muestra el uso de la función sprintf().

Ejemplo

#include <stdio.h>
#include <math.h>

int main()
{
   char str[80];

   sprintf(str, El valor de Pi = %f, M_PI);
   puts(str);
   
   return(0);
}

Compilemos y ejecutemos el programa anterior, esto producirá el siguiente resultado:

Pi 的值 = 3.141593

C 标准库 - <stdio.h>Biblioteca estándar de C - <stdio.h>

Otras extensiones