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 out‐
put in an international program. For more information on these func‐
tions, see the reference page.
You can continue to use existing calls to the or international func‐
tions. 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 func‐
tion. (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 character. If
you use an asterisk, you can supply an integer argument that specifies
the field width or precision. In strings containing the %digit$ con‐
version 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 interna‐
tional 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\n",
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 follow‐
ing 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\n"
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\n"
This produces the following message:
Sonntag, 3. Juli, 10:02
See Alsointro(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)
