Content-type: text/html Man page of curs_addstr

curs_addstr

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

curs_addstr, addstr, addnstr, waddstr, waddnstr, mvaddstr, mvaddnstr, mvwaddstr, mvwaddnstr - Add a string of characters to a Curses window and advance cursor  

SYNOPSIS

#include <curses.h>

int addstr( const char *str ); int addnstr( const char *str, int n ); int waddstr( WINDOW *win, const char *str ); int waddnstr( WINDOW *win, const char *str, int n ); int mvaddstr( int y, int x, const char *str ); int mvaddnstr( int y, int x, const char *str, int n ); int mvwaddstr( WINDOW *win, int y, int x, const char *str ); int mvwaddnstr( WINDOW *win, int y, int x, const char *str, int n );
 

LIBRARY

Curses Library (libcurses)
 

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

addstr, waddstr, waddnstr, mvaddstr, mvaddnstr, mvwaddstr, mvwaddnstr:  XPG4-UNIX

Refer to the standards(5) reference page for more information about industry standards and associated tags.
 

DESCRIPTION

These routines write the characters of the character string str on the given window. The four routines with n as the last argument write at most n characters. For the other routines, the string should be null-terminated.

The effect of these functions is similar to calling waddch once for each character in the string. If n is negative, all routines add the entire string.
 

NOTES

The header file <curses.h> automatically includes the header file <stdio.h>.

Note that all of these routines except waddnstr may be macros.
 

RETURN VALUES

All routines return the integer ERR upon failure and OK upon successful completion.
 

SEE ALSO

Functions: curses(3), curs_addch(3)

Others: standards(5)


 

Index

NAME
SYNOPSIS
LIBRARY
STANDARDS
DESCRIPTION
NOTES
RETURN VALUES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:42:01 GMT, October 02, 2010