Assert command - Revision history

Ekern at 22:04, 20 January 2023

2023-01-20T22:04:08Z

← Older revision		Revision as of 22:04, 20 January 2023
Line 2:		Line 2:
	{\|		{\|
	\|width="125px"\| '''Action:'''		\|width="125px"\| '''Action:'''
	\|width="~~575px~~"\|		\|width="775px"\|
	<span class="f_Para">Performs an equality or inequality comparison between a) the value of program data or a [[Working with macro variables\|macro variable]] or [[Working with Client functions (Debugger)\|Client function]], and b) a constant or the value of a macro variable or macro function. For example: </span>		<span class="f_Para">Performs an equality or inequality comparison between a) the value of program data or a [[Working with macro variables\|macro variable]] or [[Working with Client functions (Debugger)\|Client function]], and b) a constant or the value of a macro variable or macro function. For example: </span>

Ekern at 22:03, 20 January 2023

2023-01-20T22:03:35Z

← Older revision		Revision as of 22:03, 20 January 2023
Line 1:		Line 1:
	__TOC__		__TOC__
	{\|		{\|
	\|width="~~50%~~"\| '''Action:'''		\|width="125px"\| '''Action:'''
	\|width="~~50%~~"\|		\|width="575px"\|
	<span class="f_Para">Performs an equality or inequality comparison between a) the value of program data or a [[Working with macro variables\|macro variable]] or [[Working with Client functions (Debugger)\|Client function]], and b) a constant or the value of a macro variable or macro function. For example: </span>		<span class="f_Para">Performs an equality or inequality comparison between a) the value of program data or a [[Working with macro variables\|macro variable]] or [[Working with Client functions (Debugger)\|Client function]], and b) a constant or the value of a macro variable or macro function. For example: </span>

Ekern at 15:29, 26 November 2022

2022-11-26T15:29:03Z

← Older revision		Revision as of 15:29, 26 November 2022
Line 5:		Line 5:
	<span class="f_Para">Performs an equality or inequality comparison between a) the value of program data or a [[Working with macro variables\|macro variable]] or [[Working with Client functions (Debugger)\|Client function]], and b) a constant or the value of a macro variable or macro function. For example: </span>		<span class="f_Para">Performs an equality or inequality comparison between a) the value of program data or a [[Working with macro variables\|macro variable]] or [[Working with Client functions (Debugger)\|Client function]], and b) a constant or the value of a macro variable or macro function. For example: </span>

	<~~span~~ class="~~f_CodeExample~~">assert %i=~~</span><span class="f_~~=~~XmpPrintTable">=</span><span class="f_CodeExample">~~666 </~~span~~>		<p class="syntax">assert %i==666 </p>

	<span class="f_Para">This command lets you create simple testing macros that ensure that key elements in your code have the values you expect. If the comparison expression you construct with </span><span class="f_Monospace">assert</span><span class="f_Para"> is not logically true, you receive a failure message. If true, you receive no confirmation. </span>		<span class="f_Para">This command lets you create simple testing macros that ensure that key elements in your code have the values you expect. If the comparison expression you construct with </span><span class="f_Monospace">assert</span><span class="f_Para"> is not logically true, you receive a failure message. If true, you receive no confirmation. </span>

Ekern at 15:28, 26 November 2022

2022-11-26T15:28:25Z

