<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
<!--
****************************************************************************
- * Copyright (c) 1998,2000 Free Software Foundation, Inc. *
+ * Copyright (c) 1998-2003,2005 Free Software Foundation, Inc. *
* *
* Permission is hereby granted, free of charge, to any person obtaining a *
* copy of this software and associated documentation files (the *
* sale, use or other dealings in this Software without prior written *
* authorization. *
****************************************************************************
- * @Id: curs_addstr.3x,v 1.10 2002/03/09 23:09:29 tom Exp @
+ * @Id: curs_addstr.3x,v 1.13 2005/05/15 16:17:14 tom Exp @
-->
<HTML>
<HEAD>
<HR>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
+<STRONG><A HREF="curs_addstr.3x.html">curs_addstr(3x)</A></STRONG> <STRONG><A HREF="curs_addstr.3x.html">curs_addstr(3x)</A></STRONG>
+
+
+
</PRE>
<H2>NAME</H2><PRE>
- <STRONG>addstr</STRONG>, <STRONG>addnstr</STRONG>, <STRONG>waddstr</STRONG>, <STRONG>waddnstr</STRONG>, <STRONG>mvaddstr</STRONG>, <STRONG>mvaddnstr</STRONG>,
- <STRONG>mvwaddstr</STRONG>, <STRONG>mvwaddnstr</STRONG> - add a string of characters to a
+ <STRONG>addstr</STRONG>, <STRONG>addnstr</STRONG>, <STRONG>waddstr</STRONG>, <STRONG>waddnstr</STRONG>, <STRONG>mvaddstr</STRONG>, <STRONG>mvaddnstr</STRONG>,
+ <STRONG>mvwaddstr</STRONG>, <STRONG>mvwaddnstr</STRONG> - add a string of characters to a
<STRONG>curses</STRONG> window and advance cursor
</PRE>
<H2>DESCRIPTION</H2><PRE>
- These routines write the characters of the (null-termi-
- nated) character string <EM>str</EM> on the given window. It is
- similar to calling <STRONG>waddch</STRONG> once for each character in the
+ These routines write the characters of the (null-terminat-
+ ed) character string <EM>str</EM> on the given window. It is simi-
+ lar to calling <STRONG>waddch</STRONG> once for each character in the
string. The four routines with <EM>n</EM> as the last argument
write at most <EM>n</EM> characters. If <EM>n</EM> is -1, then the entire
string will be added, up to the maximum number of charac-
success (the SVr4 manuals specify only "an integer value
other than <STRONG>ERR</STRONG>") upon successful completion.
+ X/Open does not define any error conditions. This imple-
+ mentation returns an error if the window pointer is null
+ or if the string pointer is null or if the corresponding
+ calls to <STRONG>waddch</STRONG> return an error.
+
</PRE>
<H2>NOTES</H2><PRE>
</PRE>
<H2>PORTABILITY</H2><PRE>
- All these entry points are described in the XSI Curses
- standard, Issue 4. The XSI errors EILSEQ and EOVERFLOW,
- associated with extended-level conformance, are not yet
+ All these entry points are described in the XSI Curses
+ standard, Issue 4. The XSI errors EILSEQ and EOVERFLOW,
+ associated with extended-level conformance, are not yet
detected.
-
-
-
-
-
-
-
+ <STRONG><A HREF="curs_addstr.3x.html">curs_addstr(3x)</A></STRONG>
</PRE>
<HR>
<ADDRESS>