insnstr.3x (2010 09)

insnstr(3X) insnstr(3X)

(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(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 ﬁt on the line) before the current or

speciﬁed position in the current or speciﬁed window.

These functions do not advance the cursor position. These functions perform special-character process-

ing. 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 deﬁned.

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.