Blame - doc/html/man/curs_addwstr.3x.html - android_external_libncurses

Amit Daniel Kachhap

e6a01f5

2011-07-20 11:45:59 +0530

[diff] [blame]

1

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">

2

<!--

3

****************************************************************************

4

5

* *

6

* Permission is hereby granted, free of charge, to any person obtaining a *

7

* copy of this software and associated documentation files (the *

8

* "Software"), to deal in the Software without restriction, including *

9

* without limitation the rights to use, copy, modify, merge, publish, *

10

* distribute, distribute with modifications, sublicense, and/or sell *

11

* copies of the Software, and to permit persons to whom the Software is *

12

* furnished to do so, subject to the following conditions: *

13

* *

14

* The above copyright notice and this permission notice shall be included *

15

* in all copies or substantial portions of the Software. *

16

* *

17

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS *

18

* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF *

19

* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. *

20

* IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, *

21

* DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR *

22

* OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR *

23

* THE USE OR OTHER DEALINGS IN THE SOFTWARE. *

24

* *

25

* Except as contained in this notice, the name(s) of the above copyright *

26

* holders shall not be used in advertising or otherwise to promote the *

27

* sale, use or other dealings in this Software without prior written *

28

* authorization. *

29

****************************************************************************

30

* @Id: curs_addwstr.3x,v 1.7 2006/02/25 20:59:08 tom Exp @

-->

<HTML>

<HEAD>

<TITLE>curs_addwstr 3x</TITLE>

</HEAD>

<BODY>

<H1>curs_addwstr 3x</H1>

40

<HR>

41

<PRE>

42

43

<A HREF="curs_addwstr.3x.html">curs_addwstr(3x)</A> <A HREF="curs_addwstr.3x.html">curs_addwstr(3x)</A>

</PRE>

addwstr, addnwstr, waddwstr, waddnwstr, mvaddwstr,

51

mvaddnwstr, mvwaddwstr, mvwaddnwstr - add a string of wide

52

characters to a curses window and advance cursor

</PRE>

<H2>SYNOPSIS</H2><PRE>

57

#include <curses.h>

58

59

int addwstr(const wchar_t *wstr);

60

int addnwstr(const wchar_t *wstr, int n);

61

int waddwstr(WINDOW *win, const wchar_t *wstr);

62

int waddnwstr(WINDOW *win, const wchar_t *wstr, int n);

63

int mvaddwstr(int y, int x, const wchar_t *wstr);

64

int mvaddnwstr(int y, int x, const wchar_t *wstr, int n);

65

int mvwaddwstr(WINDOW *win, int y, int x, const wchar_t *wstr);

66

int mvwaddnwstr(WINDOW *win, int y, int x, const wchar_t *wstr, int n);

</PRE>

<H2>DESCRIPTION</H2><PRE>

71

These routines write the characters of the (null-terminat-

72

ed) wchar_t character string wstr on the given window. It

73

is similar to constructing a cchar_t for each wchar_t in

74

the string, then calling wadd_wch for the resulting

75

cchar_t.

76

77

The mv routines perform cursor movement once, before writ-

78

ing any characters. Thereafter, the cursor is advanced as

79

a side-effect of writing to the window.

80

81

The four routines with n as the last argument write at

82

most n wchar_t characters. If n is -1, then the entire

83

string will be added, up to the maximum number of charac-

84

ters that will fit on the line, or until a terminating

null is reached.

</PRE>

<H2>RETURN VALUES</H2><PRE>

90

All routines return the integer ERR upon failure and OK on

success.

</PRE>

<H2>NOTES</H2><PRE>

Note that all of these routines except waddnwstr may be

macros.

</PRE>

<H2>PORTABILITY</H2><PRE>

102

All these entry points are described in the XSI Curses

standard, Issue 4.

</PRE>

<A HREF="ncurses.3x.html">curses(3x)</A>, <A HREF="curs_add_wch.3x.html">curs_add_wch(3x)</A>

<A HREF="curs_addwstr.3x.html">curs_addwstr(3x)</A>

</PRE>

<HR>

Man(1) output converted with

</ADDRESS>

</BODY>

</HTML>