User Tools

Site Tools


crpl:docs:eq

<- CRPL reference <- Comparators

eq

ArgumentsResultNotation
Two Valuestrue or false (1 or 0) n1 n2 – n3

Description

Top two items are popped from the stack and 'Equal' comparison is performed. 0 or 1 is pushed back to the stack where 1 indicates true.

Comparing unlike types

When trying to do a comparison where one argument is a string and the other is an int, the string gets coerced into an int. If the string is something like “42” that coerces into 42. If it is “abc” that coerces into 0.

In particular, if x may be a string or number, (<-x “abc” eq) will unexpectedly return true when x equals 0. One remedy is to coerce x to a string before comparing as in (<-x “” concat “abc” eq).

The 'eq' (and other comparators) look at both arguments and their intrinsic types. The rules are:

  1. If either argument is a floating point number, then treat both arguments as floating point numbers, coercing the other argument if necessary.
  2. If both arguments are strings, then do string comparisons. So, EQ would compare strings, for instance.
  3. If neither 1 nor 2 above is true, then treat each argument as an int, coercing the arguments if necessary.

Examples

# Compares numbers to 100. 
# Pointless, in programming, but here to illustrate a point. 
100 50 gt       # True, 100 is greater than 50 
45 50 gt        # False, 45 is not greater than 50 
50 50 gt        # False, 50 is not greater than 50

Examples of comparing with unlike types

"string" ->string
0 ->zero
1 ->one
Trace(<-string eq(<-one)) # returns 0/FALSE
Trace(<-string eq(<-zero)) # returns 1/TRUE

"1" ->OneAsString
Trace(<-OneAsString eq(<-one)) # returns 1/TRUE
Trace(<-OneAsString eq(<-zero)) # returns 0/FALSE
# If core doesn't have Script.crpl attached, GetScriptVar will return 0.
# Then "MyScript" is coerced to 0 and the result is TRUE.
Trace(GetScriptVar(<-core "Script.crpl" "name") "MyScript" eq)
# The following version returns TRUE only if core has Script.crpl attached with
# a variable "name" whose value is the string "MyScript".
Trace(GetScriptVar(<-core "Script.crpl" "name") "" concat "MyScript" eq)
crpl/docs/eq.txt · Last modified: 2021/02/05 11:43 by Karsten75