clrtoeol or wclrtoeol Subroutine

AIX Version 4.3 Base Operating System and Extensions Technical Reference, Volume 2

clrtoeol or wclrtoeol Subroutine

Purpose

Erases the current line from the logical cursor position to the end of the line.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>

int clrtoeol(void);

int wclrtoeol(WINDOW *win);

Description

The clrtoeol and wclrtoeol subroutines erase the current line from the cursor to the end of the line, inclusive, in the current or specified window. These subroutines do not update the cursor.

Parameters

*win	Specifies the window in which to clear the line.

Return Values

Upon successful completion, these subroutines return OK. Otherwise, they return ERR.

Examples

To clear the line to the right of the logical cursor in the stdscr, enter:
```
clrtoeol();
```
To clear the line to the right of the logical cursor in the user-defined window my_window, enter:
```
WINDOW *my_window;
wclrtoeol(my_window);
```

Implementation Specifics

These subroutines are part of Base Operating System (BOS) Runtime.

Related Information

The doupdate subroutine.

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 Characters with Curses in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.