Index for Section 3

Alphabetical listing for C

Bottom of page

curs_addstr(3)
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: XCURSES4.2

  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 for Section 3

Alphabetical listing for C

Top of page