insnstr(3xcurses) 맨 페이지 - 윈디하나의 솔라나라

개요

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

insnstr(3xcurses)

X/Open Curses Library Functions                              insnstr(3XCURSES)



NAME
       insnstr,  insstr, mvinsnstr, mvinsstr, mvwinsnstr, mvwinsstr, winsnstr,
       winsstr - insert a multibyte character string

SYNOPSIS
       cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib \
       -R /usr/xpg4/lib -lcurses [ library... ]

       c89 [ 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);

PARAMETERS
       str    Is a pointer to the string to be inserted.


       n      Is the number of characters not to exceed when inserting str. If
              n is less than 1, the entire string is inserted.


       y      Is  the  y  (row)  coordinate  of  the  starting position of the
              string.


       x      Is the x (column) coordinate of the  starting  position  of  the
              string.


       win    Is  a  pointer  to  the  window  in  which  the  string is to be
              inserted.


DESCRIPTION
       The insstr() function inserts str at the current cursor position of the
       stdscr  window.  The  winsstr() function performs the identical action,
       but in window win. The mvinsstr() and mvwinsstr() functions insert  the
       character  string  at the starting position indicated by the x (column)
       and y (row) parameters (the former to the stdscr window; the latter  to
       window win).


       The  insnstr(),  winsnstr(),  mvinsnstr(),  and  mvwinsnstr() functions
       insert n characters to the window or as many as will fit on  the  line.
       If  n is less than 1, the entire string is inserted or as much of it as
       fits on the line. The former two functions place the string at the cur‐
       rent  cursor  position; the latter two commands use the position speci‐
       fied by the x and y parameters.


       All characters to the right of inserted characters  are  moved  to  the
       right. Characters that don't fit on the current line are discarded. The
       cursor is left at the point of insertion.


       If a character in str is a newline, carriage return, backspace, or tab,
       the  cursor is moved appropriately. The cursor is moved to the next tab
       stop for each tab character (by  default,  tabs  are  eight  characters
       apart). If the character is a control character other than those previ‐
       ously mentioned, the character is inserted using ^x notation,  where  x
       is  a  printable  character.  clrtoeol(3XCURSES)  is automatically done
       before a newline.

RETURN VALUES
       On success, these functions return OK. Otherwise, they return ERR.

ERRORS
       None.

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


       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE  VALUE  _ Interface StabilityCommitted _ MT-LevelUnsafe _ Stan‐
       dardSee standards(7).


SEE ALSO
       addchstr(3XCURSES),        addstr(3XCURSES),        clrtoeol(3XCURSES),
       ins_nwstr(3XCURSES),    insch(3XCURSES),   libcurses(3XCURSES),   stan‐
       dards(7), attributes(7)



Oracle Solaris 11.4               5 Jun 2002                 insnstr(3XCURSES)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3