int scanf ( const char * format [ , argument , ...] );
Read formatted data from stdin.
Reads data from the standard input (stdin) and stores it into the locations given by argument(s). Locations pointed by each argument are filled with their corresponding type of value requested in the format string.
There must be the same number of type specifiers in format string than arguments passed.
|*||Data is read but ignored. It is not assigned to the corresponding argument.|
|width||Specifies the maximum number of characters to be read.|
|modifiers||Specifies a different size for the data pointed by argument:|
|type||Character specifying the type of data that is expected and how it has to be read. See next table.|
|Qualifying Input||Argument required|
|Single character: Reads the next character (whitespace characters included).||char *|
|Decimal integer: Number optionally preceeded with a sign.||int *|
|Floating point: Decimal number containing a decimal point, optionally preceeded by a sign and optionally folowed by the e or E character and a decimal number. Valid entries are -732.103 or 7.12e4||float *|
|Octal integer.||int *|
|String of characters. This will read subsequent characters until a whitespace is found (whitespace characters are blank, newline and tab).||char *|
|Unsigned decimal integer.||unsigned int *|
|Hexadecimal integer.||int *|
The number of items succesfully read. This count doesn't include any ignored fields with asterisks (*).
If EOF is returned an error has occurred before the first assignation could be done.
Defined in ANSI-C.
/* scanf example */
char str ;
printf ("Enter your surname: ");
printf ("Enter your age: ");
printf ("Mr. %s , %d years old.\n",str,i);
printf ("Enter a hexadecimal number: ");
printf ("You have entered %#x (%d).\n",i,i);
This example demonstrates some of the types that can be read with scanf:
Enter your surname: Soulie
Enter your age: 23
Mr. Soulie , 23 years old.
Enter a hexadecimal number: ff
You have entered 0xff (255).
fscanf, printf, fopen, fclose