Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

nl_sscanf(3int) [ultrix 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)

Check Out this Related Man Page

nl_printf(3int) 														   nl_printf(3int)

Name
       nl_printf, nl_fprintf, nl_sprintf - print formatted output

Syntax
       #include <stdio.h>

       int nl_printf ( format [, arg ] ...  )
       char *format;

       int nl_fprintf ( stream, format [, arg ] ...  )
       FILE *stream;
       char *format;

       int nl_sprintf ( s, format [, arg ] ...	)
       char *s, format;

Description
       The  international  functions and are identical to and have been superceded by the international functions and in a library. You should use
       the and functions when you write new calls to print formatted output in an international program. For more information on these	functions,
       see the reference page.

       You  can  continue  to use existing calls to the or international functions.  These functions remain available for compatibility with XPG-2
       conformant software, 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 about the standard I/O  function,  see  the
       reference  page.)   The	difference is that the international functions allow you to use the I%digit$ conversion sequence 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  %  conversion character in the international functions.  However, you cannot mix the % conversion character with the %digit$
       conversion sequence in a single call.

       You can indicate a field width or precision by an asterisk (*), instead of a digit string, in strings containing the %  conversion  charac-
       ter.  If  you  use  an asterisk, you can supply an integer argument that specifies the field width or precision.  In 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.	The results of not using an argument are undefined.

   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:
       nl_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:
       nl_printf (format, weekday, month, day, hour, min);
       For United States of America use, could be a pointer to the following string:
       "%1$s,  %2$s %3$d, %4$d:%5$.2d
"
       This string produces the following message:
       Sunday, July 3, 10:02
       For use in a German environment, could be a pointer to the following string:
       "%1$s, %3$d. %2$s, %4$d:%5$.2d
"
       This produces the following message:
       Sonntag, 3. Juli, 10:02

See Also
       intro(3int), setlocale(3), nl_scanf(3int), printf(3int), scanf(3int), printf(3s), putc(3s), scanf(3s), stdio(3s)
       Guide to Developing International Software

																   nl_printf(3int)
Man Page