ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Standard functions / External file functions
  • Data folders in Android
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Returns the full path of the directory of HFSQL data files specified by the user when installing the application.
Note This directory does not necessarily correspond to the actual directory of the data files being executed (which may have been modified by functions HSubstDir, HChangeDir, etc.).
AndroidAndroid Widget In Android, returns the full path of the default directory containing the databases of the application. This directory cannot be configured.
Example
// Création d'un fichier .INI
RepINI is string
IF fDataDir() <> "" THEN
	RepINI = fDataDir() + ["\"] + "MONPROJET.INI"
ELSE
	RepINI = "MONPROJET.INI"
END
INIWrite("SECTION", "DEJALANCE", "OUI", RepINI)
Syntax
<Result> = fDataDir()
<Result>: Character string
  • Full path ("D:\DATA\Rewali") or UNC path ("\\SERVER\DATA\Rewali") of the HFSQL data file directory.
  • Result of fExeDir if no directory was specified during the setup (in test mode and when running an executable without setup).
  • AndroidAndroid Widget 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.
  • iPhone/iPadIOS WidgetMac Catalyst Full path of the directory containing the databases of the application. This directory corresponds to the "Documents" directory of the application. This directory cannot be configured.
Remarks
Android Widget

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.
// Liste les différents principaux dossiers utilisables sous Android
sInfoRépertoire is string

// Dossier par défaut des données 
sInfoRépertoire += [CR] + "fRepDonnées : " + fDataDir()
// Exemple : /data/user/0/com.masociete.nom_du_projet/databases
// Dossier NON accessible par un ordinateur lorsqu'il est connecté

// Carte externe principale de stockage 
// (ou stockage interne qui émule une carte externe)
sInfoRépertoire += [CR] + "SysRepCarteStockage : " + SysDirStorageCard()
// Exemple : /storage/emulated/0
// Dossier accessible par un ordinateur lorsqu'il est connecté, 
// il est vu comme la "racine" d'un disque de l'appareil

//Tous les périphériques sur lesquels il est possible de lire ou écrire
FOR n= 1 _TO_ SysNbExternalStorage()
	// Dossier de base de ce périphérique (ou périphérique émulé)
	sInfoRépertoire += [CR]+ "SysRepStockageExterne(" + n + ", ssePublic) : " + ...
		SysDirExternalStorage(n, ssePublic)
	// Exemple pour une carte émulée : /storage/emulated/0
	// Dossier accessible par un ordinateur lorsqu'il est connecté, 
	// il est vu comme la "racine" d'un disque de l'appareil

	// Répertoire des fichiers de données de l'application en cours 
	// (lorsque les données sont sur carte)
	sInfoRépertoire += [CR] + "SysRepStockageExterne(" + n + ", sseAppFichier) : " + ...
		SysDirExternalStorage(n, sseAppFile)
	// Exemple : /storage/emulated/0/Android/data/com.masociete.nom_du_projet/files
	// Dossier accessible par un ordinateur lorsqu'il est connecté, 
	// il est vu comme le sous-dossier 
	// "\Android\data\com.masociete.nom_du_projet\files" d'un disque

	// Répertoire des documents de l'application en cours 
	sInfoRépertoire += [CR] + "SysRepStockageExterne(" + n + ", sseAppDocument) : " + ...
			SysDirExternalStorage(n, sseAppDocument)
	// Exemple : /storage/emulated/0/Android/data/com.masociete.nom_du_projet/files/Documents
	// Dossier accessible par un ordinateur lorsqu'il est connecté, 
	// il est vu comme le sous-dossier 
	// "\Android\data\com.masociete.nom_du_projet\Documents" d'un disque

	// Répertoire des documents "publics" / "partagés" donc commun à toutes les applications 
	sInfoRépertoire += [CR] + "SysRepStockageExterne(" + n + ",ssePublicDocument) : " + ...
			SysDirExternalStorage(n, ssePublicDocument)
	// Exemple : /storage/emulated/0/Documents
	// Dossier accessible par un ordinateur lorsqu'il est connecté, 
	// il est vu comme le sous-dossier "\Documents" d'un disque

END

// Répertoire des fichiers de cache de l'application 
// (ces données peuvent être supprimées par l'utilisateur ou le système)
sInfoRépertoire += [CR] + "fRepCache : " + fCacheDir()
// Exemple : /data/user/0/com.masociete.nom_du_projet/cache
// Dossier NON accessible par un ordinateur lorsqu'il est connecté

// Pour avoir l'information dans les traces de Android Device Monitor 
// (.\personal\Android\AndroidSDK\tools\monitor.bat)
Trace(sInfoRépertoire)
Info(sInfoRépertoire)
Component: wd300vm.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 10/11/2025

Send a report | Local help