Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

scanf(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

nl_scanf(3int)															    nl_scanf(3int)

Name
       nl_scanf, nl_fscanf, nl_sscanf - convert formatted input

Syntax
       #include <stdio.h>

       int nl_scanf ( format [, pointer ] ...  )
       char *format;

       int nl_fscanf ( stream, format [, pointer ] ...	)
       FILE *stream;
       char *format;

       int nl_sscanf ( s, format [, pointer ] ...  )
       char *s, *format;

Description
       The  international  functions and are identical to and have been superceded by the international functions and in libi.	You should use the
       and functions when you write new calls to convert formatted input in international programs. For more information on these  functions,  see
       the reference page.

       You  can continue to use existing calls to the or functions. These functions remain available for compatibility with XPG-2 conformant soft-
       ware, but may not be supported in future releases of the ULTRIX system.

       The and international functions are similar to the standard I/O function. (For more information on the standard I/O function, see reference
       page.)	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.

   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 supersedes the definition of LANG.

Examples
       The following shows an example of using the function:
       nl_scanf("%2$s %1$d", integer, string)
       If the input contains `` january 9 '', the function assigns 9 to integer and ``january'' to string .

Return Values
       These functions return either the number of items matched or EOF on end of input, along with the number of missing or invalid  data items.

See Also
       intro(3int), setlocale(3), strtod(3), strtol(3), nl_printf(3int), printf(3int), scanf(3int), getc(3s), printf(3s), scanf(3s)
       Guide to Developing International Software

																    nl_scanf(3int)
Man Page