intro(3int) [ultrix man page]
intro(3int) intro(3int) Name intro - introduction to international subroutines Description The internationalization package provides a convenient method of writing or converting applications so that they can operate in the appli- cation user's natural language. The package consists of the following: o Tools for the creation and modification of message catalogs o An international function library, which is called libi o A set of international functions available in the C library, libc o An international compiler that creates language support databases from special source files o An announcement and initialization mechanism o A utility for converting data from one codeset to another codeset When you use international library functions in a C program, compile it with the option to include libi, as shown: % cc -o prog prog.c -li Some of the international functions are available in the standard C library. You need not compile with the option if you use only those functions. The functions that are available in the standard C library are and Libraries Internationalization Library Calls catgetmsg get message from a message catalog (provided for XPG-2 compatibility) catgets read a program message catopen open or close a message catalog nl_init set localization for internationalized program (provided for XPG-2 compatibility) nl_langinfo language information nl_printf print formatted output (provided for XPG-2 compatibility) nl_scanf convert formatted input (provided for XPG-2 compatibility) printf print formatted output scanf convert formatted input vprintf print formatted output of varargs argument list Standard C Library Calls setlocale set localization for internationalized program strftime convert time and date to string strxfrm string transformation strcoll string collation comparison Header Files i_defs.h contains language support database structure i_errno.h contains error numbers and messages langinfo.h contains the langinfo definitions for the locale database locale.h contains the declarations used by the ANSI setlo- cale and localeconv functions nl_types.h contains the definitions for all the internation- alization (libi) functions See Also iconv(1), extract(1int), gencat(1int), ic(1int), strextract(1int), strmerge(1int), trans(1int), ctype(3), setlocale(3), strcoll(3), strf- time(3), strxfrm(3), catgets(3int), catopen(3int), nl_langinfo(3int), printf(3int), scanf(3int), vprintf(3int), environ(5int), lang(5int), nl_types(5int), patterns(5int) Guide to Developing International Software intro(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)