Changes between Initial Version and Version 1 of Assert

Timestamp:

02/15/10 01:41:38 (15 years ago)

Author:

hopscc

Comment:

--

Assert

@@ +1 @@
+= Assert = 
+
+The assert statement provides a way to verify the internal state of your code. 
+To the assertion, you provide a [wiki:ConditionalExpr conditional expression] that is 
+expected to evaluate true.[[BR]]
+If the verification fails (condition is false), an exception (!AssertException) is raised.
+
+The exception reports the source code of the condition, the file name, the line number, 
+the current object and information provided as an optional second argument to the assert. 
+However, it's rarely necessary to provide a second, informational argument because a 
+failed assertion also reports the value of every subexpression of the condition. 
+
+For example 
+{{{ assert obj.foo < bar }}}
+failing its assertion will report the value of obj.foo, obj and bar. 
+This makes assertions quick to write and easy to diagnose.
+
+== Grammar ==
+{{{
+assert <condition> [, info]
+}}}
+
+== Platform ==
+
+== Examples ==
+{{{
+assert i > 0
+
+assert obj.foo < bar
+
+assert not badValue   # test that a boolean value is false
+
+assert obj   # assert obj not null
+assert name.length # assert name is not 0 length  
+
+assert 'result=' in resultString 
+
+# assert with explicit info message
+assert _didReset, 'Have not reset. Probably subclass overrides _reset but did not invoke base.'
+}}}
+
+
+== Notes ==