MACROMEDIA FLASH 8-FLASH LITE 2.X ACTIONSCRIPT LANGUAGE Reference page 590

Returns
- A Boolean value,
Object
method returns
pending
If there is no need to write data (that is, the data has already been written),
■
returns .
true
If the
minimumDiskSpace
■
or the remaining space available for a SWF file, or if there was an error processing the
request,
flush()
If the method returns
flush()
the user to free up space to increase the amount of disk space available to shared objects. To
allow space for the shared object to expand when it is saved in the future, which avoids return
values of , you can pass a value for
pending
tries to write the file, it searches for the number of bytes passed to
instead of searching for enough space to save the shared object at its current size.
Example
The following example handles the possible return values for the
so_big = SharedObject.getLocal("large");
so_big.data.name = "This is a long string of text.";
so_big.flush();
var flushResult = so_big.flush();
switch (flushResult) {
case 'pending' :
result.text += "pending";
break;
case true :
result.text += "Data was flushed.";
break;
case false :
result.text += "Test failed. Data was not flushed.";
break;
}
See also
clear (SharedObject.clear method)
590 ActionScript classes
or ; or a string value of
true false
for most requests, with the following exceptions:
parameter exceeds the maximum space available for a SWF file,
returns .
false
, the Flash Lite player can show a dialog box asking
pending
,
"pending"
minimumDiskSpace
onStatus (SharedObject.onStatus handler)
. The
flush()
flush()
. When the Flash Lite player
minimumDiskSpace
method:
flush()
,