attroff(3X)

NAME

attroff, attron, attrset, wattroff, wattron, wattrset — restricted window attribute control functions

SYNOPSIS

#include <curses.h>

int attroff(int attrs);

int attron(int attrs);

int attrset(int attrs);

int wattroff(WINDOW *win, int attrs);

int wattron(WINDOW *win, int attrs);

int wattrset(WINDOW *win, int attrs);

DESCRIPTION

These functions manipulate the window attributes of the current or specified window.

The attroff() and wattroff() functions turn off attrs in the current or specified window without affecting any others.

The attron() and wattron() functions turn on attrs in the current or specified window without affecting any others.

The attrset() and wattrset() functions set the background attributes of the current or specified window to attrs.

It is unspecified whether these functions can be used to manipulate attributes other than A_BLINK, A_BOLD, A_DIM, A_REVERSE, A_STANDOUT and A_UNDERLINE.

RETURN VALUE

These functions always return either OK or 1.

ERRORS

No errors are defined.

CHANGE HISTORY

First released in X/Open Curses, Issue 2.

X/Open Curses, Issue 4

This entry is rewritten for clarity. The DESCRIPTION is updated to specify that it is undefined whether these functions can be used to manipulate attributes beyond those defined in X/Open Curses, Issue 3. The standend(), standout(), wstandend() and wstandout() functions are moved to the standend() entry.

attroff(3X)

Technical documentation

» Table of Contents

» Index