Oracle Solaris 9 - man pages section 3: Curses Library Functions

需积分: 5 5 浏览量更新于2023-11-23 收藏 1.47MB PDF 举报

Oracle Solaris 9是Sun Microsystems, Inc.于2004年4月发布的操作系统。其中包括了一系列的man pages文档，其中包括了第3部分：Curses库函数。这些函数旨在提供与终端屏幕文本图形界面交互的功能，以及在用户界面设计中实现图形用户界面。这些Curses库函数有助于管理屏幕输出和输入，提供对终端输入/输出的控制，以及实现基本的文本界面用户交互功能。其中一些函数还可以用来创建和管理窗口，以及进行基本的文本属性控制。在处理Curses库函数时，用户应该留意Sun Microsystems, Inc.所持有的版权。这些函数的使用受到版权保护，未经Sun及其许可方的书面授权，任何形式的复制、分发和反编译均被禁止。此外，一些第三方软件也可能受到版权保护，并从Sun供应商处获得许可。最后，Curses库函数也可能包含自伯克利BSD系统授权的部分代码。同时，UNIX是美国和其他国家/地区的注册商标，因此在使用这些Curses库函数时，用户需要遵守相关的法律法规。

16 man pages section 3: Curses Library Functions • April 2004

addch, mvaddch, mvwaddch, waddch – add a character (with rendition) to a window

cc [ ﬂag... ] ﬁle... -I /usr/xpg4/include -L /usr/xpg4/lib \

-R /usr/xpg4/lib -lcurses [ library... ]

c89 [ ﬂag... ] ﬁle... -lcurses [ library ... ]

#include <curses.h>

int addch(const chtype ch);

int mvaddch(int y, int x, const chtype ch);

int mvwaddch(WINDOW *win, int y, int x, const chtype ch);

int waddch(WINDOW *win, const chtype ch);

The addch() function writes a character to the stdscr window at the current cursor

position. The mvaddch() and mvwaddch() functions write the character to the

position indicated by the x (column) and y (row) parameters. The mvaddch()

function writes the character to the stdscr window, while mvwaddch() writes the

character to the window speciﬁed by win. The waddch() function is identical to

addch(), but writes the character to the window speciﬁed by win.

These functions advance the cursor after writing the character. Characters that do not

ﬁt on the end of the current line are wrapped to the beginning of the next line unless

the current line is the last line of the window and scrolling is disabled. In that

situation, characters which extend beyond the end of the line are discarded.

When ch is a backspace, carriage return, newline, or tab, X/Open Curses moves the

cursor appropriately. Each tab character moves the cursor to the next tab stop. By

default, tab stops occur every eight columns. When ch is a control character other than

backspace, carriage return, newline, or tab, it is written using ^x notation, where x is a

printable character. When X/Open Curses writes ch to the last character position on a

line, it automatically generates a newline. When ch is written to the last character

position of a scrolling region and scrollok() is enabled, X/Open Curses scrolls the

scrolling region up one line (see clearok(3XCURSES)).

wchstr Is a pointer to the cchar_t string to be copied to the window.

n Is the maximum number of characters to be copied from wchstr.If

n is less than 0, the entire string is written or as much of it as ﬁts

on the line.

y Is the y (row) coordinate of the starting position of wchstr in the

window.

x Is the x (column) coordinate of the starting position of wchstr in the

window.

win Is a pointer to the window to which the string is to be copied.

On success, these functions return OK. Otherwise, they return ERR.

addch(3XCURSES)

NAME

SYNOPSIS

DESCRIPTION

PARAMETERS

RETURN VALUES

18 man pages section 3: Curses Library Functions • Last Revised 5 Jun 2002

addchstr, addchnstr, mvaddchstr, mvaddchnstr, mvwaddchnstr, mvwaddchstr,

waddchstr, waddchnstr – copy a character string (with renditions) to a window

cc [ ﬂag... ] ﬁle... -I /usr/xpg4/include -L /usr/xpg4/lib \

-R /usr/xpg4/lib -lcurses [ library... ]

c89 [ ﬂag... ] ﬁle... -lcurses [ library ... ]

#include <curses.h>

int addchstr(const chtype *chstr);

int addchnstr(const chtype *chstr, int n);

int mvaddchnstr(int y, int x, const chtype *chstr, int n);

int mvaddchstr(int y, int x, const chtype *chstr);

int mvwaddchnstr(WINDOW *win, int y, int x, const chtype *chstr, int

n);

int mvwaddchstr(WINDOW *win, int y, int x, const chtype *chstr);

int waddchstr(WINDOW *win, const chtype *chstr);

int waddchnstr(WINDOW *win, const chtype *chstr, int n);

The addchstr() function copies the chtype character string to the stdscr window

at the current cursor position. The mvaddchstr() and mvwaddchstr() functions

copy the character string to the starting position indicated by the x (column) and y

(row) parameters (the former to the stdscr window; the latter to window win). The

waddchstr() is identical to addchstr(), but writes to the window speciﬁed by win.

The addchnstr(), waddchnstr(), mvaddchnstr(), and mvwaddchnstr()

functions write n characters to the window, or as many as will ﬁt on the line. If n is

less than 0, the entire string is written, or as much of it as ﬁts on the line. The former

two functions place the string at the current cursor position; the latter two commands

use the position speciﬁed by the x and y parameters.

These functions differ from the addstr(3XCURSES) set of functions in two important

respects. First, these functions do not advance the cursor after writing the string to the

window. Second, the current window rendition is not combined with the character;

only the attributes that are already part of the chtype character are used.

chstr Is a pointer to the chtype string to be copied to the window.

n Is the maximum number of characters to be copied from chstr.Ifn is less

than 0, the entire string is written or as much of it as ﬁts on the line.

y Is the y (row) coordinate of the starting position of chstr in the window.

x Is the x (column) coordinate of the starting position of chstr in the window.

win Is a pointer to the window to which the string is to be copied.

On success, these functions return OK. Otherwise, they return ERR.

addchstr(3XCURSES)

NAME

SYNOPSIS

DESCRIPTION

PARAMETERS

RETURN VALUES

20 man pages section 3: Curses Library Functions • Last Revised 5 Jun 2002

剩余405页未读，继续阅读

weixin_40191861_zj

粉丝: 83
资源: 1万+

Oracle Solaris 9 - man pages section 3: Curses Library Functions

Oracle Solaris 9 -man pages section 3: Curses Library Functions-

817-3940.pdf Oracle Solaris 9 - man pages section 3: Curses Libr

Oracle Solaris 8 man pages section 3: Curses Library Functions-

Oracle Solaris 11.1 man pages section3:Curses Library Functions

Oracle Solaris 10 man pages section3:Curses Library Functions-37

Oracle Solaris 11 man pages section3:Curses Library Functions-37

817-0693-pdfOracle Solaris 9 - man pages section 3: Curses Libra

Oracle Solaris 9 Curses Library Functions Manual

Oracle Solaris 9：Curses库函数手册（Section 3）

Oracle Solaris 9 Curses Library 函数手册

最新资源