NAME Cif_Msginsert - Inserts message arguments into message text SYNOPSIS #define CIF_VERSION 2 #include <cif.h> int Cif_Msginsert (msgbuff, msgstruct, newbuff, nblen) char *msgbuff; struct Cif_generic *msgstruct; char *newbuff; int nblen; IMPLEMENTATION All Sun SPARC systems DESCRIPTION The compiler information file (CIF) message structures (Cif_c_message and Cif_message) reference messages by number. The message text must be retrieved from the message catalog by using catgetmsg. After the text is available, the Cif_Msginsert routine combines the message arguments from the message structure (msgstruct) with the text (msgbuff) and produces a printable message (newbuff). newbuff must consist of nblen characters. If the message is too long to fit in newbuff, Cif_Msginsert truncates the end of the message. CIF_VERSION defines the library version. The default is 1. The newest version is 2 and should be used with this rou- tine. See the Cif(3) man page for a discussion about CIF informa- tion, format, and versions. RETURN VALUES A positive return value indicates successful completion. A negative return value indicates that an error occurred. EXAMPLES The following example, when used in a program, produces a printable message from the message number contained in a Cif_message structure: char msgtext[100]; struct Cif_message *msg; char newtext[100]; . . . (void) Cif_Msginsert (msgtext, (struct Cif_generic *)msg, newtext, 100); . . . SEE ALSO Cif(3) for general information about CIFs Cif_Close(3), Cif_Duplicate(3), Cif_Errstring(3), Cif_Free(3), Cif_Getpos(3), Cif_Getrecord(3), Cif_Memmode(3), Cif_Open(3), Cif_Release(3), Cif_Setpos(3) for information about general CIF library routines Cif_Getfiledir(3), Cif_Getunitdir(3), Cif_Recgroup(3) for information about binary-format specific CIF library routines cifconv(1) for information about ASCII to binary format conversion in the Compiler information file CIF Compiler information Compiler listings
Закладки на сайте Проследить за страницей |
Created 1996-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |