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
  • Windows of exceptions and errors
  • Handling exceptions programmatically
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
dbgSaveDebugDump (Function)
In french: dbgSauveDumpDébogage
Saves a dump file of the application. A dump file is used to reposition "later" the debugger on the runtime information of the application when the function was called. This allows you to view the stack and the content of variables when opening the dump file generated in WINDEV, WEBDEV or WINDEV Mobile.
To read the dump file, you must:
  • Drag and Drop the ".wdump" file to the window editor or page editor (on the bar of opened documents for example).
  • directly open the ".wdump" file (on the "Home" tab, in the "General" group, expand "Open" and select "Open").
Warning: The dump can only be opened with the version of the editor used to generate the executable that created the dump..
Remarks:
  • To view the dump file, the current project in the editor must be the project of the application or the project of one of the components used by the application. Only the information regarding the current project will be displayed.
  • Unlike the memory dump, the dump file is used to view the content of the memory and the content of the variables during the call to the function.
Example
// Sauve le dump de débogage dans l'audit d'exécution en cours
dbgSaveDebugDump()
// Sauve le dump de débogage dans un fichier
dbgSaveDebugDump(fExeDir() + ["\"] + "MonDump.wdump")
Syntax

Saving the dump file in the current dynamic audit

dbgSaveDebugDump()
Remark: This syntax saves the debug dump in the dynamic audit file if auditing is active (function dbgEnableAudit).. The function has no effect if the dynamic audit is not enabled. The audit can be enabled by dbgEnableAudit.

Saving the dump file in a file Hide the details

dbgSaveDebugDump(<Name of dump file>)
<Name of dump file>: Character string
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 the dump file (YYYYMMDD format).
[%Time%]Start time of the dump file (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 ".wdump".
  • the name of the file created corresponds to: "[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]".
    For example: "C:\Users\Doc\AppData\Roaming\Applications WINDEV\MyAppli\MyAppli_20091023_130812.wdump".
Warning: If you use dynamic string construction (option "Allow "[% %]" in strings" in the "Compilation" tab of the project description), a compilation error will appear (unknown identifier).. In this case, each string must be preceded by '-%'. Example:
dbgSaveDebugDump("[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
becomes
dbgSaveDebugDump(-%"[%RepDonneesUtilisateur%][%NomExe%]_[%Date%]_[%Heure%]")
Remarks

Windows of exceptions and errors

The windows of exceptions and errors propose an option that is used to save a dump file when the exception or the error occurs. It is the following link:
"Save the information for the application provider (dump file)"

Handling exceptions programmatically

When called from an exception handling code, dbgSaveDebugDump saves the dump file at the time the exception occurred, and not the current dump file in the exception process.
To save the status at the time of the exception, call dbgSaveDebugDump directly from the exception process.
If you use function dbgSaveDebugDump from a procedure (or method) called in the exception processing, the saved state will be that of the current processing: the stack will no longer correspond to the exception.
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