fDataDir (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

External file management functions

The data directory can be specified during the setup

Remark

Data folders in Android

See also

fDataDir (Function)

In french: fRepDonnées

Returns the full path of the directory of HFSQL data files specified by the user when installing the application.

Remark: This directory does not necessarily correspond to the real directory of the data files at run time (that may have been modified by HSubstDir, HChangeDir, ...).

Versions 16 and later

This function is now available for Android applications.

In Android, returns the full path of the default directory containing the databases of the application. This directory cannot be configured.

New in version 16

This function is now available for Android applications.

In Android, returns the full path of the default directory containing the databases of the application. This directory cannot be configured.

This function is now available for Android applications.

In Android, returns the full path of the default directory containing the databases of the application. This directory cannot be configured.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Remark: From version 19, HFSQL is the new name of HyperFileSQL.

Example

// Create a .INI file
INIDir is string
IF fDataDir() <> "" THEN
INIDir = fDataDir() + ["\"] + "MYPROJET.INI"
ELSE
INIDir = "MYPROJECT.INI"
END
INIWrite("SECTION", "ALREADYRUN", "YES", INIDir)

Syntax

<Result> = fDataDir()

<Result>: Character string

Full path (for example: "D:\DATA\Rewali") or UNC path (for example: "\\SERVER\DATA\Rewali") of the directory for the HFSQL data files.
Result of fExeDir if no directory was specified during the setup (in test mode and when running an executable without setup).
Versions 15 and later
Full path of the default directory containing the application database(s) in the internal storage area. This directory corresponds to the "Databases" directory of the application. This directory cannot be configured.
New in version 15
Full path of the default directory containing the application database(s) in the internal storage area. This directory corresponds to the "Databases" directory of the application. This directory cannot be configured.
Full path of the default directory containing the application database(s) in the internal storage area. This directory corresponds to the "Databases" directory of the application. This directory cannot be configured.
Versions 17 and later
Full path of the directory containing the databases of the application. This directory corresponds to the "Documents" directory of application. This directory cannot be configured.
New in version 17
Full path of the directory containing the databases of the application. This directory corresponds to the "Documents" directory of application. This directory cannot be configured.
Full path of the directory containing the databases of the application. This directory corresponds to the "Documents" directory of application. This directory cannot be configured.

Remarks

Miscellaneous

If HSubstDir is used in the code of the application, the directory specified by the user during the setup will be ignored.
If the data files are described in the analysis with a specific directory (not recommended), this directory will not be taken into account. Only the directory specified by the user during the setup will be taken into account.
The fDataDir function is not equivalent to the Directory property.

The data directory can be specified during the setup

In the setup is performed via physical media, the directory of the data files is specified during the setup.
For a remote setup (FTP), the Internet provider supplies the home directory for the data files and the user supplies the name of the sub-directory in which the data files are installed.

Remark

fDataDir and fExeDir return the same value.

Data folders in Android

In Android, the folders corresponding to the data are not simply identified.

The following code is used to list the main files and the correspondence of these files when the device is connected to a computer.

// List the main usable folders in Android
sDirectoryInfo is string

// Default data folder
sDirectoryInfo += [CR] + "fDataDir: " + fDataDir()
// Example: /data/user/0/com.mycompany.projet_name/databases
// Folder NOT accessible by a computer when it is connected

// Main external storage card
// (or internal storage that emulates an external card)
sDirectoryInfo += [CR] + "SysDirStorageCard: " + SysDirStorageCard()
// Example: /storage/emulated/0
// Folder accessible by a computer when it is connected,
// it is seen as the "root" of a disk on the device

// All the devices on which it is possible to read or write
FOR n= 1 _TO_ SysNbExternalStorage()
// Home folder of this device (or emulated device)
sDirectoryInfo += [CR] + "SysDirExternalStorage(" + n + ", ssePublic): " + ...
SysDirExternalStorage (n, ssePublic)
// Example for an emulated card: /storage/emulated/0
// Folder accessible by a computer when it is connected,
// it is seen as the "root" of a disk on the device

// Data file directory of the current application
// (when the data is on the card)
sDirectoryInfo += [CR] + "SysDirExternalStorage(" + n + ", sseAppFile): " + ...
SysDirExternalStorage(n, sseAppFile)
// Example: /storage/emulated/0/Android/data/com.mycomany.project_name/files
// Folder accessible by a computer when it is connected,
// it is seen as the subdirectory "\Android\data\com.mycompany.project_name\files" of a disk

// Document folder of the current application
sDirectoryInfo += [CR] + "SysDirExternalStorage(" + n + ", sseAppDocument): " + ...
SysDirExternalStorage(n, sseAppDocument)
// Example: /storage/emulated/0/Android/data/com.mycomany.project_name/files/Documents
// Folder accessible by a computer when it is connected,
// it is seen as the subdirectory "\Android\data\com.mycompany.project_name\Documents" of a disk

// Folder with "public" / "shared" documents, common to all the applications
sDirectoryInfo += [CR] + "SysDirExternalStorage(" + n + ", ssePublicDocument): " + ...
SysDirExternalStorage(n, ssePublicDocument)
// Example: /storage/emulated/0/Documents
// Folder accessible by a computer when it is connected,
// it is seen as the "\Documents" subdirectory of a disk

END

// Directory with the cache files of the application
// (this data can be deleted by the user or the system)
sDirectoryInfo += [CR] + "fCacheDir: " + fCacheDir()
// Example: /data/user/0/com.mycompany.project_name/cache
// Folder NOT accessible by a computer when it is connected

// To have information in the Android Device Monitor traces
// (.\Personal\Android\AndroidSDK\tools\monitor.bat)
Trace(sDirectoryInfo)
Info(sDirectoryInfo)

Component: wd260vm.dll