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)