Syntaxe de spécification de format : fonctions printf et wprintfFormat specification syntax: printf and wprintf functions

Les différentes fonctions printf et wprintf acceptent une chaîne de format et des arguments facultatifs, et génèrent en sortie une séquence de caractères mise en forme.The various printf and wprintf functions take a format string and optional arguments and produce a formatted sequence of characters for output. La chaîne de format contient zéro ou plusieurs directives qui sont soit des caractères littéraux pour la sortie, soit des spécifications de conversion codées qui décrivent comment mettre en forme un argument dans la sortie.The format string contains zero or more directives, which are either literal characters for output or encoded conversion specifications that describe how to format an argument in the output. Cet article décrit la syntaxe utilisée pour encoder les spécifications de conversion dans la chaîne de format.This article describes the syntax used to encode conversion specifications in the format string. Pour obtenir la liste de ces fonctions, consultez E/S de flux.For a listing of these functions, see Stream I/O.

Une spécification de conversion se compose de champs facultatifs et obligatoires mis en forme comme suit :A conversion specification consists of optional and required fields in this form:

% [flags][width][.precision][size]type%[flags][width][.precision][size]type

Chaque champ de la spécification de conversion est un caractère ou un nombre qui représente un spécificateur d’option ou de conversion de format particulier.Each field of the conversion specification is a character or a number that signifies a particular format option or conversion specifier. Le champ obligatoire type spécifie le genre de conversion à appliquer à un argument.The required type field specifies the kind of conversion to be applied to an argument. Les champs facultatifs flags, width et precision contrôlent d’autres aspects du format, notamment les espaces ou les zéros de début, la justification et la précision affichée.The optional flags, width, and precision fields control additional format aspects such as leading spaces or zeroes, justification, and displayed precision. Le champ size spécifie la taille de l’argument consommé et converti.The size field specifies the size of the argument consumed and converted.

Une spécification de conversion de base contient uniquement le symbole de pourcentage et un caractère type.A basic conversion specification contains only the percent sign and a type character. Par exemple, %s spécifie une conversion de chaîne.For example, %s specifies a string conversion. Pour imprimer un caractère de pourcentage, utilisez %%.To print a percent-sign character, use %%. Si un signe de pourcentage est suivi d’un caractère qui n’a aucune signification en tant que champ de format, le gestionnaire de paramètres non valides est appelé.If a percent sign is followed by a character that has no meaning as a format field, the invalid parameter handler is invoked. Pour plus d’informations, consultez Validation de paramètre.For more information, see Parameter Validation.

Important

Pour garantir la sécurité et la stabilité, vérifiez que ces chaînes de spécification de conversion ne sont pas définies par l’utilisateur.For security and stability, ensure that conversion specification strings are not user-defined. Par exemple, imaginez un programme qui invite l'utilisateur à entrer un nom et enregistre l'entrée dans une variable de chaîne nommée user_name.For example, consider a program that prompts the user to enter a name and stores the input in a string variable that's named user_name. Pour imprimer user_name, n'effectuez pas l'opération suivante :To print user_name, do not do this:

printf( user_name ); /* Danger! If user_name contains "%s", program will crash */

Procédez plutôt comme suit :Instead, do this:

printf( "%s", user_name );

Spécificateur de conversion de typeType conversion specifier

Le caractère spécificateur de conversion type précise si l’argument correspondant doit être interprété comme un caractère, une chaîne, un pointeur, un entier ou un nombre à virgule flottante.The type conversion specifier character specifies whether to interpret the corresponding argument as a character, a string, a pointer, an integer, or a floating-point number. Le caractère type, qui est le seul champ de spécification de conversion obligatoire, apparaît après tous les champs facultatifs.The type character is the only required conversion specification field, and it appears after any optional fields.

Les arguments qui suivent la chaîne de format sont interprétés en fonction du caractère type correspondant et du préfixe size facultatif.The arguments that follow the format string are interpreted according to the corresponding type character and the optional size prefix. Les conversions pour les types de caractères char et wchar_t sont spécifiées à l’aide de c ou C, tandis que les chaînes de caractères codés sur un octet et multioctets ou à caractères larges sont spécifiées à l’aide de s ou S, selon la fonction de mise en forme utilisée.Conversions for character types char and wchar_t are specified by using c or C, and single-byte and multi-byte or wide character strings are specified by using s or S, depending on which formatting function is being used. Les arguments de caractère et de chaîne spécifiés à l’aide de c et s sont interprétés comme char et char* par les fonctions de la famille printf ou comme wchar_t et wchar_t* par les fonctions de la famille wprintf.Character and string arguments that are specified by using c and s are interpreted as char and char* by printf family functions, or as wchar_t and wchar_t* by wprintf family functions. Les arguments de caractère et de chaîne spécifiés à l’aide de C et S sont interprétés comme wchar_t et wchar_t* par les fonctions de la famille printf ou commechar et char* par les fonctions de la famille wprintf.Character and string arguments that are specified by using C and S are interpreted as wchar_t and wchar_t* by printf family functions, or as char and char* by wprintf family functions. Ce comportement est spécifique à Microsoft.This behavior is Microsoft specific.

