hline(3curses)
hline --
draw lines from single-byte characters and renditions
Synopsis
cc [options] file -lcurses
#include <curses.h>
int hline(chtype ch, int n);
int mvhline(int y, int x, chtype ch, int n);
int mvvline(int y, int x, chtype ch, int n);
int mvwhline(WINDOW *win, int y, int x, chtype ch, int n);
int mvwvline(WINDOW *win, int y, int x, chtype ch, int n);
int vline(chtype ch, int n);
int whline(WINDOW *win, chtype ch, int n);
int wvline(WINDOW *win, chtype ch, int n);
Description
These functions draw a line in the current or specified window starting at the
current or specified position, using ch. The line is at most n
positions long, or as many as fit into the window.
These functions do not advance the cursor position.
These functions do not perform special character processing.
These functions do not perform wrapping.
The
hline(3curses),
mvhline(3curses),
mvwhline(3curses)
and
whline(3curses)
functions draw a line proceeding toward the last column of the same line.
The
vline(3curses),
mvvline(3curses),
mvwvline(3curses)
and
wvline(3curses)
functions draw a line proceeding toward the last line of the window.
Return value
Upon successful completion, these functions return OK.
Otherwise, they return ERR.
Errors
No errors are defined.
Usage
These functions are only guaranteed to operate reliably on character sets in
which each character fits into a single byte, whose attributes can be
expressed using only constants with the A_ prefix.
Standards Conformance
The Single UNIX Specification, Version 2; The Open Group.
References
border(3curses),
box(3curses),
hline_set(3curses),
curses(4)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004