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 nl_printf, nl_fprintf, and nl_sprintf are identical to and have been superceded by the international functions printf, fprintf, and sprintf in a library. You should use the printf, fprintf, and sprintf functions when you write new calls to print formatted output in an international program. For more information on these functions, see the printf() reference page.

You can continue to use existing calls to the nl_printf, nl_fprintf, or nl_sprintf 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 nl_printf, nl_fprintf, and nl_sprintf international functions are similar to the printf standard I/O function. (For more information about the printf standard I/O function, see the printf() 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 format strings containing the % conversion character. If you use an asterisk, you can supply an integer argument 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 printf.

You must use each digit argument at least once. The results of not using an argument are undefined.

International Environment

LC_NUMERICIf this environment is set and valid, nl_printf uses the international language database named in the definition to determine radix character rules.

LANGIf this environment variable is set and valid nl_printf uses the international language database named in the definition to determine collation and character classification rules. If LC_NUMERIC 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 following nl_printf statement:

nl_printf (format, weekday, month, day, hour, min);

For United States of America use, format could be a pointer to the following string:

"%1$s, %2$s %3$d, %4$d:%5$.2d\n"

This format string produces the following message:

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\n"

This format produces the following message:

Sonntag, 3. Juli, 10:02

Museum