Technical Reference: Base Operating System and Extensions , Volume 2

tparm Subroutine

Purpose

Applies parameters (padding) to a terminal capability.

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.

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 (tputs Subroutine) 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 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.

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

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