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 / Debug functions
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
dbgSaveMemoryDump (Function)
In french: dbgSauveDumpMémoire
Saves a dump of memory used by the application. A dump of the memory used by the application corresponds to a detailed description of elements in memory as well as the memory consumed by these elements.
Unlike the dump file, the memory dump cannot be used to see the content of variables but only the memory footprint.
A memory dump can also be created by pressing Ctrl + Pause at any time
Example
// Sauve le dump mémoire dans l'audit d'exécution en cours
dbgSaveMemoryDump()
Syntax

Saving the memory dump in the current dynamic audit

dbgSaveMemoryDump()
Remark: This syntax saves the memory dump in the dynamic audit file if auditing is active.. The function has no effect if the dynamic audit is not enabled.

Saving the memory dump in a file or in interactive mode Hide the details

dbgSaveMemoryDump(<Name of dump file>)
<Name of dump file>: Character string
  • "?": launches backup in interactive mode.
    If the dynamic audit is enabled, the memory dump is saved in the dynamic audit file.
    If the dynamic audit is disabled, a file picker allows the user to select the name of the file where the memory dump will be saved.
    In both cases, a confirmation message is displayed at the end of the operation.
  • Name of the file where the dump is saved. The name of the file can be built with the following elements:
    [%ExeDir%]Directory of the executable, always filled with the "\" character. This directory is equivalent to the result of fExeDir.
    [%ExeName%]Executable name.
    [%Date%]Start date of memory dump (YYYYMMDD format).
    [%Time%]Start time of the memory dump (HHMMSS format).
    [%UserName%]Name of the current user.
    [%ComputerName%]Computer name.
    [%DataDir%]Directory of the HFSQL data files specified by the user when installing the application. This directory is equivalent to the result of fDataDir.
    [%DirUserData%]Directory for the data of the current user of the current application. This directory is equivalent to the result of fDataDirUser.
If this parameter corresponds to an empty string (""):
  • The extension of the file will be ".wmem".
  • the name of the file created corresponds to: "[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]".
    For example: "C:\Users\Doc\AppData\Roaming\Applications WINDEV\MyAppli\MyAppli_20161023_130812.wmem".
Warning: If you use dynamic string construction (option "Allow "[% %]" in strings" in the "Compilation" tab of the project description, a compilation error appears (unknown identifier).. In this case, each string must be preceded by '-%'. Example:
dbgSaveMemoryDump("[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
becomes
dbgSaveMemoryDump(-%"[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
Component: wd300vm.dll
Minimum version required
  • Version 15
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 09/24/2024

Send a report | Local help