Home » jBASE » jBASE BASIC (jBC) » COLLECTDATA

# COLLECTDATA

# Description

The COLLECTDATA statement is used to retrieve data passed from the PASSDATA clause of an EXECUTE statement. It takes the general form:

COLLECTDATA variable

Where:

variable is the location in which to store the retrieved data.

# Note

The COLLECTDATA statement can be used in any program, which is EXECUTEd (or PERFORMed) by another program where the calling program uses a PASSDATA clause.
The EXECUTEd program uses a COLLECTDATA statement to retrieve the passed data.
If a PASSDATA clause is not in effect, variable will be assigned a value of null.

An example of use is as:

First

EXECUTE "RUN JBASIC_PROGS SECOND" PASSDATA "Handover"

Second

COLLECTDATA PassedMessage
CRT PassedMessage

1
2

In the above example, program FIRST will EXECUTE program SECOND and will pass the string "Handover" in the PASSDATA clause. Program SECOND retrieves the string to a variable PassedMessage and prints the string on the Terminal screen.

Go back to jBASE BASIC

Go back to Programmers' Reference Guide