HP-UX

NAME

ipromptf − performs a formatted write and read from a device

SYNOPSIS

#include <sicl.h>
 
int ipromptf (INST id, char *writefmt, char *readfmt, arg1, arg2, ...);
 

DESCRIPTION

The ipromptf routine performs a formatted write and read from a device. 
 
The id is a valid INST returned from an iopen(3).  To use this routine you MUST use a device session. 
 
The writefmt is the format string used to perform the write portion of the ipromptf.  This format string is equivalent to the format string used in iprintf.  See iprintf for more details.  This format string uses the first n arguments to satasfy the conversions. 
 
The readfmt is the format string used to perform the read portion of the ipromptf.  This format string is equivalent of the format string used in iscanf.  See iscanf for more details.  This format string used the remaining user arguments starting at n+1 to satisfy the conversions. 
 

RETURN VALUE

ipromptf returns the number of arguments used by both the format strings with format conversions requiring multiple parameters counting as one. 

ERRORS

ipromptf fails under the following circumstances, and returns one of the following values:
 

­[I_ERR_NOINTF] Interface is not active

­[I_ERR_NODEV] Device is not active

­[I_ERR_BADID] The INST id is invalid

SEE ALSO

iprintf(3), iscanf(3), iflush(3), isetbuf(3), iopen(3)

AUTHOR

ipromptf was developed by HP. 

Hewlett-Packard Company  —  September 29, 1999