NOMBRE¶

SINOPSIS¶

DESCRIPCIÓN¶

Valor devuelto¶

Formato de la cadena de formato¶

	printf("%*d", width, num);

	printf("%2$*1$d", width, num);

	printf("%'.2f", 1234567.89);

Los caracteres de opción¶

#

El valor debe ser convertido a un ``formato alternativo''. Para las conversiones o, el primer carácter de la cadena de salida se hace 0 (prefijando un cero si ya era distinto de cero). Para las conversiones x y X, la cadena `0x' (o `0X' para conversiones X ) precede a los resultados que son distintos de 0. Para las conversiones a, A, e, E, f, F, g, y G, el resultado contendrá un punto decimal, aún si ningún dígito lo sigue (normalmente, sólo aparece un punto decimal en el resultado de aquellas conversiones que son seguidas de algún dígito). Para las conversiones g y G, en el resultado no se eliminan los ceros del final, como ocurriría en otro caso. Para otras conversiones, el resultado es indefinido.

0

El valor se debe rellenar con ceros. Para las conversiones d, i, o, u, x, X, a, A, e, E, f, F, g, y G , el valor convertido es rellenado a la izquierda con ceros en vez de blancos. Si las banderas 0 y - aparecen a la vez, la bandera 0 es ignorada. Si en una conversión numérica (d, i, o, u, x, y X), se indica una precisión, la bandera 0 se ignora. Para otras conversiones, el resultado es indefinido.

-

El valor convertido es justificado a la izquierda sobre el límite del campo. (Por defecto, la justificación es a la derecha). Excepto para conversiones n, el valor convertido es rellenado a la derecha con blancos, en vez de a la izquierda con blancos o ceros. Un - sobreescribe un 0 si se indican ambos.

(un espacio) Se debe dejar un espacio en blanco delante de un número positivo (o cadena vacía) producido por una conversión con signo.

+

Siempre se colocará el signo (+ o -) delante de un número producido por una conversión con signo. Por omisión, sólo se usa el signo para los números negativos. Un + sobreescribe un espacio si se usan ambos.

'

Para una conversión decimal (i, d, u, f, F, g, G) la salida se va a agrupar con caracteres de separación de miles si la información de localización así lo indica. Dese cuenta que muchas versiones de gcc no pueden analizar esta opción y producirán una advertencia. SUSv2 no incluye %'F.

I

Para una conversión decimal entera (i, d, u) la salida utiliza los dígitos de salida alternativos de la localización, si hay (por ejemplo, dígitos árabes). Sin embargo, no incluye ninguna definición de localización con tales dígitos de salida outdigits definidos.

La anchura de campo¶

La precisión¶

El indicador de longitud¶

hh

La siguiente conversión entera se corresponde con un argumento signed char o unsigned char, o la siguiente conversión n se corresponde a un puntero a un argumento signed char .

h

La siguiente conversión entera se corresponde con un argumento short int o unsigned short int, o que la siguiente conversión n corresponde a un puntero a un argumento short int.

l

(ele) La siguiente conversión entera corresponde a un argumento long int o unsigned long int, o que la siguiente conversión n corresponde a un puntero a un argumento long int o que la siguiente conversión c corresponde a un argumento wint_t, o que la siguiente conversión s corresponde a un puntero a un argumento wchar_t.

ll

(ele-ele). La siguiente conversión entera corresponde a un argumento long long int o unsigned long long int , o que la siguiente conversión n corresponde a un puntero a un argumento long long int.

L

La siguiente conversión a, A, e, E, f, F, g, o G corresponde a un argumento long double. (C99 permite %LF, pero SUSv2 no.)

q

