fscanf(3int) [ultrix man page]
scanf(3int) scanf(3int) Name scanf, fscanf, sscanf - convert formatted input Syntax #include <stdio.h> int scanf( format [, pointer ] ... ) char *format; int fscanf( stream, format [, pointer ] ... ) FILE *stream; char *format; int sscanf( s, format [, pointer ] ... ) char *s, *format; Description The international functions and are similar to the standard I/O functions. The difference is that the international functions allow you to use the %digit$ conversion character in place of the I% character you use in the standard I/O functions. The digit is a decimal digit n from 1 to 9. The international functions apply conversions to the n th argument in the argument list, rather than to the next unused argu- ment. You can use % conversion character in the international functions. However, you cannot mix the % conversion character with the %digit$ conversion character in a single call. In all cases, uses the radix character and collating sequence that is defined by the last successful call to category or If the radix or collating sequence is undefined, the function uses the C locale definitions. International Environment LC_COLLATE Contains the user requirements for language, territory, and codeset for the character collation format. affects the behav- ior of regular expressions and the string collation functions in If is not defined in the current environment, provides the necessary default. LC_NUMERIC If this environment is set and valid, uses the international language database named in the definition to determine radix character rules. LANG If this environment variable is set and valid uses the international language database named in the definition to determine collation and character classification rules. If or is defined, their definitions supersede the definition of LANG. Examples The following shows an example of using the function: scanf("%2$s %1$d", integer, string) If the input is `` january 9 '', the function assigns 9 to and ``january'' to Return Values The function returns the number of successfully matched and assigned input fields. This number can be zero if the function encounters invalid input characters, as specified by the conversion specification, before it can assign input characters. If the input ends before the first conflict or conversion, returns EOF. These functions return EOF on end of input and a short count for missing or invalid data items. Environment In POSIX mode, the E, F, and X formats are treated the same as the e, f, and x formats, respectively; otherwise, the upper-case formats expect double, double, and long arguments, respectively. See Also intro(3int), setlocale(3), strtod(3), strtol(3), printf(3int), getc(3s), printf(3s), scanf(3s) Guide to Developing International Software scanf(3int)
Check Out this Related Man Page
printf(3int) printf(3int) Name printf, fprintf, sprintf - print formatted output Syntax #include <stdio.h> int printf ( format [, arg ] ... ) char *format; int fprintf ( stream, format [, arg ] ... ) FILE *stream; char *format; int sprintf ( s, format [, arg ] ... ) char *s, *format; Description The international functions and are similar to the standard I/O functions. The difference is that the international functions allow you to use the %digit$ conversion character in place of the % character you use in the standard I/O functions. The digit is a decimal digit n from 1 to 9. The international functions apply conversions to the n th argument in the argument list, rather than to the next unused argument. You can use the % conversion character in the international functions. However, you cannot mix the % conversion character with the %digit$ conversion character in a single call. You can indicate a field width or precision by an asterisk (*) instead of a digit string in format strings containing the % conversion character. If you use an asterisk, you can supply an integer arg that specifies the field width or precision. In format strings containing the %digit$ conversion character, you can indicate field width or precision by the sequence *digit$. You use a decimal digit from 1 to 9 to indicate which argument contains an integer that specifies the field width or precision. The conversion characters and their meanings are identical to You must use each digit argument at least once. In all cases, the radix character uses is defined by the last successful call to category If category has not been called successfully or if the radix character is undefined, the radix character defaults to a period (.). International Environment LC_NUMERIC If this environment is set and valid, uses the international language database named in the definition to determine radix character rules. LANG If this environment variable is set and valid uses the international language database named in the definition to determine collation and character classification rules. If is defined, its definition supercedes the definition of LANG. Examples The following example illustrates using an argument to specify field width: printf ("%1$d:%2$.*3$d:%4$.*3$d ", hour, min, precision, sec); The format string *3$ indicates that the third argument, which is named precision, contains the integer field width specification. To print the language independent date and time format use the following statement: printf (format, weekday, month, day, hour, min); For American use, format could be a pointer to the following string: "%1$s, %2$s %3$d, %4$d:%5$.2d " This string gives the following date format: Sunday, July 3, 10:02 For use in a German environment, format could be a pointer to the following string: "%1$s, %3$d. %2$s, %4$d:%5$.2d " This string gives the following date format: Sonntag, 3. Juli, 10:02 Return Values and return zero for success and EOF for failure. The subroutine returns its first argument for success and EOF for failure. In the System V and POSIX environments, and return the number of characters transmitted for success. The function ignores the null termi- nator ( ) when calculating the number of characters transmitted. If an output error occurs, these routines return a negative value. See Also intro(3int), setlocale(3), scanf(3int), printf(3s), putc(3s), scanf(3s), stdio(3s) Guide to Developing International Software printf(3int)