SAVE VARIABLES
SAVE VARIABLES ( document ; variable {; variable2 ; ... ; variableN} )
| Parameter | Type | Description | |
|---|---|---|---|
| document | Text | → | Document in which to save the variables |
| variable | Variable | → | Variables to save |
Description
The SAVE VARIABLES command saves one or more variables in the document whose name you pass in document.
The variables do not need to be of the same type, but must be of the String, Text, Real, Integer, Long Integer, Date, Time, Boolean, or Picture type.
If you pass an empty string for document, the standard Save File dialog box appears; the user can then choose the document to create. In this case, the 4D system variable Document is set to the name of the document if one is created.
If the variables are properly saved, the OK variable is set to 1. If not, OK is set to 0.
Note: When you write variables to documents with SAVE VARIABLES, 4D uses an internal data format. You can retrieve the variables only with the LOAD VARIABLES command. Do not use RECEIVE PACKET or RECEIVE VARIABLE to read a document created by SAVE VARIABLES.
WARNING: This command does not support array variables. Use the new BLOB commands instead.
Example
The following example saves three variables to a document named UserPrefs:
SAVE VARIABLES("User Prefs";vsName;vlCode;vgIconPicture)
System variables and sets
If the variables are saved properly, the OK system variable is set to 1; otherwise it is set to 0.
See also
BLOB TO DOCUMENT
BLOB TO VARIABLE
DOCUMENT TO BLOB
LOAD VARIABLES
System Variables
VARIABLE TO BLOB
Properties
| Command number | 75 |
| Thread safe | ✓ |
| Modifies variables | OK, Document |