← Older revision		Revision as of 15:28, 26 November 2022
Line 29:		Line 29:
	*<span class="f_MonoItal">%</span><span class="term">x</span><span class="f_ListBul1"> is a mainframe variable. </span>		*<span class="f_MonoItal">%</span><span class="term">x</span><span class="f_ListBul1"> is a mainframe variable. </span>

	*<span class="f_ListBul1">g.</span><span class="term">x</span><span class="f_ListBul1"> is a Debugger [[~~watch_global_variables.html~~\|global variable reference]]. </span>		*<span class="f_ListBul1">g.</span><span class="term">x</span><span class="f_ListBul1"> is a Debugger [[Watching global variables\|global variable reference]]. </span>
	*<span class="f_ListBul1">f.</span><span class="term">x</span><span class="f_ListBul1"> is a Debugger [[~~watching_fields.html~~\|field reference]], possibly with a subscript. </span>		*<span class="f_ListBul1">f.</span><span class="term">x</span><span class="f_ListBul1"> is a Debugger [[Watching Model 204 fields\|field reference]], possibly with a subscript. </span>
	*<span class="f_ListBul1">$listcnt/$listinf are the Debugger functions for [[~~watching_~~$lists~~.html~~\|viewing $list counts and elements.]] </span>		*<span class="f_ListBul1">$listcnt/$listinf are the Debugger functions for [[Watching $lists, Stringlists, and Arraylists\|viewing $list counts and elements.]] </span>
	*<span class="f_ListBul1">&&</span><span class="term">function</span><span class="f_ListBul1"> is a macro function. </span>		*<span class="f_ListBul1">&&</span><span class="term">function</span><span class="f_ListBul1"> is a macro function. </span>
	*<span class="term">string</span><span class="f_ListBul1"> is a quoted string constant (double or single quotes are valid). </span>		*<span class="term">string</span><span class="f_ListBul1"> is a quoted string constant (double or single quotes are valid). </span>

Ekern at 17:09, 7 October 2022

2022-10-07T17:09:51Z

Show changes

Ekern: Created page with "TOC {| |width="50%"| '''Action:''' |width="50%"| Performs an equality or inequality comparison between a) the value of program data or a working_wit..."

2022-05-17T16:43:54Z

Created page with "__TOC__ {| |width="50%"| '''Action:''' |width="50%"| Performs an equality or inequality comparison between a) the value of program data or a working_wit..."

New page

__TOC__
{|
|width="50%"| '''Action:'''
|width="50%"|
Performs an equality or inequality comparison between a) the value of program data or a [[working_with_macro_variables.html|macro variable]] or [[working_with_macro_functions.html|Client function]], and b) a constant or the value of a macro variable or macro function. For example: 

assert %i==666 

This command lets you create simple testing macros that ensure that key elements in your code have the values you expect. If the comparison expression you construct with assert is not logically true, you receive a failure message. If true, you receive no confirmation. 

assert failure messages are displayed in the [[using_macro_console_cmdline.html#macro_console|console]], if it is open. Otherwise, they are displayed in a Windows message box. They have the following format: 

Assert failed: failing_assert_statement 

For example: 

Assert failed: assert &b = "no way" 

The assert command syntax follows: 


'''ASSERT'''
{&var|%x|g.x|f.x|$listcnt(x)|$listinf(x,y)|&&function}
{=|==|!=|<>}
{string|[-]n|&var|&&function}


where:

*&var is a previously defined macro variable. 

*%x is a mainframe variable. 

*g.x is a Debugger [[watch_global_variables.html|global variable reference]]. 

*f.x is a Debugger [[watching_fields.html|field reference]], possibly with a subscript. 

*$listcnt/$listinf are the Debugger functions for [[watching_$lists.html|viewing $list counts and elements.]] 

*&&function is a macro function. 

*string is a quoted string constant (double or single quotes are valid). 

*[-]n is an integer constant with an optional leading minus sign. 

Here are examples of valid assert statements: 

assert g.JACK = "No play makes Jack a dull boy." 

 ASSERt %s='Hey Moe' 

ASSERT $listcnt(%g)=2 

ASSERT $listinf(%g,2) = " makes Jack a dull boy." 

assert &this = 'that' 

assert &this <> &that 

Notes: 

*The [[assertfailurecount_function.html|&&assertFailureCount]], [[assertsuccesscount_function.html|&&assertSuccessCount]], and [[assertstatus_function.html|&&assertStatus]] Client functions, as well as [[globalassertfailurecount_function.html|&&globalAssertFailureCount]], [[globalassertsuccesscount_function.html|&&globalAssertSuccessCount]], and [[globalassertstatus_function.html|&&globalAssertStatus]], report assert command results. 

*If you are specifying a Client [[setup_ui_xml_file.html#mapping_element|mapping command]] and your assertion includes an ampersand character (&) or the not equal operator (<>), you must XML entity encode the character. For example, to map the command assert &i<>6, you specify it like this: 

<mapping command="assert &amp;i&lt;&gt;6" button="button9"/> 
|-
| '''Client menu:'''
| --
|-
| '''Introduced:'''
| Build 28
|}
[[Category:Debugger Commands]]