Help / WLanguage / WLanguage functions / Standard functions / Debug functions
  • Operating mode
  • Managing assertions
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
Checks whether an expression is Null in assertive programming and in automated test mode.
// If FindCustomer is a procedure used to find a customer identified by its name and that returns
// the CCustomer object corresponding to the customer if the customer is known and Null otherwise
// A customer who already exists must not be added
dbgCheckNull(FindCustomer(CustomerName), "Customer '%1' is already known", CustomerName)
// Adds the customer
dbgCheckNull(<Expression> [, <Comments> [, <Parameter 1> [... [, <Parameter N>]]]])
<Expression>: Character string
Expression that must be checked.
<Comments>: Character string
Character string in the format defined by StringBuild.
<Parameter 1>: Any type
First parameter expected by <Comments>.
<Parameter N>: Any type
Last parameter expected by <Comments>.

Operating mode

When the expression is not Null:
  • WINDEVWEBDEV - Server code in automated test mode, an error is added to the test status report (equivalent to TestWriteResult).
  • in manual test mode, an assertion is displayed (equivalent to dbgAssert).
  • in runtime mode, an assertion is displayed if the assertions have been enabled (equivalent to dbgAssert).
When running an application, the expression is not evaluated if the assertions are not enabled.
dbgOnError allows you to automatically start a WLanguage procedure used to retrieve the comment linked to the error.
AndroidAndroid Widget

Managing assertions

The messages of dbgCheckNull will be written into the ADB log (at "Assert" level). For more details, see Managing ADB logs.
Business / UI classification: Neutral code
Component: wd300vm.dll
Minimum version required
  • Version 17
This page is also available for…
Click [Add] to post a comment

Last update: 07/03/2023

Send a report | Local help