Les types entier tels que short, int, long, long long, ainsi que leurs variantes unsigned, sont spécifiés à l’aide de d, i, o, u, x et X. Les types virgule flottante, tels que float, double et long double, sont spécifiés à l’aide de a, A, e, E, f, F, g et G. Par défaut, à moins d’être modifiés par un préfixe size, les arguments entiers sont forcés en type int et les arguments à virgule flottante sont forcés en double.Integer types such as short, int, long, long long, and their unsigned variants, are specified by using d, i, o, u, x, and X. Floating-point types such as float, double, and long double, are specified by using a, A, e, E, f, F, g, and G. By default, unless they are modified by a size prefix, integer arguments are coerced to int type, and floating-point arguments are coerced to double. Sur les systèmes 64 bits, un int est une valeur 32 bits ; les entiers 64 bits sont donc tronqués quand ils sont mis en forme pour la sortie, à moins qu’un préfixe size égal à ll ou I64 soit utilisé.On 64-bit systems, an int is a 32-bit value; therefore, 64-bit integers will be truncated when they are formatted for output unless a size prefix of ll or I64 is used. Les types de pointeur spécifiés par p utilisent la taille du pointeur par défaut pour la plateforme.Pointer types that are specified by p use the default pointer size for the platform.

Notes

Section spécifique à Microsoft Les caractères de type Z et le comportement des caractères de type c, C, s et S (quand ils sont utilisés avec les fonctions printf et wprintf) sont des extensions Microsoft.Microsoft Specific The Z type character, and the behavior of the c, C, s, and S type characters when they are used with the printf and wprintf functions, are Microsoft extensions. La norme ISO C utilise systématiquement c et s pour les chaînes et les caractères étroits, et C et S pour les chaînes et les caractères larges, dans toutes les fonctions de mise en forme.The ISO C standard uses c and s consistently for narrow characters and strings, and C and S for wide characters and strings, in all formatting functions.

Caractères du champ typeType field characters

