SysCacheExternalStorage (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Functions for Windows management

System functions

SysCacheExternalStorage

Presentation

Example

Managing the external cache directory of application

Tips for using the external cache directory of application

See also

SysAndroidVersion

SysCacheExternalStorage

SysChangeEnvironment

SysChangeScreenResolution

SysColor

SysColorRes

SysDetectLockedSession

SysDeviceInfo

SysDir

SysDirExternalStorage

SysIconDisplayTooltip

SysListScreenOrientation

SysListScreenResolution

SysListVideoCard

SysMemoryExternalStorage

SysRemovableExternalStorage

SysStatusExternalStorage

SysStatusStorageCard

SysTheme

SysThumbnailAddButton

SysThumbnailDeleteAll

SysThumbnailDeleteButton

SysThumbnailModifyButton

Managing the external cache directory of application
Tips for using the external cache directory of application

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

SysCacheExternalStorage (Function)

In french: SysCacheStockageExterne

Returns the path of directory that will be used to store the data in cache on the external storage space of application.

Example

// Save a file in cache on the external storage space
IF SysStatusExternalStorage(1) = sseAvailable THEN
sCacheDir is string = SysCacheExternalStorage(1)
IF sCacheDir <> "" THEN
fSaveText(sCacheDir + "file.txt", MyString)
END
END

Syntax

<Result> = SysCacheExternalStorage(<Subscript>)

<Result>: Character string

Path of cache directory,
Empty string ("") if an error occurred.

<Subscript>: Integer

Subscript of external storage space to use (if the device includes several external storage spaces).
Note: SysNbExternalStorage returns the number of external storage spaces found on the device.

Remarks

Managing the external cache directory of application

The data found in this directory will be automatically deleted by the system:

if the system requires additional disk space (from Android 4.2 and only if the directory is found on non-moveable memory such as a partition of the internal memory).
if the user want to delete the data in cache.
if the application is uninstalled.

Tips for using the external cache directory of application

Before accessing a directory found in the external storage area of device, we advise you to check its availability with SysStatusStorageCard.
The application files that must not be shared with other applications must be stored in the application directory on the internal storage space of application. The path of different sub-directories is returned by fCurrentDir, fExeDir, fDataDir and fCacheDir.
fCacheDir is used to find out the path of the cache directory on the internal memory of the device.
We advise you to limit the volume of data stored in cache and to delete this data as soon as it is no longer used.

Component : wd250android.jar