curs_addwstr.3x (97049) | curs_addwstr.3x (166124) |
---|---|
1.\"*************************************************************************** | 1.\"*************************************************************************** |
2.\" Copyright (c) 2002 Free Software Foundation, Inc. * | 2.\" Copyright (c) 2002-2005,2006 Free Software Foundation, Inc. * |
3.\" * 4.\" Permission is hereby granted, free of charge, to any person obtaining a * 5.\" copy of this software and associated documentation files (the * 6.\" "Software"), to deal in the Software without restriction, including * 7.\" without limitation the rights to use, copy, modify, merge, publish, * 8.\" distribute, distribute with modifications, sublicense, and/or sell * 9.\" copies of the Software, and to permit persons to whom the Software is * 10.\" furnished to do so, subject to the following conditions: * --- 10 unchanged lines hidden (view full) --- 21.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE. * 22.\" * 23.\" Except as contained in this notice, the name(s) of the above copyright * 24.\" holders shall not be used in advertising or otherwise to promote the * 25.\" sale, use or other dealings in this Software without prior written * 26.\" authorization. * 27.\"*************************************************************************** 28.\" | 3.\" * 4.\" Permission is hereby granted, free of charge, to any person obtaining a * 5.\" copy of this software and associated documentation files (the * 6.\" "Software"), to deal in the Software without restriction, including * 7.\" without limitation the rights to use, copy, modify, merge, publish, * 8.\" distribute, distribute with modifications, sublicense, and/or sell * 9.\" copies of the Software, and to permit persons to whom the Software is * 10.\" furnished to do so, subject to the following conditions: * --- 10 unchanged lines hidden (view full) --- 21.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE. * 22.\" * 23.\" Except as contained in this notice, the name(s) of the above copyright * 24.\" holders shall not be used in advertising or otherwise to promote the * 25.\" sale, use or other dealings in this Software without prior written * 26.\" authorization. * 27.\"*************************************************************************** 28.\" |
29.\" $Id: curs_addwstr.3x,v 1.2 2002/03/09 23:16:59 tom Exp $ | 29.\" $Id: curs_addwstr.3x,v 1.7 2006/02/25 20:59:08 tom Exp $ |
30.TH curs_addwstr 3X "" | 30.TH curs_addwstr 3X "" |
31.na 32.hy 0 |
|
31.SH NAME 32\fBaddwstr\fR, 33\fBaddnwstr\fR, 34\fBwaddwstr\fR, 35\fBwaddnwstr\fR, 36\fBmvaddwstr\fR, 37\fBmvaddnwstr\fR, 38\fBmvwaddwstr\fR, 39\fBmvwaddnwstr\fR \- add a string of wide characters to a \fBcurses\fR window and advance cursor | 33.SH NAME 34\fBaddwstr\fR, 35\fBaddnwstr\fR, 36\fBwaddwstr\fR, 37\fBwaddnwstr\fR, 38\fBmvaddwstr\fR, 39\fBmvaddnwstr\fR, 40\fBmvwaddwstr\fR, 41\fBmvwaddnwstr\fR \- add a string of wide characters to a \fBcurses\fR window and advance cursor |
42.ad 43.hy |
|
40.SH SYNOPSIS 41.nf 42\fB#include <curses.h>\fR | 44.SH SYNOPSIS 45.nf 46\fB#include <curses.h>\fR |
43 | 47.PP |
44\fBint addwstr(const wchar_t *\fR\fIwstr\fR\fB);\fR 45.br 46\fBint addnwstr(const wchar_t *\fR\fIwstr\fR\fB, int \fR\fIn\fR\fB);\fR 47.br 48\fBint waddwstr(WINDOW *\fR\fIwin\fR\fB, const wchar_t *\fR\fIwstr\fR\fB);\fR 49.br 50\fBint waddnwstr(WINDOW *\fR\fIwin\fR\fB, const wchar_t *\fR\fIwstr\fR\fB, int \fR\fIn\fR\fB);\fR 51.br 52\fBint mvaddwstr(int \fR\fIy\fR\fB, int \fR\fIx\fR\fB, const wchar_t *\fR\fIwstr\fR\fB);\fR 53.br 54\fBint mvaddnwstr(int \fR\fIy\fR\fB, int \fR\fIx\fR\fB, const wchar_t *\fR\fIwstr\fR\fB, int \fR\fIn\fR\fB);\fR 55.br 56\fBint mvwaddwstr(WINDOW *\fR\fIwin\fR\fB, int \fR\fIy\fR\fB, int \fR\fIx\fR\fB, const wchar_t *\fR\fIwstr\fR\fB);\fR 57.br 58\fBint mvwaddnwstr(WINDOW *\fR\fIwin\fR\fB, int \fR\fIy\fR\fB, int \fR\fIx\fR\fB, const wchar_t *\fR\fIwstr\fR\fB, int \fR\fIn\fR\fB);\fR 59.fi 60.SH DESCRIPTION | 48\fBint addwstr(const wchar_t *\fR\fIwstr\fR\fB);\fR 49.br 50\fBint addnwstr(const wchar_t *\fR\fIwstr\fR\fB, int \fR\fIn\fR\fB);\fR 51.br 52\fBint waddwstr(WINDOW *\fR\fIwin\fR\fB, const wchar_t *\fR\fIwstr\fR\fB);\fR 53.br 54\fBint waddnwstr(WINDOW *\fR\fIwin\fR\fB, const wchar_t *\fR\fIwstr\fR\fB, int \fR\fIn\fR\fB);\fR 55.br 56\fBint mvaddwstr(int \fR\fIy\fR\fB, int \fR\fIx\fR\fB, const wchar_t *\fR\fIwstr\fR\fB);\fR 57.br 58\fBint mvaddnwstr(int \fR\fIy\fR\fB, int \fR\fIx\fR\fB, const wchar_t *\fR\fIwstr\fR\fB, int \fR\fIn\fR\fB);\fR 59.br 60\fBint mvwaddwstr(WINDOW *\fR\fIwin\fR\fB, int \fR\fIy\fR\fB, int \fR\fIx\fR\fB, const wchar_t *\fR\fIwstr\fR\fB);\fR 61.br 62\fBint mvwaddnwstr(WINDOW *\fR\fIwin\fR\fB, int \fR\fIy\fR\fB, int \fR\fIx\fR\fB, const wchar_t *\fR\fIwstr\fR\fB, int \fR\fIn\fR\fB);\fR 63.fi 64.SH DESCRIPTION |
61These routines write the characters of the (null-terminated) \fBwchar_t\fRcharacter string | 65These routines write the characters of the 66(null-terminated) \fBwchar_t\fR character string |
62\fIwstr\fR on the given window. 63It is similar to constructing a \fBcchar_t\fR for each wchar_t in the string, 64then calling \fBwadd_wch\fR for the resulting \fBcchar_t\fR. 65.PP 66The \fImv\fR routines perform cursor movement once, before writing any 67characters. 68Thereafter, the cursor is advanced as a side-effect of writing to the window. 69.PP --- 4 unchanged lines hidden (view full) --- 74or until a terminating null is reached. 75.SH RETURN VALUES 76All routines return the integer \fBERR\fR upon failure and \fBOK\fR on success. 77.SH NOTES 78Note that all of these routines except \fBwaddnwstr\fR may be macros. 79.SH PORTABILITY 80All these entry points are described in the XSI Curses standard, Issue 4. 81.SH SEE ALSO | 67\fIwstr\fR on the given window. 68It is similar to constructing a \fBcchar_t\fR for each wchar_t in the string, 69then calling \fBwadd_wch\fR for the resulting \fBcchar_t\fR. 70.PP 71The \fImv\fR routines perform cursor movement once, before writing any 72characters. 73Thereafter, the cursor is advanced as a side-effect of writing to the window. 74.PP --- 4 unchanged lines hidden (view full) --- 79or until a terminating null is reached. 80.SH RETURN VALUES 81All routines return the integer \fBERR\fR upon failure and \fBOK\fR on success. 82.SH NOTES 83Note that all of these routines except \fBwaddnwstr\fR may be macros. 84.SH PORTABILITY 85All these entry points are described in the XSI Curses standard, Issue 4. 86.SH SEE ALSO |
82.PP 83Functions: | |
84\fBcurses\fR(3X), 85\fBcurs_add_wch\fR(3X) 86.\"# 87.\"# The following sets edit modes for GNU EMACS 88.\"# Local Variables: 89.\"# mode:nroff 90.\"# fill-column:79 91.\"# End: | 87\fBcurses\fR(3X), 88\fBcurs_add_wch\fR(3X) 89.\"# 90.\"# The following sets edit modes for GNU EMACS 91.\"# Local Variables: 92.\"# mode:nroff 93.\"# fill-column:79 94.\"# End: |