tparm Subroutine

Base Operating System and Extensions Technical Reference, Volume 2

tparm Subroutine

Purpose

Applies parameters (padding) to a terminal capability.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>

char *tparm(TermCap, Parm1, Parm2, . . . Parm9)
char *TermCap;
int  Parm1, Parm2, . . . Parm9;

Description

The tparm subroutine applies parameters (padding) to a terminal capability.

Note: If the tparm subroutine is called with less than 10 paramameters, then the -D_TPARM_COMPAT option should be used when compiling the program. Otherwise the compiler gives the following error.
1506-098 (E) Missing argument(s)

Parameters

Parm#	Specifies the parameters (up to nine) to instantiate.
TermCap	Specifies the terminal capability to apply the parameters to. These terminal capabilities are defined in the term.h file.

Return Values

The tparm subroutine returns the escape sequence specified by the TermCap parameter with the specified parameters applied. After the escape sequence is received, it can be output by a subroutine like the tputs subroutine.

Examples

To save the escape sequence used to home the cursor in the user-defined variable home_sequence, enter:
```
home_sequence = tparm(cursor_home);
```
To save the escape sequence used to move the cursor to the coordinates X=40, Y=18 in the user-defined variable move_sequence, enter:
```
move_sequence = tparm(cursor_address, 18, 40);
```

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.

Understanding Terminals with Curses in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.