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

개요

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

addwstr(3xcurses)

X/Open Curses Library Functions                             addnwstr(3XCURSES)



NAME
       addnwstr,  addwstr,  mvaddnwstr,  mvaddwstr,  mvwaddnwstr,  mvwaddwstr,
       waddnwstr, waddwstr - add a wide-character string to a window

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 addnwstr(const wchar_t *wstr, int n);


       int addwstr(const wchar_t *wstr);


       int mvaddnwstr(int y, int x, const wchar_t *wstr, int n);


       int mvaddwstr(int y, int x, const wchar_t *wstr);


       int mvwaddnwstr(WINDOW*win, int y, int x, const wchar_t *wstr, int n);


       int mvwaddwstr(WINDOW*win, int y, int x, const wchar_t *wstr);


       int waddnwstr(WINDOW*win, const wchar_t *wstr, int n);


       int waddwstr(WINDOW*win, const wchar_t *wstr);

DESCRIPTION
       The addwstr() function writes a null-terminated  wide-character  string
       to  the  stdscr  window  at the current cursor position. The waddwstr()
       function performs an identical action, but writes  the  string  to  the
       window  specified  by  win.  The mvaddwstr() and mvwaddwstr() functions
       write the string to the position indicated by  the  x  (column)  and  y
       (row) parameters (the former to the stdscr window; the latter to window
       win).


       The addnwstr(), waddnwstr(), mvaddnwstr(), and mvwaddnwstr()  functions
       write  at  most  n  characters  to the window. If n is less than 0, the
       entire string is written. The former two functions place the characters
       at  the  current cursor position; the latter two commands use the posi‐
       tion specified by the x and y parameters.


       All of these functions advance the cursor after writing the string.


       These functions are functionally equivalent to building a cchar_t  from
       the  wchar_t and the window rendition (or background character and ren‐
       dition) and calling  the  wadd_wch(3XCURSES)  function  once  for  each
       wchar_t  in  the  string.  Refer to the curses(3XCURSES) man page for a
       complete description of special character handling and of the  interac‐
       tion  between  the window rendition (or background character and rendi‐
       tion) and the character written.


       Note that these functions differ from the add_wchnstr(3XCURSES) set  of
       functions  in  that the latter copy the string as is (without combining
       each character with the foreground and  background  attributes  of  the
       window).

PARAMETERS
       wstr    Is a pointer to the wide-character string that is to be written
               to the window.


       n       Is the maximum number of characters to be copied from wstr.  If
               n is less than 0, the entire string is written or as much of it
               as fits on the line.


       y       Is the y (row) coordinate of the starting position of  wstr  in
               the window.


       x       Is  the  x (column) coordinate of the starting position of wstr
               in the window.


       win     Is a pointer to the window in which the string is to  be  writ‐
               ten.


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
       add_wch(3XCURSES),       add_wchnstr(3XCURSES),       curses(3XCURSES),
       libcurses(3XCURSES), attributes(7), standards(7)



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