insnstr(3X)                                                     insnstr(3X)

NAME
     insnstr, insstr, mvinsnstr, mvinsstr, mvwinsnstr, mvwinsstr, winsnstr,
     winsstr - insert a multi-byte character string into a window

SYNOPSIS
     cc [flag ...] file ... -lcurses [library ...]

     #include <curses.h>

     int insnstr(const char *str, int n);

     int insstr(const char *str);

     int mvinsnstr(int y, int x, const char *str, int n);

     int mvinsstr(int y, int x, const char *str);

     int mvwinsnstr(WINDOW *win, int y, int x, const char *str, int n);

     int mvwinsstr(WINDOW *win, int y, int x, const char *str);

     int winsnstr(WINDOW *win, const char *str, int n);

     int winsstr(WINDOW *win, const char *str);

DESCRIPTION
     These functions insert a character string (as many characters as will
     fit on the line) before the current or specified position in the
     current or specified window.

     These functions do not advance the cursor position. These functions
     perform special-character processing. The insnstr() and winsnstr()
     functions perform wrapping. The insstr() and winsstr() functions do
     not perform wrapping.

     The insnstr(), mvinsnstr(), mvwinsnstr() and winsnstr() functions
     insert at most n bytes. If n is less than 1, the entire string is
     inserted.

RETURN VALUE
     Upon successful completion, these functions return OK. Otherwise, they
     return ERR.

ERRORS
     No errors are defined.

NOTES
     Since the string may contain multi-byte characters, there might not be
     a one-to-one correspondence between the number of column positions
     occupied by the characters and the number of bytes in the string.





Page 1                       Reliant UNIX 5.44                Printed 11/98

insnstr(3X)                                                     insnstr(3X)

SEE ALSO
     curses(3X), curses(5).




















































Page 2                       Reliant UNIX 5.44                Printed 11/98