Welcome to Adams/Solver Subroutines - Kxcad.net

52
Adams/Solver
GTARAY returns the double-precision numbers stored by an IC-type ARRAY statement (C++ or
FORTRAN).
Use
Called By
Any user-written subroutine
Prerequisite
ARRAY statement in dataset
Calling Sequence
CALL GTARAY (id, array, number, istat)
Input Argument
id An integer variable that specifies the ID of the ARRAY statement.
Output Arguments
array A double-precision array containing the data defined in the ARRAY
statement statement.
istat An integer that indicates the success or the reason for the failure of the
call to GTARAY.
number A variable that indicates the number of values returned in the array.
GTCMAT
If: Then:
istat = 0 The call to GTARAY was successful.
istat = -1 ARRAY/id is not an IC-type.
istat = -2 Adams/Solver could not find an ARRAY statement
with the identifier indicated in id.
Caution: • Make sure that array is large enough to hold all of the returned values.
• You can only use GTARAY to access values for an IC-type ARRAY (the default
type). If you want to access values for an X-type, a Y-type, or a U-type ARRAY,
use SYSARY and the ARRAY function, or SYSFNC and the C++ ARYVAL
function or the FORTRAN ARYVAL function.