(`cuadruple'. BSD 4.4 y Linux libc5 sólo. No usar.) Esto es un sinónimo de ll.

j

La siguiente conversión entera corresponde a un intmax_t o uintmax_t.

z

La siguiente conversión entera corresponde a un argumento size_t o ssize_t. (Linux libc5 tiene Z con este significado. No lo use.)

t

La siguiente conversión entera corresponde a un argumento ptrdiff_t.

El indicador de conversión¶

d,i

El argumento int se convierte a la notación decimal con signo. La precisión, si la hay, da el número mínimo de dígitos que deben aparecer. Si el valor convertido necesita menos dígitos, se rellena a la izquierda con ceros. La precisión por omisión es 1. Cuando se imprime 0 con una precisión explícita 0, la salida es la cadena vacía.

o,u,x,X

El argumento unsigned int se convierte a un octal sin signo (o, a decimal sin signo (u, a a notación hexadecimal sin signo (x y X). Las letras abcdef son usadas para conversiones x. Las letras ABCDEF son usadas para conversiones X. La precisión, si se ha indicado alguna, da el mínimo número de dígitos que deben aparecer. Si el valor convertido requiere menos dígitos, éste es rellenado a la izquierda con ceros. La precisión por omisión es 1. Cuando se imprime 0 con una precisión explícita 0, la salida es la cadena vacía.

e,E

El argumento double es redondeado y convertido al formato [-]d.ddde*(Pmdd donde hay un dígito delante del carácter del punto decimal y el número de dígitos después de éste es igual a la precisión. Si no se indica precisión, ésta es tomada como 6. Si la precisión es cero, no aparece el carácter de punto decimal. Una conversión E usa la letra E ( en vez de e) para introducir el exponente. El exponente siempre contiene al menos dos dígitos. Si el valor es cero, el exponente es 00.

f,F

El argumento double es redondeado y convertido a una notación decimal del estilo [-]ddd.ddd, donde el número de dígitos después del carácter del punto decimal es igual a la especificación de la precisión. Si no se indica precisión, ésta es tomada como 6. Si la precisión es explícitamente cero, no aparece el carácter del punto decimal. Si aparece un punto decimal, al menos aparece un dígito delante de él.

 

(SUSv2 no conoce F y dice que deben estar disponibles reprentaciones como cadenas de caracteres para infinito y NaN (Not a Number, no es un número). El estándar C00 especifica `[-]inf' o `[-]infinity' para el infinito y una cadena que comienza por `Nan' para NaN, en el caso de una conversión f, y `[-]INF' o `[-]INFINITY' o `NAN*' en el caso de una conversión F.)

g,G

El argumento double es convertido al estilo de f o e (o F o E para conversiones G ). La precisión especifica el número de dígitos significativos. Si no se indica precisión, se dan 6 dígitos. Si la precisión es cero, ésta es tratada como 1. Se utiliza el formato de e si el exponente de su conversión es menor que -4 o más grande o igual a la precisión. Los ceros finales se eliminan de la parte fraccional del resultado. Un punto decimal sólo aparece si es seguido de al menos un dígito.

a,A

(C99. No en SUSv2) Para una conversión a, el argumento double se convierte a notación hexadecimal (usando las letras abcdef) según el estilo [-]0xh.hhhhp*(Pmd. Para una conversión A se usan el prefijo 0X, las letras ABCDEF y el separador de exponente P. Hay un dígito hexadecimal antes del punto decimal y el número de dígitos tras él es igual a la precisión. La precisión por omisión es suficiente para una representación exacta del valor si existe una representación exacta en base 2 y, en otro caso, es suficientemente grande para distinguir valores de tipo double. El dígito antes del punto decimal queda sin especificar para números no normalizados y distinto de cero pero, en cualquier caso, sin especificar para números normalizados.

c

Si no está presente un modificador l, el argumento int es convertido a un unsigned char, y se escribe el carácter resultante. Si está presente un modificador l, el argumento wint_t (carácter ancho) se convierte a una secuencia multibyte llamando a la función wcrtomb, con un estado de conversión que comienza en el estado inicial, y se escribe la cadena multibyte resultante.

s

Si no está presente un modificador l: se espera que el argumento const char * sea un puntero a un vector (array) de tipo carácter (puntero a una cadena de caracteres). Se escriben caracteres del array hasta (pero no incluyendo) un carácter terminador NUL. Si se especifica una precisión, no se escriben más caracteres del número especificado. Si se da una precisión, no es necesario que aparezca ningún carácter nulo. Si no se especifica precisión, o es mayor que el tamaño de la cadena, la cadena debe contener un carácter de terminación NUL. Si está presente un modificador l: se espera que el argumento const wchar_t * sea un puntero a un vector de caracteres anchos. Los caracteres anchos del array se convierten a caracteres multibyte (cada uno llamando a la función wcrtomb, con un estado de conversión que comienza en el estado inicial antes del primer carácter ancho) incluyendo el carácter ancho nulo terminador. Los caracteres multibyte resultantes se escriben hasta llegar (pero sin incluir) el byte nulo terminador. Si se especifica una precisión, no se escriben más bytes de los indica el número, aunque no se escribe ningún carácter multibyte parcial. Advierta que la precisión determina el número de bytes escritos, no el número de caracteres anchos o posiciones de pantalla. El vector debe contener un carácter ancho nulo terminador, a menos que se de una precisión que sea tan pequeña que el número de bytes escritos la exceda antes de llegar al final del vector.

C

(No en C99, pero sí en SUSv2.) Sinónimo de lc. No usar.

S

(No en C99, pero sí en SUSv2.) Sinónimo de ls. No usar.

p

El argumento de tipo puntero void * se imprime en hexadecimal (como si se hubiera indicado %#x o %#lx).

n

El número de caracteres escritos hasta ahora se guarda en el entero indicado por el argumento de tipo puntero int * (o una variante suya). No se convierte ningún argumento.

%

Se escribe un `%'. No se convierte ningún argumento. La especificación completa de conversión es `%%'.

EJEMPLOS¶

#include <math.h>
#include <stdio.h>
fprintf(stdout, "pi = %.5f\n", 4 * atan(1.0));

#include <stdio.h>
fprintf(stdout, "%s, %s %d, %.2d:%.2d\n",
	weekday, month, day, hour, min);

#include <stdio.h>
fprintf(stdout, formato,
	diasemana, mes, día, hora, min);

"%1$s, %3$d. %2$s, %4$d:%5$.2d\n"

#include <stdio.h>
#include <stdlib.h>
#include <stdarg.h>
char *
construye_mensaje(const char *fmt, ...) {
	/* Suponemos que no necesitamos más de 100 bytes. */
	int n, size = 100;
	char *p;
	va_list ap;
	if ((p = malloc (size)) == NULL)
		return NULL;
	while (1) {
		/* Intenta imprimir en el espacio reservado. */
		va_start(ap, fmt);
		n = vsnprintf (p, size, fmt, ap);
		va_end(ap);
		/* Si ha funcionado, devuelve la cadena. */
		if (n > -1 && n < size)
			return p;
		/* Si no, inténtalo de nuevo con más espacio. */
		if (n > -1)    /* glibc 2.1 */
			size = n+1; /* exactamente lo que se necesita */
		else           /* glibc 2.0 */
			size *= 2;  /* el doble del tamaño anterior*/
		if ((p = realloc (p, size)) == NULL)
			return NULL;
	}
}

OBSERVACIONES¶

CONFORME A¶

HISTORIA¶

FALLOS¶

VÉASE TAMBIÉN¶