| SimCon Home | Reference Manual Home |

VALUE

Syntax:

!% VALUE [:] [:] <symbol> [ , <symbol> ... ]

Function:

Specifies that the named sub-program arguments are passed by value. FPT uses this information in the argument consistency check (please see CHECK ARGUMENTS). This command is usually used to specify the argument passing protocol to external routines written in C, C++ or another language. The alternative protocol specifications for arguments are:

!% VALUE

!% REFERENCE

!% DESCRIPTOR

!% STRING

Names which contain exotic characters such as '%', ':' or '#' (which are all legal on some systems) must be written as quoted strings.

The %VALUE command must be written in code within the scope of declaration of the variable. It is introduced by a comment delimiter in column 1 and the character % in column 2.

Where to use this command:

Operating system command line	No
Configuration file, config.fsp	No
Specification (FSP) files, *.fsp	No
Interactively, to FPT> prompt:	No
Interactive command files	No
Embedded in the Fortran code	Yes

Default:

By reference for numeric arguments, and as specified by the commands:

% PASS STRING ARGUMENTS. . . for arguments of type character.

Example:

SUBROUTINE HSD_OUT(ARR,ICOUNT) REAL*4 ARR(*) ! Output data INTEGER*4 ICOUNT ! Number of elements !% VALUE :: ICOUNT

See also:

CHECK ARGUMENTS

PASS STRING ARGUMENTS