HP-UX Reference (11i v2 07/12) - 3 Library Functions A-M (vol 6)

addnstr(3X) addnstr(3X)

(ENHANCED CURSES)

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

#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 speciﬁed window starting at the

current or speciﬁed 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 −1. These functions are similar to calling

mbstowcs() on the ﬁrst 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 deﬁned.