addnstr(3X)                                                     addnstr(3X)

NAME
     addnstr, addstr, mvaddnstr, mvaddstr, mvwaddnstr, mvwaddstr waddnstr,
     waddstr - add a string of multi-byte characters without rendition to a
     window and advance cursor

SYNOPSIS
     cc [flag ...] file ... -lcurses [library ...]

     #include <curses.h>

     int addnstr(const char *str, int n);

     int addstr(const char *str);

     int mvaddnstr(int y, int x, const char *str, int n);

     int mvaddstr(int y, int x, const char *str);

     int mvwaddnstr(WINDOW *win, int y, int x, const char *str, int n);

     int mvwaddstr(WINDOW *win, int y, int x, const char *str);

     int waddnstr(WINDOW *win, const char *str, int n);

     int waddstr(WINDOW *win, const char *str);

DESCRIPTION
     These functions write the characters of the string str on the current
     or specified window starting at the current or specified position
     using the background rendition.

     These functions advance the cursor position. These functions perform
     special character processing. These functions perform wrapping.

     The addstr(), mvaddstr(), mvwaddstr() and waddstr() functions are
     similar to calling mbstowcs() on str, and then calling addwstr(),
     mvaddwstr(), mvwaddwstr() and waddwstr(), respectively.

     The addnstr(), mvaddnstr(), mvwaddnstr() and waddnstr() functions use
     at most n bytes from str. These functions add the entire string when n
     is -. These functions are similar to calling mbstowcs() on the first n
     bytes of str, and then calling addwstr(), mvaddwstr(), mvwaddwstr()
     and waddwstr(), respectively.

RETURN VALUE
     Upon successful completion, these functions return OK. Otherwise, they
     return ERR.

ERRORS
     No errors are defined.





Page 1                       Reliant UNIX 5.44                Printed 11/98

addnstr(3X)                                                     addnstr(3X)

SEE ALSO
     mbstowcs(3C), addnwstr(3X), curses(3X), curses(5).




















































Page 2                       Reliant UNIX 5.44                Printed 11/98