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)