ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Test functions
  • Operating mode
  • Managing assertions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Checks whether an expression is not Null in assertive programming and in automated test mode.
Remark: This function is equivalent to dbgCheckNotNull.
Example
ElementArray is dynamic array of MyClass
// Fill the array
...
// Browse the array elements
FOR I = 1 _TO_ ElementArray.Count
// The element should be allocated
TestCheckNotNull(ElementArray[I], "The object #%1 was not allocated", I)
// Process the element
...
END
Syntax
TestCheckNotNull(<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>.
Remarks

Operating mode

When the expression is 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 TestCheckNotNull will be written into the ADB log (at "Assert" level). For more details, see Managing ADB logs.
Component: wd300.dll
Minimum version required
  • Version 23
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help