83Plus:Software:usb8x/BASIC Interface/ExportVariable - Revision history

JoostinOnline: Fixed both MSDInit links

2009-11-09T23:26:41Z

Fixed both MSDInit links

Brandonw at 16:09, 18 August 2006

2006-08-18T16:09:13Z

Brandonw at 21:25, 17 August 2006

2006-08-17T21:25:48Z

Brandonw at 21:25, 17 August 2006

2006-08-17T21:25:09Z

Brandonw at 21:23, 17 August 2006

2006-08-17T21:23:46Z

New page

== 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:
<code>
"/FOLDER1/FOLDER2/GAME.8XP"
</code>
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:
<code>
"[A]:/"
</code>
The "<code>[A]</code>" was selected from the [2nd]+[MATRX] menu.

To send prgmGAME to the "test" directory, use the following for the string:
<code>
"prgmGAME:/test"
</code>

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:
<code>
"ABC:/"
</code>

== Example ==
The following code will export ZTETRIS to the root directory:
<code>
OpenLib(USBDRV8X
{7
ExecLib ;initialize mass storage driver
"prgmZTETRIS:/->Str1
{9,1
ExecLib ;export variable in Str1
</code>

== See Also ==
[[../MSDInit|MSDInit]] - Initialize the mass storage driver

@@ Line 15: / Line 15: @@
 == Notes ==
-Be sure to initialize the mass storage driver with [[../MSDInit|MSDInit]] before calling this entry point.
+Be sure to initialize the mass storage driver with [[83Plus:Software:usb8x/BASIC_Interface/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.
@@ Line 54: / Line 54: @@
 == See Also ==
-[[../MSDInit|MSDInit]] - Initialize the mass storage driver
+[[83Plus:Software:usb8x/BASIC_Interface/MSDInit|MSDInit]] - Initialize the mass storage driver

@@ Line 32: / Line 32: @@
 To send prgmGAME to the "test" directory, use the following for the string:
 <code>
-  "prgmGAME:/test"
+  "prgmGAME:/TEST"
 </code>
@@ Line 39: / Line 39: @@
   "ABC:/"
 </code>
 == Example ==

@@ Line 19: / Line 19: @@
 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:
+You have your choice of Str1-Str0 to use with this function. Pass this number as the second element in Ans.
 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.