ENHANCED CURSES

NAME

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

SYNOPSIS

#include <curses.h>

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

int insstr(char *const str);

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

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

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

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

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

int winsstr(WINDOW *win, char *const 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 innstr() and innwstr() functions perform wrapping.  The instr() and inswstr() 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. 

APPLICATION USAGE

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. 

SEE ALSO

<curses.h>. 

CHANGE HISTORY

First released in X/Open Curses, Issue 4. 

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996