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-2025 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |