assertEquals()

Purpose

Checks that two values are equal.

Syntax

assertEquals( [<string>,] <val1>, <val2> [, <precision>] )

where:

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

verifyEquals()assertSame()verifySame()