printf - Print Formatted Characters

Syntax

#include <stdio.h>
int printf(const char *format-string, argument-list);

printf formats and prints a series of characters and values to the standard output stream stdout. The format-string consists of ordinary characters, escape sequences, and format specifications. The ordinary characters are copied in order of their appearance to stdout. Format specifications, beginning with a percent sign (%), determine the output format for any argument-list following the format-string.

The format-string is read left to right. When the first format specification is found, the value of the first argument after the format-string is converted and output according to the format specification. The second format specification causes the second argument after the format-string to be converted and output, and so on through the end of the format-string. If there are more arguments than there are format specifications, the extra arguments are evaluated and ignored. The results are undefined if there are not enough arguments for all the format specifications. A format specification has the following form:

>>ФФ%ФФТФФФФТФФТФФФФФФФТФФТФФФФФФФТФФТФФФФФФФФФФФФФФТФФТФФФТФФtypeФФ><
РФn$Фй РФflagsФй РФwidthФй РФ.ФФprecisionФй УФhФД
УФlФД
РФLФй

Each field of the format specification is a single character or number signifying a particular format option. The type character, which appears after the last optional format field, determines whether the associated argument is interpreted as a character, a string, a number, or pointer. The simplest format specification contains only the percent sign and a type character (for example, %s).

The %n$ syntax should always be used when format strings are stored in translatable text such as message catalog files. This is necessary because sentence structures and order of arguments could vary in different languages. For example, in the statement: printf ( format, month, day, year )

In US English, format should be %1$s %2$d, %3$d which results in July 14, 1995.
In German, format should be %2$d. %1$s, %3$d which results in 14. July, 1995.

The following optional fields control other aspects of the formatting:

Field

Description

flags

Justification of output and printing of signs, blanks, decimal points, octal, and hexadecimal prefixes, and the semantics for wchar_t precision unit.

width

Minimum number of bytes output.

precision

Maximum number of bytes printed for all or part of the output field, or minimum number of digits printed for integer values.

A prefix with the integer types d, i, o, u, x, X, and n that specifies that the argument is short int or unsigned short int.

A prefix with d, i, o, u, x, X, and n types that specifies that the argument is a long int or unsigned long int.

A prefix with e, E, f, g, or G types that specifies that the argument is long double.

Each field of the format specification is discussed in detail below. To print a percent sign character, use %%.

In extended mode, printf also converts floating-pointvaluesofNaNandinfinitytothestrings" NAN "or" nan "and" INFINITY "or" infinity " .Thecaseandsignofthestringisdeterminedbytheformatspecifiers . SeeInfinityandNaNSupportformoreinformationoninfinityandNaNvalues .

