HP-UX

NAME

itermchr − can specify character to terminate iread

SYNOPSIS

 #include <sicl.h>
 int itermchr (INST id, int chr);

DESCRIPTION

Itermchr sets the termination character for future calls of iread.  By default, iread will only terminate on bufsize number of bytes read, or a byte with the END indicator set is read (or an error or timeout occurs). 
 
 
Chr is the character specifying the termination character.  If it is between 0-255, then an iread will terminate if the specified character is read.  If it is -1, then no termination character is used.  By default, the termination character is set to -1, meaning no termination character is used. 
 

RETURN VALUE

The itermchar command returns 0 on success, or a non-zero error number if an error occurred. 

ERRORS

The itermchar fails under the following circumstances, and sets the return value to one of the following:
 

­[I_ERR_BADID] The INST id is invalid

SEE ALSO

igeterrno(3), igeterrstr(3), iread(3)
 

AUTHOR

itermchr was developed by HP. 

Hewlett-Packard Company  —  September 29, 1999