EQUAL Function

Returns `true` if the first argument is equal to the second argument. Equivalent to the `=` operator.
• Each argument can be a literal String, Integer or Decimal number, a function, or a column reference.

Since the function returns a Boolean value, it can be used as a function or a conditional.

NOTE: Within an expression, you might choose to use the corresponding operator, instead of this function. For more information, see Comparison Operators.

Basic Usage

`if(equal(errorCount, 0),'ok','Error_recorded')`

Output: If the value in the `errorCount` column is zero, then the `status` column value is `ok`. Otherwise, the value is `Error_recorded`.

Syntax

`equal(value1, value2)`

ArgumentRequired?Data TypeDescription
value1YstringThe first value. This value can be a String, a number, a function, or a column reference.
value2YstringThe second value. This value can be a String, a number, a function, or a column reference.

For more information on syntax standards, see Language Documentation Syntax Notes.

value1, value2

Names of the columns, expressions, or literals to compare.

• Missing values generate missing string results.

Usage Notes:

Required?Data TypeExample Value
YesColumn reference, function, or numeric or String value`myColumn`

Examples

Example - Basic Equal and Notequal Functions

This example demonstrate the following comparison functions.

In this example, the dataset contains current measurements of the sides of rectangular areas next to the size of those areas as previously reported. Using these functions, you can perform some light analysis of the data.

Source:

sideAsideBreportedArea
41456
6635
8432
1515200
4728
12670
9981

Transformation:

In the first test, you are determining if the four-sided area is a square, based on a comparison of the measured values for `sideA` and `sideB`:

Transformation Name `New formula` `Single row formula` `EQUAL(sideA, sideB)` `'isSquare'`

Next, you can use the reported sides to calculate the area of the shape and compare it to the area previously reported:

Transformation Name `New formula` `Single row formula` `NOTEQUAL(sideA * sideB, reportedArea)` `'isValidData'`

You can also compute if the reportedArea can be divided into even square units:

Transformation Name `New formula` `Single row formula` `ISEVEN(reportedArea)` `'isReportedAreaEven'`

You can test if either measured side is an odd number of units:

Transformation Name `New formula` `Single row formula` `IF((ISODD(sideA) == true) OR (ISODD(sideB) == true),TRUE,FALSE)` `'isSideOdd'`

Results:

sideAsideBreportedAreaisSquareisValidDataisReportedAreaEvenisSideOdd
41456FALSEFALSETRUEFALSE
6635TRUETRUETRUEFALSE
8432FALSEFALSETRUEFALSE
1515200TRUETRUETRUETRUE
4728FALSEFALSETRUETRUE
12670FALSETRUETRUEFALSE
9981TRUEFALSEFALSEFALSE