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

개요

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

addnwstr(3xcurses)

addnwstr(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  en‐
       tire  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