Caractère de typeType character ArgumentArgument Format de sortieOutput format
cc CaractèreCharacter Quand il est utilisé avec les fonctions printf, spécifie un caractère codé sur un octet ; quand il est utilisé avec les fonctions wprintf, spécifie un caractère large.When used with printf functions, specifies a single-byte character; when used with wprintf functions, specifies a wide character.
CC CaractèreCharacter Quand il est utilisé avec les fonctions printf, spécifie un caractère large ; quand il est utilisé avec les fonctions wprintf, spécifie un caractère codé sur un octet.When used with printf functions, specifies a wide character; when used with wprintf functions, specifies a single-byte character.
dd EntierInteger Entier décimal signé.Signed decimal integer.
ii EntierInteger Entier décimal signé.Signed decimal integer.
oo EntierInteger Entier octal non signé.Unsigned octal integer.
uu EntierInteger Entier décimal non signé.Unsigned decimal integer.
xx EntierInteger Entier hexadécimal non signé ; utilise « abcdef ».Unsigned hexadecimal integer; uses "abcdef."
XX EntierInteger Entier hexadécimal non signé ; utilise « ABCDEF ».Unsigned hexadecimal integer; uses "ABCDEF."
ee Virgule flottanteFloating-point Valeur signée se présentant sous la forme [-]d.dddddd[d], où d correspond à un chiffre décimal, dddd à un ou plusieurs chiffres décimaux selon la précision spécifiée (ou six par défaut), et dd[ ] à deux ou trois chiffres décimaux, selon le format de sortie et la taille de l’exposant.Signed value that has the form [-]d.dddddd[d], where d is one decimal digit, dddd is one or more decimal digits depending on the specified precision, or six by default, and dd[d] is two or three decimal digits depending on the output format and size of the exponent.
EE Virgule flottanteFloating-point Identique au format e sauf que l’exposant est introduit par E et non par e.Identical to the e format except that E rather than e introduces the exponent.
ff Virgule flottanteFloating-point Valeur signée se présentant sous la forme [-]dddd . dddd, où dddd correspond à un ou plusieurs chiffres décimaux.Signed value that has the form [-]dddd.dddd, where dddd is one or more decimal digits. Le nombre de chiffres avant la virgule décimale dépend de l’ampleur du nombre, et le nombre de chiffres après la virgule décimale dépend de la précision demandée (ou six par défaut).The number of digits before the decimal point depends on the magnitude of the number, and the number of digits after the decimal point depends on the requested precision, or six by default.
FF Virgule flottanteFloating-point Identique au format f, sauf que la sortie de l’infini et NAN est en majuscules.Identical to the f format except that infinity and nan output is capitalized.
gg Virgule flottanteFloating-point Les valeurs signées sont affichées au format f ou e, selon celui qui est le plus compact pour la valeur et la précision en question.Signed values are displayed in f or e format, whichever is more compact for the given value and precision. Le format e est utilisé uniquement quand l’exposant de la valeur est inférieur à -4 ou supérieur ou égal à l’argument precision.The e format is used only when the exponent of the value is less than -4 or greater than or equal to the precision argument. Les zéros de droite sont tronqués et la virgule décimale apparaît uniquement si elle est suivie d'un ou plusieurs chiffres.Trailing zeros are truncated, and the decimal point appears only if one or more digits follow it.
GG Virgule flottanteFloating-point Identique au format g, sauf que l’exposant est introduit par E et non par e (selon le cas).Identical to the g format, except that E, rather than e, introduces the exponent (where appropriate).
aa Virgule flottanteFloating-point Valeur à virgule flottante double précision hexadécimale signée se présentant sous la forme [-]0xh.hhhhdd, où h.hhhh correspond aux chiffres hexadécimaux (utilisant des lettres minuscules) de la mantisse, et dd à un ou plusieurs chiffres de l’exposant.Signed hexadecimal double-precision floating-point value that has the form [-]0xh.hhhhdd, where h.hhhh are the hex digits (using lower case letters) of the mantissa, and dd are one or more digits for the exponent. La précision indique le nombre de chiffres après la virgule.The precision specifies the number of digits after the point.
AA Virgule flottanteFloating-point Valeur à virgule flottante double précision hexadécimale signée se présentant sous la forme [-]0Xh.hhhhdd, où h.hhhh correspond aux chiffres hexadécimaux (utilisant des lettres majuscules) de la mantisse, et dd à un ou plusieurs chiffres pour l’exposant.Signed hexadecimal double-precision floating-point value that has the form [-]0Xh.hhhhdd, where h.hhhh are the hex digits (using capital letters) of the mantissa, and dd are one or more digits for the exponent. La précision indique le nombre de chiffres après la virgule.The precision specifies the number of digits after the point.
nn Pointeur désignant un entierPointer to integer Nombre de caractères correctement écrits jusqu'à présent dans le flux ou la mémoire tampon.Number of characters that are successfully written so far to the stream or buffer. Cette valeur est stockée dans l’entier dont l’adresse est fournie sous forme d’argument.This value is stored in the integer whose address is given as the argument. La taille de l’entier désigné par le pointeur peut être contrôlée par un préfixe de spécification de la taille de l’argument.The size of the integer pointed at can be controlled by an argument size specification prefix. Le spécificateur n est désactivé par défaut ; pour plus d’informations, consultez la remarque importante sur la sécurité.The n specifier is disabled by default; for information see the important security note.
pp Type de pointeurPointer type Affiche l’argument sous forme d’adresse composée de chiffres hexadécimaux.Displays the argument as an address in hexadecimal digits.
ss ChaîneString Quand il est utilisé avec les fonctions printf, spécifie une chaîne de caractères codés sur un octet ou multioctets ; quand il est utilisé avec les fonctions wprintf, spécifie une chaîne de caractères larges.When used with printf functions, specifies a single-byte or multi-byte character string; when used with wprintf functions, specifies a wide-character string. Les caractères s’affichent jusqu’au premier caractère Null ou jusqu’à ce que la valeur de precision soit atteinte.Characters are displayed up to the first null character or until the precision value is reached.
SS ChaîneString Quand il est utilisé avec les fonctions printf, spécifie une chaîne de caractères larges ; quand il est utilisé avec les fonctions wprintf, spécifie une chaîne de caractères codés sur un octet ou multioctets.When used with printf functions, specifies a wide-character string; when used with wprintf functions, specifies a single-byte or multi-byte character string. Les caractères s’affichent jusqu’au premier caractère Null ou jusqu’à ce que la valeur de precision soit atteinte.Characters are displayed up to the first null character or until the precision value is reached.
ZZ Structure ANSI_STRING ou UNICODE_STRINGANSI_STRING or UNICODE_STRING structure Quand l’adresse d’une structure ANSI_STRING ou UNICODE_STRING est passée comme argument, affiche la chaîne contenue dans la mémoire tampon désignée par le champ Buffer de la structure.When the address of an ANSI_STRING or UNICODE_STRING structure is passed as the argument, displays the string contained in the buffer pointed to by the Buffer field of the structure. Utilisez un préfixe de modificateur de size égal à w pour spécifier un argument UNICODE_STRING, par exemple %wZ.Use a size modifier prefix of w to specify a UNICODE_STRING argument—for example, %wZ. Le champ Length de la structure doit indiquer la longueur, en octets, de la chaîne.The Length field of the structure must be set to the length, in bytes, of the string. Le champ MaximumLength de la structure doit indiquer la longueur, en octets, de la mémoire tampon.The MaximumLength field of the structure must be set to the length, in bytes, of the buffer.

