curs_insstr(3x) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

curs_insstr(3x)

curs_insstr(3x)                                                curs_insstr(3x)



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

SYNOPSIS
       #include <ncursesw/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 cursor.  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  descrip‐
       tions.

       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.

       Functions  with  a  “mv”  prefix  first perform a cursor movement using
       wmove, and return an error if the position is outside the window, or if
       the window pointer is null.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       box; cbp-1 | cbp-1 l | l .  ATTRIBUTE TYPE ATTRIBUTE VALUE = Availabil‐
       ity   library/ncurses = Stability Uncommitted


NOTES
       Note that all but winsnstr may be macros.

       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source   was    downloaded    from     https://invisible-mirror.net/ar‐
       chives/ncurses/ncurses-6.3.tar.gz.

       Further information about this software can be found on the open source
       community website at https://invisible-island.net/ncurses/.

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 win‐
       snstr perform wrapping.  This is probably an error, since it makes this
       group  of  functions  inconsistent.   Also, no implementation of curses
       documents this inconsistency.

SEE ALSO
       curses(3X), curs_util(3X), curs_clear(3X), curs_inch(3X).




                                                               curs_insstr(3x)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3