PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

This page concerns the 23 + version of WINDEV, WEBDEV, WINDEV Mobile. Upgrade your version.
  • Operating mode
  • Managing assertions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Checks whether an expression is Null in assertive programming and in automatic test mode.
Note: This function is equivalent to dbgCheckNull.
Example
// 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
TestCheckNull(FindCustomer(CustomerName), "Customer '%1' is already known", CustomerName)
// Adds the customer
AddCustomer(CustomerName)
Syntax
TestCheckNull(<Expression> [, <Comments> [, <Parameter 1> ... [, <Parameter N>]]])
<Expression>: Character string (with or without quotes)
Expression that must be checked.
<Comments>: Character string (with quotes)
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>.
Remarks

Operating mode

When the expression is not Null:
  • WINDEVWEBDEV - Server codeWindows Mobile in automatic test mode, an error is added into the status report of test (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 TestCheckNull will be written into the ADB log (at "Assert" level). See Managing ADB logs for more details.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230.dll
Windows Mobile wp230.dll
Java wd230java.jar
Linux wd230.so
Android wd230android.jar
Minimum required version
  • Version 23
This page is also available for…
Comments
Click [Add] to post a comment