HP C/iX Library Reference Manual (30026-90004)

166 Chapter5
HP C/iX Library Function Descriptions
fprintmsg
fprintmsg
Prints formatted output with numbered arguments.
Syntax
#include <stdio.h>
int fprintmsg (file * stream , char * format [, arg] ...);
Parameters
stream A stream file pointer to which the output is directed.
format A pointer to the string containing formatting information to be output.
format contains optional placeholders and formatting specifications where
arg1 thru argn are to be substituted.
arg1 ... argn A character, character pointer, or integer value giving the parameter to
be converted, formatted, and merged with
format prior to output.
Return Values
x The number of characters transmitted.
EOF Indicates failure.
Description
The fprintmsg function places formatted output on the file or device indicated by stream
after performing the parameter substitution. This function is derived from printf. In
fprintmsg, the conversion character % is replaced by the sequence %n$. The n is a decimal
digit in the range 1-9, and indicates that this conversion should be applied to the nth
argument, rather than to the next unused one. All other aspects of formatting are
unchanged. All conversion specifications must contain the %n$ sequence, and you should
make sure the numbering is correct. All parameters must be used exactly once. See printf
for more details on formatting and conversion specifications.
See Also
printf(), printmsg(), sprintmsg()