dbgAssert (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

dbgAssert (Function)

In french: dbgAssertion

Used to find out and signal the possible errors via an assertive programming. dbgAssert is used in a code where a possible error may occur. A window signals the problem if an error occurs.

This mode is used by default in test mode and it can be enabled at runtime by dbgEnableAssert.

Versions 15 and later

This function is now available for Java applications.

New in version 15

This function is now available for Java applications.

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

Versions 19 and later

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

New in version 19

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

Versions 21 and later

This function is now available in Apple Watch mode.

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

New in version 21

This function is now available in Apple Watch mode.

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

This function is now available in Apple Watch mode.

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

Example

// La procédure ChercheClient(Numéro) permet de chercher le client spécifié
PROCÉDURE ChercheClient(Numéro)
HReadSeekFirst(Client, Numéro, Numéro)
dbgAssert(HFound, "Client non trouvé")

// ValeurCherchée a été passée en paramètre, elle existe normalement dans le fichier de données.
// On se positionne sur l'enregistrement
HReadSeekFirst(NomFichier, NomRub, ValeurCherchée)
// On vérifie qu'un enregistrement est bien trouvé
// (dans tous les cas, mode "normal" ou mode "debug")
IF HFound(NomFichier) = False THEN
// En mode "debug", affichage d'un message pour indiquer qu'il y a un problème
dbgAssert(False, StringBuild("L'enregistrement %1 du fichier" + ...
"NomFichier n'a pas été trouvé", ValeurCherchée))
// On gère ce cas dans le code en créant un enregistrement s'il n'a pas été trouvé
HReset(NomFichier)
NomFichier.NomRub = ValeurCherchée
HAdd(NomFichier)
END

Syntax

dbgAssert(<Condition to check> [, <Comment>])

<Condition to check>: Character string

Condition whose test must be run. This condition can be a WLanguage function, a local or global procedure, an expression, ...

<Comment>: Optional character string

Text that will be displayed (in a window) if the condition is not checked.

Remarks

In test mode, the management of assertions is enabled by default.
At runtime, the management of assertions is disabled by default. dbgAssert is not run. The WLanguage function specified in parameter will not be run.
There is no need to use InTestMode when the management of assertions is enabled. Indeed, often this function was used to trace a specific operation which can now be done with the function dbgAssert.
When this function is used in an Active WEBDEV Page, assertions are not displayed.
Indeed, the execution of the pages in AWP mode is performed by the Web server, and the Web server cannot create interfaces.
Versions 22 and later
The messages of dbgAssert will be written into the ADB log (at "Assert" level). For more details, see Managing ADB logs.
New in version 22
The messages of dbgAssert will be written into the ADB log (at "Assert" level). For more details, see Managing ADB logs.
The messages of dbgAssert will be written into the ADB log (at "Assert" level). For more details, see Managing ADB logs.

Component: wd270vm.dll