Technical Reference: Base Operating System and Extensions , Volume 2

filter Subroutine

Purpose

Disables use of certain terminal capabilities.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>

void filter(void);

Description

The filter subroutine changes the algorithm for initialising terminal capabilities that assume that the terminal has more than one line. A subsequent call to the initscr or newterm subroutine performs the following actions:

• Disables use of clear, cud, cud1, cup, cuu1, and vpa.
• Sets the value of the home string to the value of the cr. string.
• Sets lines equal to 1.

Any call to the filter subroutine must precede the call to the initscr or newterm subroutine.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The initscr (initscr and newterm Subroutine) subroutine, newterm (newterm Subroutine) subroutine.

Curses Overview for Programming and List of Curses Subroutines in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.