The type characters and their meanings are given in the following table: кФФФФФФФФФФТФФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФПГChar - ГArgument ГOutputFormat Г
Г acter Г Г Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г d, i Г Integer Г Signed decimal integer. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г o Г Integer Г Unsigned octal integer. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г u Г Integer Г Unsigned decimal integer. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г x Г Integer Г Unsigned hexadecimal integer, using Г
Г Г Г abcdef. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г X Г Integer Г Unsigned hexadecimal integer, using Г
Г Г Г ABCDEF. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г f Г Double Г Signed value having the form Г
Г Г Г [-]dddd.dddd, where dddd is one or Г
Г Г Г more decimal digits. The number of Г
Г Г Г digits before the decimal point Г
Г Г Г depends on the magnitude of the Г
Г Г Г number. The number of digits after Г
Г Г Г the decimal point is equal to the Г
Г Г Г requested precision. NaN and infinity Г
Г Г Г values are printed in lowercase ("nan" Г
Г Г Г and "infinity"). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г F Г Double Г In extended mode,identical to the "f" Г
Г Г Г format except that NaN and infinity Г
Г Г Г values are printed in uppercase ("NAN" Г
Г Г Г and "INFINITY"). In modes other than Г
Г Г Г extended, "F" is treated like any Г
Г Г Г other character not included in this Г
Г Г Г table. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г e Г Double Г Signed value having the form Г
Г Г Г [-]d.dddd"e"[sign] ddd, where d is a Г
Г Г Г single-decimal digit, dddd is one or Г
Г Г Г more decimal digits, ddd is 2 or 3 Г
Г Г Г decimal digits, and sign is + or -. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г E Г Double Г Identical to the "e" format except Г
Г Г Г that "E" introduces the exponent Г
Г Г Г instead of "e". Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г g Г Double Г Signed value printed in "f" or "e" Г
Г Г Г format. The "e" format is used only Г
Г Г Г when the exponent of the value is less Г
Г Г Г than -4 or greater than precision. Г
Г Г Г Trailing zeros are truncated, and the Г
Г Г Г decimal point appears only if one or Г
Г Г Г more digits follow it. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г G Г Double Г Identical to the "g" format except Г
Г Г Г that "G" introduces the exponent Г
Г Г Г (where appropriate) instead of "g". Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г c Г Character Г Single character. The "int" argument Г
Г Г Г is converted to an unsigned character. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г lc, C Г Wide character Г Multibyte character (converted as if Г
Г Г Г by a call to wctomb) pointer to an Г
Г Г Г array of "char". Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г s Г String Г Characters printed up to the first Г
Г Г Г null character (\"0") or until preci- Г
Г Г Г sion is reached. If you specify a Г
Г Г Г null string, "(NULL)" is printed. Г
РФФФФФФФФФФСФФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй
кФФФФФФФФФФТФФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
Г ls, S Г Wide-character Г Multibyte characters, printed up to Г
Г Г string Г the first "wchar_t" null character Г
Г Г Г ("L\0") is encountered in the wide- Г
Г Г Г character string, or until the speci- Г
Г Г Г fied precision is reached. Conversion Г
Г Г Г takes place as if by a call to Г
Г Г Г wcstombs. The displayed result does Г
Г Г Г not include the terminating null char- Г
Г Г Г acter. If you do not specify the pre- Г
Г Г Г cision, you must end the Г
Г Г Г wide-character string with a null Г
Г Г Г character. A partial multibyte char- Г
Г Г Г acter cannot be written. If you Г
Г Г Г specify a null string, "(NULL)" is Г
Г Г Г printed. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г n Г Pointer to Г Number of characters successfully Г
Г Г integer Г written so far to the stream or Г
Г Г Г buffer; this value is stored in the Г
Г Г Г integer whose address is given as the Г
Г Г Г argument. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г p Г Pointer Г Pointer to void converted to a Г
Г Г Г sequence of printable characters. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г % Г `%' Г Use to print a "%" symbol. Г
РФФФФФФФФФФСФФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

The flag characters and their meanings are as follows (notice that more than one flag can appear in a format specification): кФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФП
Г Flag Г Meaning Г Default Г
УФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФД
Г - Г Left-justify the result within Г Right-justify. Г
Г Г the field width. Г Г
УФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФД
Г + Г Prefix the output value with a Г Sign appears only Г
Г Г sign (+ or -) if the output Г for negative signed Г
Г Г value is of a signed type. Г values (-). Г
УФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФД
Г blank(' ')Г Prefix the output value with a Г No blank. Г
Г Г blank if the output value is Г Г
Г Г signed and positive. The "+" Г Г
Г Г flag overrides the blank flag Г Г
Г Г if both appear, and a positive Г Г
Г Г signed value will be output Г Г
Г Г with a sign. Г Г
УФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФД
Г # Г When used with the "o", "x", or Г No prefix. Г
Г Г "X" formats, the "#" flag pre- Г Г
Г Г fixes any nonzero output value Г Г
Г Г with "0", "0"x, or "0"X, Г Г
Г Г respectively. Г Г
УФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФД
Г # Г When used with the "f", "F", Г Decimal point Г
Г Г "e", or "E" formats, the "#" Г appears only if Г
Г Г flag forces the output value to Г digits follow it. Г
Г Г contain a decimal point in all Г Г
Г Г cases. Г Г
УФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФД
Г # Г When used with the "g" or "G" Г Decimal point Г
Г Г formats, the "#" flag forces Г appears only if Г
Г Г the output value to contain a Г digits follow it; Г
Г Г decimal point in all cases and Г trailing zeros are Г
Г Г prevents the truncation of Г truncated. Г
Г Г trailing zeros. Г Г
УФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФД
Г # Г When used with the "ls" format, Г Precision indicates Г
Г Г the "#" flag causes precision Г the maximum number Г
Г Г to be measured in "wchar_t" Г of bytes to be Г
Г Г characters. Г output. Г
УФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФД
Г "0" Г When used with the "d", "i", Г Space padding. Г
Г Г "o", "u", "x", "X", "e", "E", Г Г
Г Г "f", "F"" g", or "G" formats, Г Г
Г Г the "0" flag causes leading Г Г
Г Г "0"'s to pad the output to the Г Г
Г Г field width. The "0" flag is Г Г
Г Г ignored if precision is speci- Г Г
Г Г fied for an integer or if the Г Г
Г Г `"-"' flag is specified. Г Г
УФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФД
Г ' Г Formats with the thousands Г No grouping char- Г
Г Г grouping character of the Г acter. Г
Г Г appropriate locale for the Г Г
Г Г decimal conversions (%i, %d, Г Г
Г Г %u, %f, %g, or %G). Г Г
РФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФй

