Adams Basic Package > Adams Solver > Welcome to Adams Solver Subroutines > Utility Subroutines > GTSTRG

GTSTRG

GTSTRG returns the character string stored in a STRING statement.

Use

Called By

Any user-written subroutine

Prerequisite

STRING statement in dataset

Calling Sequence

CALL GTSTRG (id, string, nchars, istat)

Input Argument

 
id
An integer variable that specifies the ID of the STRING statement.

Output Arguments

 
istat
An integer that indicates the success or failure of the call to GTSTRG.
nchars
The number of characters in the returned string. Trailing blank spaces are ignored.
string
The requested string.
 
Caution:  
■Make sure that string is long enough to hold all of the string.
■The string is left-justified (that is, Adams Solver deletes all blank spaces to the left of the string).