Difference between revisions of "83Plus:Software:usb8x/BASIC Interface/ExportVariable"
| Line 20: | Line 20: | ||
You have your choice of Str1-Str0 to use with this function. Pass this number as the second element in Ans. The string is formatted as follows: | You have your choice of Str1-Str0 to use with this function. Pass this number as the second element in Ans. The string is formatted as follows: | ||
| − | + | ||
| − | + | ||
| − | + | ||
The variable to export starts the string. It is the ''token'' for the variable you want to transfer. This means you must select this variable from a menu instead of typing it yourself (for example, selecting "Str9" from the VARS menu, ''not'' typing 'S', 't', 'r', '9'). A colon follows this, and finally the path to export the variable to. | The variable to export starts the string. It is the ''token'' for the variable you want to transfer. This means you must select this variable from a menu instead of typing it yourself (for example, selecting "Str9" from the VARS menu, ''not'' typing 'S', 't', 'r', '9'). A colon follows this, and finally the path to export the variable to. | ||
Revision as of 13:25, 17 August 2006
Synopsis
Name: ExportVariable
Function Number: 9
Minimum usb8x version: 0.10
Exports variable from RAM or Flash to specified directory as *.8x* file.
Inputs
- 2: String variable to use (Str1-0)
Outputs
- 1: Error code (0 = success)
Notes
Be sure to initialize the mass storage driver with [[../MSDInit|MSDInit]] before calling this entry point.
This entry point will fail if a *.8x* file of the same name is already in the specified directory.
You have your choice of Str1-Str0 to use with this function. Pass this number as the second element in Ans. The string is formatted as follows:
The variable to export starts the string. It is the token for the variable you want to transfer. This means you must select this variable from a menu instead of typing it yourself (for example, selecting "Str9" from the VARS menu, not typing 'S', 't', 'r', '9'). A colon follows this, and finally the path to export the variable to.
For example, to send matrix A to the root directory, use the following for the string:
"[A]:/"
The "[A]" was selected from the [2nd]+[MATRX] menu.
To send prgmGAME to the "test" directory, use the following for the string:
"prgmGAME:/test"
To send a REAL variable or AppVar, simply enter the string. If a REAL variable and AppVar have the same name, it will send the REAL variable. To send AppVar ABC to the root directory:
"ABC:/"
Example
The following code will export ZTETRIS to the root directory:
OpenLib(USBDRV8X
{7
ExecLib ;initialize mass storage driver
"prgmZTETRIS:/->Str1
{9,1
ExecLib ;export variable in Str1
See Also
[[../MSDInit|MSDInit]] - Initialize the mass storage driver