The # flag should not be used with c, lc, d, i, u, s, or p types.

Width is a nonnegative decimal integer controlling the minimum number of characters printed. If the number of characters in the output value is less than the specified width, blanks are added on the left or the right (depending on whether the - flag is specified) until the minimum width is reached.

Width never causes a value to be truncated; if the number of characters in the output value is greater than the specified width, or width is not given, all characters of the value are printed (subject to the precision specification).

For the ls type, width is specified in bytes. If the number of bytes in the output value is less than the specified width, single-byte blanks are added on the left or the right (depending on whether the - flag is specified) until the minimum width is reached.

The width specification can be an asterisk (* or *n$), in which case an argument from the argument list supplies the value. The width argument must precede the value being formatted in the argument list.

Precision is a nonnegative decimal integer preceded by a period, which specifies the number of characters to be printed or the number of decimal places. Unlike the width specification, the precision can cause truncation of the output value or rounding of a floating-point value.

The precision specification can be an asterisk (* or *n$), in which case an argument from the argument list supplies the value. The precision argument must precede the value being formatted in the argument list.

The interpretation of the precision value and the default when the precision is omitted depend upon the type, as shown in the following table: кФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФП
Г Type Г Meaning Г Default Г
УФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФД
Г i Г Precision specifies the minimum Г If precision is "0" or Г
Г d Г number of digits to be printed. Г omitted entirely, or Г
Г u Г If the number of digits in the Г if the period (.) Г
Г o Г argument is less than precision, Г appears without a Г
Г x Г the output value is padded on Г number following it, Г
Г X Г the left with zeros. The value Г the precision is set Г
Г Г is not truncated when the number Г to 1. Г
Г Г of digits exceeds precision. Г Г
УФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФД
Г f Г Precision specifies the number Г Default precision is Г
Г F Г of digits to be printed after Г six. If precision is Г
Г e Г the decimal point. The last Г "0" or the period Г
Г E Г digit printed is rounded. Г appears without a Г
Г Г Г number following it, Г
Г Г Г no decimal point is Г
Г Г Г printed. Г
УФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФД
Г g Г Precision specifies the maximum Г All significant digits Г
Г G Г number of significant digits Г are printed. Г
Г Г printed. Г Г
УФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФД
Г c Г No effect. Г The character is Г
Г Г Г printed. Г
УФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФД
Г lc, C Г No effect. Г The "wchar_t" char- Г
Г Г Г acter is printed. Г
УФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФД
Г s Г Precision specifies the maximum Г Characters are printed Г
Г Г number of characters to be Г until a null character Г
Г Г printed. Characters in excess Г is encountered. Г
Г Г of precision are not printed. Г Г
УФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФД
Г ls, S Г Precision specifies the maximum Г "wchar_t" characters Г
Г Г number of bytes to be printed. Г are printed until a Г
Г Г Bytes in excess of precision are Г null character is Г
Г Г not printed; however, multibyte Г encountered. Г
Г Г integrity is always preserved. Г Г
РФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФй

The printf function returns the number of bytes printed.

This example prints data in a variety of formats.

#include <stdio.h>

int main(void)
{
   char ch = 'h',*string = "computer";
   int count = 234,hex = 0x10,oct = 010,dec = 10;
   double fp = 251.7366;

   printf("%d   %+d    %06d     %X    %x     %o\n\n", count, count, count, count
      , count, count);
   printf("1234567890123%n4567890123456789\n\n", &count);
   printf("Value of count should be 13; count = %d\n\n", count);
   printf("%10c%5c\n\n", ch, ch);
   printf("%25s\n%25.4s\n\n", string, string);
   printf("%f    %.2f    %e    %E\n\n", fp, fp, fp, fp);
   printf("%i    %i     %i\n\n", hex, oct, dec);
   return 0;

   /****************************************************************************
      The output should be:

      234   +234    000234     EA    ea     352

      12345678901234567890123456789

      Value of count should be 13; count = 13

               h    h

                       computer
                           comp

      251.736600    251.74    2.517366e+02    2.517366E+02

      16    8     10
   ****************************************************************************/
}

[Back]

[Next]