En règle générale, le caractère de type Z est utilisé uniquement dans les fonctions de débogage de pilote qui utilisent une spécification de conversion, comme dbgPrint et kdPrint.Typically, the Z type character is used only in driver debugging functions that use a conversion specification, such as dbgPrint and kdPrint.

À compter de Visual Studio 2015, si l’argument qui correspond à un spécificateur de conversion de valeurs à virgule flottante (a, A, e, E, f, F, g, G) est infini, indéfini ou NaN, la sortie mise en forme est conforme à la norme C99.Starting in Visual Studio 2015, if the argument that corresponds to a floating-point conversion specifier (a, A, e, E, f, F, g, G) is infinite, indefinite, or NaN, the formatted output conforms to the C99 standard. Ce tableau répertorie les sorties mises en forme :This table lists the formatted output:

ValueValue SortieOutput
infinityinfinity inf
NaN silencieuxQuiet NaN nan
NaN signalantSignaling NaN nan(snan)
Indefinite NaNIndefinite NaN nan(ind)

Ces valeurs peuvent toutes être précédées d’un signe.Any of these values may be prefixed by a sign. Si un caractère spécificateur de conversion de type virgule flottante est une lettre majuscule, la sortie est également en majuscules.If a floating-point type conversion specifier character is a capital letter, then the output is also formatted in capital letters. Par exemple, si le spécificateur de format est %F et non %f, un nombre infini apparaît sous la forme INF et non sous la forme inf.For example, if the format specifier is %F instead of %f, an infinity is formatted as INF instead of inf. Les fonctions scanf peuvent également analyser ces chaînes. Ces valeurs peuvent donc faire l’aller-retour par l’intermédiaire des fonctions printf et scanf.The scanf functions can also parse these strings, so these values can make a round trip through printf and scanf functions.

Avant Visual Studio 2015, le CRT utilisait un autre format non standard pour la sortie des valeurs infinies, indéfinies et NaN :Before Visual Studio 2015, the CRT used a different, non-standard format for output of infinite, indefinite, and NaN values:

ValueValue SortieOutput
+ infini+ infinity 1.#INF chiffres aléatoires1.#INF random-digits
- infini- infinity -1.#INF chiffres aléatoires-1.#INF random-digits
Indéfini (identique à une valeur NaN silencieuse)Indefinite (same as quiet NaN) chiffre .#IND chiffres aléatoiresdigit .#IND random-digits
NaNNaN chiffre .#NAN chiffres aléatoiresdigit .#NAN random-digits

Toutes ces chaînes pouvaient être préfixées par un signe et mises en forme légèrement différemment en fonction de la précision et de la largeur du champ, parfois avec des effets inhabituels.Any of these may have been prefixed by a sign, and may have been formatted slightly differently depending on field width and precision, sometimes with unusual effects. Par exemple, printf("%.2f\n", INFINITY) afficherait 1.#J parce que #INF serait « arrondi » avec une précision de 2 chiffres.For example, printf("%.2f\n", INFINITY) would print 1.#J because the #INF would be "rounded" to 2 digits of precision.

Notes

Si l’argument qui correspond à %s ou %S, ou le champ Buffer de l’argument qui correspond à %Z, est un pointeur Null, « (Null) » s’affiche.If the argument that corresponds to %s or %S, or the Buffer field of the argument that corresponds to %Z, is a null pointer, "(null)" is displayed.

Notes

Dans tous les formats exponentiels, le nombre par défaut de chiffres d’exposant affichés est de deux (trois si nécessaire).In all exponential formats, the minimum number of digits of exponent to display is two, using three only if necessary. À l’aide de la fonction _set_output_format, vous pouvez affecter la valeur trois au nombre de chiffres affichés pour compatibilité descendante avec le code écrit pour Visual Studio 2013 et antérieur.By using the _set_output_format function, you can set the number of digits displayed to three for backward compatibility with code written for Visual Studio 2013 and before.

Important

Le format %n étant peu sécurisé par nature, il est désactivé par défaut.Because the %n format is inherently insecure, it is disabled by default. Si %n est présent dans une chaîne de format, le gestionnaire de paramètres non valides est appelé, comme décrit dans Validation de paramètre.If %n is encountered in a format string, the invalid parameter handler is invoked, as described in Parameter Validation. Pour activer la prise en charge de %n, consultez _set_printf_count_output.To enable %n support, see _set_printf_count_output.

