mvinsnstr man page on MirBSD

Man page or keyword search:  
man Server   6113 pages
apropos Keyword Search (all sections)
Output format
MirBSD logo
[printable version]



curs_insstr(3)	    UNIX Programmer's Manual	   curs_insstr(3)

NAME
     insstr, insnstr, winsstr, winsnstr, mvinsstr, mvinsnstr,
     mvwinsstr, mvwinsnstr - insert string before cursor in a
     curses window

SYNOPSIS
     #include <curses.h>
     int insstr(const char *str);
     int insnstr(const char *str, int n);
     int winsstr(WINDOW *win, const char *str);
     int winsnstr(WINDOW *win, const char *str, int n);
     int mvinsstr(int y, int x, const char *str);
     int mvinsnstr(int y, int x, const char *str, int n);
     int mvwinsstr(WINDOW *win, int y, int x, const char *str);
     int mvwinsnstr(WINDOW *win, int y, int x, const char *str,
     int n);

DESCRIPTION
     These routines insert a character string (as many characters
     as will fit on the line) before the character under the cur-
     sor. All characters to the right of the cursor are shifted
     right with the possibility of the rightmost characters on
     the line being lost. The cursor position does not change
     (after moving to y, x, if specified). The functions with n
     as the last argument insert a leading substring of at most n
     characters. If n<=0, then the entire string is inserted.

     Special characters are handled as in addch.

RETURN VALUE
     All routines that return an integer return ERR upon failure
     and OK (SVr4 specifies only "an integer value other than
     ERR") upon successful completion, unless otherwise noted in
     the preceding routine descriptions.

     X/Open defines no error conditions. In this implementation,
     if the window parameter is null or the str parameter is
     null, an error is returned.

NOTES
     Note that all but winsnstr may be macros.

PORTABILITY
     These functions are described in the XSI Curses standard,
     Issue 4, which adds const qualifiers to the arguments.

     The Single Unix Specification, Version 2 states that insnstr
     and winsnstr perform wrapping. This is probably an error,
     since it makes this group of functions inconsistent. Also,
     no implementation of curses documents this inconsistency.

MirOS BSD #10-current	Printed 18.8.2011			1

curs_insstr(3)	    UNIX Programmer's Manual	   curs_insstr(3)

SEE ALSO
     curses(3), unctrl(3), curs_clear(3), curs_inch(3).

MirOS BSD #10-current	Printed 18.8.2011			2

[top]

List of man pages available for MirBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net