vidputs vidattr

The vidputs and vidattr routines are used to display a string with video attributes (interface to terminfo).

Syntax

   #include <curses.h>



   int vidputs (chtype attrs, int (*putc) (int));

   int vidattr (chtype attrs);

Parameters

attrs: The attributes of the foreground window.
putc: The output function.

Return Values

OK: Successful completion.
ERR: An error occurred.

Description

The vidputs() and vidattr() routines are low-level routines used outside of CURSES to deal directly with the terminfo database. The use of appropriate CURSES routines is recommended for most situations.

The vidputs() routine enables and disables attributes for the current terminal. The attributes shown in Table 4-8 “Constant Values for Highlighting Attributes” are defined in curses.h and can be combined with the bitwise OR operator.

Table 4-8 Constant Values for Highlighting Attributes

Constant	Description
`A_ALTCHARSET`	Alternate character set
`A_ATTRIBUTES`	Attribute mask
`A_BLINK`	Blinking
`A_BOLD`	Bold
`A_CHARTEXT`	Character mask
`A_COLOR`	Color mask
`A_DIM`	Dim
`A_INVIS`	Invisible
`A_NORMAL`	Disable attributes
`A_PROTECT`	No display
`A_REVERSE`	Reverse video
`A_STANDOUT`	Highlights specific to terminal
`A_UNDERLINE`	Underline
`COLOR_PAIR`(`n`)	Color-pair number `n`
`PAIR_NUMBER`(`a`)	Pair number for `COLOR_PAIR`(`n`)

The characters are passed one at a time to the putc routine, a routine similar to putchar().

The vidattr() routine is similar to vidputs() except characters are sent to stdout instead of a user-supplied output function.

Implementation Considerations

UNIX System V implementation

Portability

HP-UX, UNIX System V