Directives d’indicateurFlag directives

Dans une spécification de conversion, le premier champ facultatif contient des directives d’indicateur, zéro ou plusieurs caractères d’indicateur qui spécifient la justification de la sortie et qui contrôlent la sortie des signes, des espaces, des zéros non significatifs, des virgules décimales et des préfixes octaux et hexadécimaux.The first optional field in a conversion specification contains flag directives, zero or more flag characters that specify output justification and control output of signs, blanks, leading zeros, decimal points, and octal and hexadecimal prefixes. Plusieurs directives d’indicateur peuvent apparaître dans une spécification de conversion, et les caractères d’indicateur peuvent apparaître dans n’importe quel ordre.More than one flag directive may appear in a conversion specification, and the flag characters can appear in any order.

Caractères d’indicateurFlag characters

IndicateurFlag SignificationMeaning Par défautDefault
- Aligner à gauche le résultat selon la largeur de champ donnée.Left align the result within the given field width. Aligner à droite.Right align.
+ Utilisez un signe (+ ou -) pour préfixer la valeur de sortie s’il s’agit d’un type signé.Use a sign (+ or -) to prefix the output value if it is of a signed type. Le signe apparaît uniquement pour les valeurs signées négatives (-).Sign appears only for negative signed values (-).
00 Si width est préfixé par 0, des zéros non significatifs sont ajoutés jusqu’à ce que la largeur minimale soit atteinte.If width is prefixed by 0, leading zeros are added until the minimum width is reached. Si 0 et - apparaissent, le 0 est ignoré.If both 0 and - appear, the 0 is ignored. Si 0 est spécifié pour un format entier (i, u, x, X, o, d) et qu’une spécification de précision est également présente (par exemple, %04.d), le 0 est ignoré.If 0 is specified for an integer format (i, u, x, X, o, d) and a precision specification is also present—for example, %04.d—the 0 is ignored. Si 0 est spécifié pour le format à virgule flottante a ou A, des zéros non significatifs sont ajoutés en préfixe à la mantisse, après le préfixe 0x ou 0X.If 0 is specified for the a or A floating-point format, leading zeros are prepended to the mantissa, after the 0x or 0X prefix. Aucun remplissage.No padding.
espace (' ')blank (' ') Utilisez un espace pour préfixer la valeur de sortie si elle est signée et positive.Use a blank to prefix the output value if it is signed and positive. L’espace est ignoré si l’espace et des indicateurs + apparaissent.The blank is ignored if both the blank and + flags appear. Aucun espace ne s’affiche.No blank appears.
# Quand il est utilisé avec le format o, x ou X, l’indicateur # utilise 0, 0x ou 0X, respectivement, pour préfixer une valeur de sortie différente de zéro.When it's used with the o, x, or X format, the # flag uses 0, 0x, or 0X, respectively, to prefix any nonzero output value. Aucun espace ne s’affiche.No blank appears.
Quand il est utilisé avec le format e, E, f, F, a ou A, l’indicateur # impose à la valeur de sortie de contenir une virgule décimale.When it's used with the e, E, f, F, a, or A format, the # flag forces the output value to contain a decimal point. La virgule décimale apparaît uniquement si des chiffres la suivent.Decimal point appears only if digits follow it.
Quand il est utilisé avec le format g ou G, l’indicateur # force la valeur de sortie à contenir une virgule décimale et empêche la troncature des zéros de fin.When it's used with the g or G format, the # flag forces the output value to contain a decimal point and prevents the truncation of trailing zeros.

Ignoré s’il est utilisé avec c, d, i, u ou s.Ignored when used with c, d, i, u, or s.
La virgule décimale apparaît uniquement si des chiffres la suivent.Decimal point appears only if digits follow it. Les zéros de fin sont tronqués.Trailing zeros are truncated.

Spécification de largeurWidth specification

Dans une spécification de conversion, le champ facultatif de spécification de largeur apparaît après n’importe quel caractère d’indicateur.In a conversion specification, the optional width specification field appears after any flags characters. L’argument width est un entier décimal non négatif qui contrôle le nombre minimal de caractères qui sont générés.The width argument is a non-negative decimal integer that controls the minimum number of characters that are output. Si le nombre de caractères dans la valeur de sortie est inférieur à la longueur spécifiée, des espaces sont ajoutés à gauche ou à droite des valeurs, selon que l’indicateur d’alignement à gauche ( - ) est spécifié ou non, jusqu’à ce que la largeur minimale soit atteinte.If the number of characters in the output value is less than the specified width, blanks are added to the left or the right of the values—depending on whether the left-alignment flag (-) is specified—until the minimum width is reached. Si width est préfixé par 0, des zéros non significatifs sont ajoutés aux conversions en entiers ou en nombres à virgule flottante jusqu’à ce que la largeur minimale soit atteinte, sauf en cas de conversion en valeur infinie ou NaN.If width is prefixed by 0, leading zeros are added to integer or floating-point conversions until the minimum width is reached, except when conversion is to an infinity or NaN.

