[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Base Operating System and Extensions Technical Reference, Volume 2

garbagedlines Subroutine

Purpose

Discards and replaces a number of lines in a window.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>
garbagedlines(Window, BegLine, NumLines)
WINDOW *Window;
int BegLine, NumLines;

Description

The garbagedlines subroutine discards and replaces lines in a window. The Begline parameter specifies the beginning line number and the Numlines parameter specifies the number of lines to discard. Curses discards and replaces the specified lines before adding more data.

Uses this subroutine for applications that need to redraw a line that is garbled. Lines may become garbled as the result of noisy communication lines. Instead of refreshing the entire display, use the garbagedlines subroutine to refresh a portion of the display and to avoid even more communication noise.

Parameters

Window Points to a window.
BegLine Identifies the beginning line in a range of lines to discard.
NumLines Specifies the total number of lines in a range of lines to discard and replace.

Examples

To discard and replace 5 lines in the mywin window starting with line 10, use:

WINDOW *mywin; garbagedlines(mywin, 10, 5);

Implementation Specifics

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

Related Information

Curses Overview for Programming in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

List of Curses Subroutines in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

Manipulating Window Data with Curses in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.


[ Previous | Next | Contents | Glossary | Home | Search ]