assertEquals()
Purpose
Checks that two values are equal.
Syntax
assertEquals( [<string>,] <val1>, <val2> [, <precision>] )
where:
<string> is an optional message
<val1> and <val2> are two Java type values
<precision> is an optional precision argument for Float or Double types
Description
The corresponding test result is Passed if the <val1> and <val2> are equal—within a given <precision> margin if specified—and Failed if the condition is False.
Compared values may be of any Java type: Boolean, float, double, short, byte, char, int, long or object. <val1> and <val2> must be of the same type.
An optional <string> message can be logged and displayed in the test report.
An optional <precision> argument specifies an acceptable margin for Float or Double values. By default, <val1> and <val2> must be strictly equal.
If an exception is thrown in the assertEquals() method, the test is stopped.
Examples
Boolean:
assertEquals("assert equals true", true, true);
assertEquals("assert equals false", true, false);
assertEquals(true, true);
assertEquals(true, false);
Float:
float val1;
float val2;
val1 = 1;
val2 = 1;
assertEquals("assert equals true", val1, val2, 0.1);
val2 = 3;
assertEquals("assert equals false", val1, val2, 0.1);
float val1;
float val2;
val1 = 1;
val2 = 1;
assertEquals(val1, val2,0.1);
val2 = 3;
assertEquals(val1, val2,0.1);
Double:
double val1;
double val2;
val1 = 1.05;
val2 = 1.05;
assertEquals("assert equals true", val1, val2,0.01);
val2 = 1.06;
assertEquals("assert equals false", val1, val2,0.0001);
double val1;
double val2;
val1 = 1.05;
val2 = 1.05;
assertEquals(val1, val2,0.01);
val2 = 1.06;
assertEquals(val1, val2,0.0001);
Short:
short val1 = 1;
short val2 = 1;
assertEquals("assert equals true short", val1,val2);
Byte:
byte val1 = 1;
byte val2 = 1;
assertEquals(val1,val2);
Char
char val1 = 'a';
char val2 = 'a';
assertEquals("assert equals true char", val1,val2);
Int
int val1 = 1;
int val2 = 1;
assertEquals("assert equals true int", val1,val2);
Long
long val1 = 1;
long val2 = 1;
assertEquals("assert equals true long", val1,val2);
Object
long val1 = 1;
long val2 = 1;
assertEquals("assert equals true Object", new Long(val1), new Long(val2));
Related Topics