La spécification de largeur ne provoque jamais la troncature d’une valeur.The width specification never causes a value to be truncated. Si le nombre de caractères dans la valeur de sortie est supérieur à la largeur spécifiée, ou si width n’est pas spécifié, tous les caractères de la valeur sont générés, conformément à la spécification precision.If the number of characters in the output value is greater than the specified width, or if width isn't given, all characters of the value are output, subject to the precision specification.

Si la spécification de la largeur est un astérisque (*), un argument int issu de la liste d’arguments fournit la valeur.If the width specification is an asterisk (*), an int argument from the argument list supplies the value. L’argument width doit précéder la valeur mise en forme dans la liste des arguments, comme illustré dans l’exemple suivant :The width argument must precede the value that's being formatted in the argument list, as shown in this example:

printf("%0*d", 5, 3); /* 00003 is output */

Une valeur width manquante ou petite dans une spécification de conversion n’entraîne pas la troncation d’une valeur de sortie.A missing or small width value in a conversion specification doesn't cause the truncation of an output value. Si le résultat d’une conversion est plus large que la valeur width, le champ peut être développé pour contenir le résultat de la conversion.If the result of a conversion is wider than the width value, the field expands to contain the conversion result.

Spécification de précisionPrecision specification

Dans une spécification de conversion, le troisième champ facultatif concerne la spécification de précision.In a conversion specification, the third optional field is the precision specification. Il se compose d’un point (.) suivi d’un entier décimal non négatif qui, selon le type de conversion, spécifie le nombre de caractères de chaîne, le nombre de décimales ou le nombre de chiffres significatifs à générer.It consists of a period (.) followed by a non-negative decimal integer that, depending on the conversion type, specifies the number of string characters, the number of decimal places, or the number of significant digits to be output.

Contrairement à la spécification de largeur, la spécification de précision peut entraîner la troncation de la valeur de sortie ou l’arrondi d’une valeur à virgule flottante.Unlike the width specification, the precision specification can cause either truncation of the output value or rounding of a floating-point value. Si vous spécifiez 0 commeprecision et que la valeur à convertir est 0, vous n’obtenez aucune sortie de caractères, comme illustré dans cet exemple :If precision is specified as 0, and the value to be converted is 0, the result is no characters output, as shown in this example:

printf( "%.0d", 0 ); /* No characters output */

Si la spécification de précision est un astérisque (*), un argument int issu de la liste d’arguments fournit la valeur.If the precision specification is an asterisk (*), an int argument from the argument list supplies the value. Dans la liste d’arguments, l’argument precision doit précéder la valeur mise en forme, comme illustré dans cet exemple :In the argument list, the precision argument must precede the value that's being formatted, as shown in this example:

printf( "%.*f", 3, 3.14159265 ); /* 3.142 output */

Le caractère type détermine soit l’interprétation de precision, soit la précision par défaut quand precision est omis, comme illustré dans le tableau suivant.The type character determines either the interpretation of precision or the default precision when precision is omitted, as shown in the following table.

Impact des valeurs de précision sur le typeHow Precision Values Affect Type

