Especificación de tamaño
En una especificación de formato, el cuarto campo es un modificador de longitud del argumento del especificador de conversión. Los prefijos del campo size para el campo type (h, l, w, I, I32, I64 y ll) especifican el “tamaño” del argumento correspondiente (largo o corto, de 32 o de 64 bits, carácter de un solo byte o carácter ancho) en función del especificador de conversión que modifican. Estos prefijos de tamaño se usan con los caracteres de type de los grupos de funciones printf y wprintf para especificar la interpretación de la longitud de los argumentos, como se muestra en la tabla siguiente. El campo size es opcional en algunos tipos de argumento. Cuando no se especifica ningún prefijo de tamaño, el formateador usa argumentos de entero, por ejemplo, con signo o sin signo char, short, int, long, y los tipos de enumeración, como tipos int de 32 bits. Los argumentos de punto flotante se usan como de tipos double de 64 bits. Esto coincide con las reglas de promoción de argumentos predeterminadas de las listas de argumentos variables. Para obtener más información acerca de la promoción de argumentos, consulte Elipse y argumentos predeterminados. En los sistemas de 32 y 64 bits, la especificación de formato de un argumento de entero de 64 bits debe incluir un prefijo de tamaño de ll o I64. De lo contrario, el comportamiento del formateador no queda definido.
Algunos tipos tienen tamaños diferentes en código de 32 bits y de 64 bits. Por ejemplo, size_t es de 32 bits en el código compilado para x86 y de 64 bits en el código compilado para x64. Para crear código de formato independiente de la plataforma para los tipos de ancho variable, puede usar un modificador de longitud de argumentos de ancho variable. Como alternativa, puede usar un modificador de longitud de argumentos de 64 bits y promover explícitamente el tipo de argumentos de ancho variable a 64 bits. El modificador de longitud de argumentos I específico de Microsoft usa argumentos de entero de ancho variable.
Nota
Los prefijos de modificador de longitud I, I32 y I64 son extensiones de Microsoft y no son compatibles con ANSI.El prefijo h, cuando se usa con datos de tipo char, el prefijo w, cuando se usa con datos de tipo wchar_t, y el prefijo l, cuando se usa con datos de tipo double, son extensiones de Microsoft.Los prefijos de longitud hh, j, z y t no se admiten.
Prefijos de tamaño de los especificadores de tipo de formato printf y wprintf
Para especificar |
Usar prefijo |
Con especificador de tipo |
|---|---|---|
long int |
l (L minúscula) |
d, i, o, x o X |
long unsigned int |
l |
o, u, x o X |
long long |
ll |
d, i, o, x o X |
short int |
h |
d, i, o, x o X |
short unsigned int |
h |
o, u, x o X |
__int32 |
I32 |
d, i, o, x o X |
unsigned __int32 |
I32 |
o, u, x o X |
__int64 |
I64 |
d, i, o, x o X |
unsigned __int64 |
I64 |
o, u, x o X |
ptrdiff_t (es decir, __int32 en plataformas de 32 bits, __int64 en plataformas de 64 bits) |
I |
d, i, o, x o X |
size_t (es decir, unsigned __int32 en plataformas de 32 bits, unsigned __int64 en plataformas de 64 bits) |
I |
o, u, x o X |
long double (en Visual C++, aunque long double es un tipo distinto, tiene la misma representación interna que double.) |
l o L |
a, A, e, E, f, g o G |
Carácter de un solo byte con las funciones printf y wprintf. (Un especificador de tipo hc o hC es sinónimo de c en las funciones printf y de C en las funciones wprintf). |
h |
c o C |
Carácter ancho con las funciones printf y wprintf. (Un especificador de tipo lc, lC, wc o wC es sinónimo de C en las funciones printf y de c en las funciones wprintf.) |
l o w |
c o C |
Cadena de caracteres de un solo byte con las funciones printf y wprintf. (Un especificador de tipo hs o hS es sinónimo de s en las funciones printf y de S en las funciones wprintf). |
h |
s, S o Z |
Cadena de caracteres anchos con las funciones printf y wprintf. (Un especificador de tipo ls, lS, ws o wS es sinónimo de S en las funciones printf y de s en las funciones wprintf.) |
l o w |
s, S o Z |
Vea también
Referencia
printf, _printf_l, wprintf, _wprintf_l
Sintaxis de especificación de formato: Funciones printf y wprintf