TypeType SignificationMeaning Par défautDefault
a, Aa, A La précision indique le nombre de chiffres après la virgule.The precision specifies the number of digits after the point. La précision par défaut s’élève à 13.Default precision is 13. Si la précision a la valeur 0, aucune virgule décimale n’est imprimée, sauf si l’indicateur # est utilisé.If precision is 0, no decimal point is printed unless the # flag is used.
c, Cc, C La précision n’a aucun effet.The precision has no effect. Le caractère est imprimé.Character is printed.
d, i, o, u, x, Xd, i, o, u, x, X La précision indique le nombre minimal de chiffres à imprimer.The precision specifies the minimum number of digits to be printed. Si le nombre de chiffres dans l’argument est inférieur à precision, la valeur de sortie est remplie à gauche de zéros.If the number of digits in the argument is less than precision, the output value is padded on the left with zeros. La valeur n’est pas tronquée quand le nombre de chiffres dépasse precision.The value is not truncated when the number of digits exceeds precision. La précision par défaut s’élève à 1.Default precision is 1.
e, Ee, E La précision indique le nombre de chiffres à imprimer après la virgule décimale.The precision specifies the number of digits to be printed after the decimal point. Le dernier chiffre imprimé est arrondi.The last printed digit is rounded. La précision par défaut s’élève à 6.Default precision is 6. Si precision a la valeur 0 ou si le point (.) apparaît sans être suivi d’un nombre, aucune virgule décimale n’est imprimée.If precision is 0 or the period (.) appears without a number following it, no decimal point is printed.
f, Ff, F La valeur de précision indique le nombre de chiffres après la virgule décimale.The precision value specifies the number of digits after the decimal point. Si une virgule décimale apparaît, au moins un chiffre apparaît devant.If a decimal point appears, at least one digit appears before it. La valeur est arrondie au nombre approprié de chiffres.The value is rounded to the appropriate number of digits. La précision par défaut s’élève à 6.Default precision is 6. Si precision a la valeur 0 ou si le point (.) apparaît sans être suivi d’un nombre, aucune virgule décimale n’est imprimée.If precision is 0, or if the period (.) appears without a number following it, no decimal point is printed.
g, Gg, G La précision indique le nombre maximal de chiffres significatifs imprimés.The precision specifies the maximum number of significant digits printed. Six chiffres significatifs sont imprimés et tous les zéros de fin sont tronqués.Six significant digits are printed, and any trailing zeros are truncated.
s, Ss, S La précision indique le nombre maximal de caractères à imprimer.The precision specifies the maximum number of characters to be printed. Les caractères au-delà de precision ne sont pas imprimés.Characters in excess of precision aren't printed. Les caractères sont imprimés jusqu’à ce qu’un caractère Null soit rencontré.Characters are printed until a null character is encountered.

Spécification de taille d’argumentArgument size specification

Dans une spécification de conversion, le champ size est un modificateur de longueur d’argument pour le spécificateur de conversion type.In a conversion specification, the size field is an argument length modifier for the type conversion specifier. Les préfixes de champ size du champ type, à savoir hh, h, j, l (L minuscule), L, ll, t, w, z, I (i majuscule), I32 et I64, spécifient la « taille » de l’argument correspondant (long ou court, 32 bits ou 64 bits, caractère sur un octet ou large), selon le spécificateur de conversion qu’ils modifient.The size field prefixes to the type field—hh, h, j, l (lowercase L), L, ll, t, w, z, I (uppercase i), I32, and I64—specify the "size" of the corresponding argument—long or short, 32-bit or 64-bit, single-byte character or wide character—depending on the conversion specifier that they modify. Ces préfixes de taille sont utilisés avec les caractères de type dans les familles printf et wprintf de fonctions pour spécifier l’interprétation des tailles d’argument, comme illustré dans le tableau suivant.These size prefixes are used with type characters in the printf and wprintf families of functions to specify the interpretation of argument sizes, as shown in the following table. Le champ size est facultatif pour certains types d’arguments.The size field is optional for some argument types. Si aucun préfixe de taille n’est spécifié, le formateur consomme les arguments d’entier (par exemple char, short, int, long signé ou non signé, ainsi que les types d’énumération) en tant que types int 32 bits, tandis que les arguments à virgule flottante float, double et long double sont consommés en tant que types double 64 bits.When no size prefix is specified, the formatter consumes integer arguments—for example, signed or unsigned char, short, int, long, and enumeration types—as 32-bit int types, and float, double, and long double floating-point arguments are consumed as 64-bit double types. Ce comportement correspond aux règles de promotion d’argument par défaut pour les listes d’arguments de variable.This behavior matches the default argument promotion rules for variable argument lists. Pour plus d’informations sur la promotion d’argument, consultez Ellipses et arguments par défaut dans Expressions de suffixe.For more information about argument promotion, see Ellipses and Default Arguments in Postfix expressions. Sur les systèmes 32 bits et 64 bits, la spécification de conversion d’un argument d’entier 64 bits doit inclure un préfixe de taille ll ou I64.On both 32-bit and 64-bit systems, the conversion specification of a 64-bit integer argument must include a size prefix of ll or I64. Sinon, le comportement du formateur n'est pas défini.Otherwise, the behavior of the formatter is undefined.

Certains types sont de tailles différentes en code 32 bits et 64 bits.Some types are different sizes in 32-bit and 64-bit code. Par exemple, la longueur de size_t est 32 bits dans le code compilé pour x86, contre 64 bits dans le code compilé pour x64.For example, size_t is 32 bits long in code compiled for x86, and 64 bits in code compiled for x64. Pour créer un code de mise en forme indépendant de la plateforme pour les types de largeur variable, vous pouvez utiliser un modificateur de taille d’argument de largeur variable.To create platform-agnostic formatting code for variable-width types, you can use a variable-width argument size modifier. Vous pouvez également utiliser un modificateur de taille d’argument 64 bits et promouvoir explicitement le type d’argument de largeur variable à 64 bits.Alternatively, use a 64-bit argument size modifier and explicitly promote the variable-width argument type to 64 bits. Spécifique à Microsoft, le modificateur de taille d’argument I (i majuscule) gère les arguments entiers de largeur variable. Toutefois, nous vous recommandons d’utiliser les modificateurs j, t et z spécifiques au type à des fins de portabilité.The Microsoft-specific I (uppercase i) argument size modifier handles variable-width integer arguments, but we recommend the type-specific j, t, and z modifiers for portability.

Préfixes de taille pour les spécificateurs de type de format printf et wprintfSize Prefixes for printf and wprintf Format-Type Specifiers

Pour spécifierTo specify Utilisez le préfixeUse prefix Avec le spécificateur de typeWith type specifier
char
unsigned char
hhhh d, i, o, u, x ou Xd, i, o, u, x, or X
short int
short unsigned int
hh d, i, o, u, x ou Xd, i, o, u, x, or X
__int32
unsigned __int32
I32I32 d, i, o, u, x ou Xd, i, o, u, x, or X
__int64
unsigned __int64
I64I64 d, i, o, u, x ou Xd, i, o, u, x, or X
intmax_t
uintmax_t
j ou I64j or I64 d, i, o, u, x ou Xd, i, o, u, x, or X
long double l (L minuscule) ou Ll (lowercase L) or L a, A, e, E, f, F, g ou Ga, A, e, E, f, F, g, or G
long int
long unsigned int
l (L minuscule)l (lowercase L) d, i, o, u, x ou Xd, i, o, u, x, or X
long long int
unsigned long long int
ll (LL minuscules)ll (lowercase LL) d, i, o, u, x ou Xd, i, o, u, x, or X
ptrdiff_t t ou I (i majuscule)t or I (uppercase i) d, i, o, u, x ou Xd, i, o, u, x, or X
size_t z ou I (i majuscule)z or I (uppercase i) d, i, o, u, x ou Xd, i, o, u, x, or X
Caractère codé sur un octetSingle-byte character hh c ou Cc or C
Caractère largeWide character l (L minuscule) ou wl (lowercase L) or w c ou Cc or C
Chaîne de caractères codés sur un octetSingle-byte character string hh s, S ou Zs, S, or Z
Chaîne de caractères largesWide-character string l (L minuscule) ou wl (lowercase L) or w s, S ou Zs, S, or Z

Les types ptrdiff_t et size_t sont __int32 et unsigned __int32 sur les plateformes 32 bits, et __int64 ou unsigned __int64 sur les plateformes 64 bits.The ptrdiff_t and size_t types are __int32 or unsigned __int32 on 32-bit platforms, and __int64 or unsigned __int64 on 64-bit platforms. Les préfixes de taille I (i majuscule), j, t et z acceptent la largeur correcte des arguments pour la plateforme.The I (uppercase i), j, t, and z size prefixes take the correct argument width for the platform.

Dans Visual C++, bien que long double soit un type distinct, il possède la même représentation interne que double.In Visual C++, although long double is a distinct type, it has the same internal representation as double.

Un spécificateur de type hc ou hC est synonyme de c dans les fonctions printf et de C dans les fonctions wprintf.An hc or hC type specifier is synonymous with c in printf functions and with C in wprintf functions. Un spécificateur de type lc, lC, wc ou wC est synonyme de C dans les fonctions printf et de c dans les fonctions wprintf.An lc, lC, wc, or wC type specifier is synonymous with C in printf functions and with c in wprintf functions. Un spécificateur de type hs ou hS est synonyme de s dans les fonctions printf et de S dans les fonctions wprintf.An hs or hS type specifier is synonymous with s in printf functions and with S in wprintf functions. Un spécificateur de type ls, lS, ws ou wS est synonyme de S dans les fonctions printf et de s dans les fonctions wprintf.An ls, lS, ws or wS type specifier is synonymous with S in printf functions and with s in wprintf functions.

Notes

Section spécifique à Microsoft Les préfixes de modificateur de taille d’argument I (i majuscule), I32, I64 et w sont des extensions Microsoft et ne sont pas compatibles avec la norme ISO C.Microsoft Specific The I (uppercase i), I32, I64, and w argument size modifier prefixes are Microsoft extensions and are not ISO C-compatible. Le préfixe h utilisé avec des données de type char et le préfixel (L minuscule) utilisé avec des données de type double sont des extensions Microsoft.The h prefix when it's used with data of type char and the l (lowercase L) prefix when it's used with data of type double are Microsoft extensions.

Voir aussiSee also

printf, _printf_l, wprintf, _wprintf_lprintf, _printf_l, wprintf, _wprintf_l
printf_s, _printf_s_l, wprintf_s, _wprintf_s_lprintf_s, _printf_s_l, wprintf_s, _wprintf_s_l
Paramètres positionnels printf_pprintf_p Positional Parameters