The tables in this section show the comparison operators as they apply to string, numeric, date, time, pointer and picture with metadata expressions (you cannot use them with array or BLOB type expressions). An expression that uses a comparison operator returns a Boolean value, either TRUE or FALSE.
Note: You can compare two pictures using the Equal pictures command.
Operation | Syntax | Returns | Expression | Value |
Equality | String = String | Boolean | "abc" = "abc" | True |
| | | "abc" = "abd" | False |
Inequality | String # String | Boolean | "abc" # "abd" | True |
| | | "abc" # "abc" | False |
Greater than | String > String | Boolean | "abd" > "abc" | True |
| | | "abc" > "abc" | False |
Less than | String < String | Boolean | "abc" < "abd" | True |
| | | "abc" < "abc" | False |
Greater than or equal to | String >= String | Boolean | "abd" >= "abc" | True |
| | | "abc" >= "abd" | False |
Less than or equal to | String <= String | Boolean | "abc" <= "abd" | True |
| | | "abd" <= "abc" | False |
Contains keyword | String % String | Boolean | "Alpha Bravo" % "Bravo" | True |
| | | "Alpha Bravo" % "ravo" | False |
| Picture % String | Boolean | Picture_expr % "Mer" | True (*) |
(*) If the keyword "Mer" is associated with the picture stored in the picture expression (field or variable).
Important: Additional information about string comparisons are provided at the end of this section.
With:
vPtrA:=->anObject
vPtrB:=->anObject
vPtrC:=->anotherObject
Operation | Syntax | Returns | Expression | Value |
Equality | Pointer = Pointer | Boolean | vPtrA = vPtrB | True |
| | | vPtrA = vPtrC | False |
Inequality | Pointer # Pointer | Boolean | vPtrA # vPtrC | True |
| | | vPtrA # vPtrB | False |
- Strings are compared on a character-by-character basis (except in the case of searching by keywords, see below).
- When strings are compared, the case of the characters is ignored; thus, "a"="A" returns TRUE. To test if the case of two characters is different, compare their character codes. For example, the following expression returns FALSE:
- When strings are compared, diacritical characters are compared using the system character comparison table of your computer. For example, the following expressions return TRUE:
"n"="ñ"
"n"="Ñ"
"A"="å"
- Unlike other string comparisons, searching by keywords looks for “words” in “texts”: words are considered both individually and as a whole. The % operator always returns False if the query concerns several words or only part of a word (for example, a syllable). The “words” are character strings surrounded by “separators,” which are spaces and punctuation characters and dashes. An apostrophe, like in “Today's” is considered as part of the word. Numbers can be searched for because they are evaluated as a whole (including decimal symbols). Other symbols (currency, temperature, and so on) will be ignored.
"Alpha Bravo Charlie"%"Bravo"
"Alpha Bravo Charlie"%"vo"
"Alpha Bravo Charlie"%"Alpha Bravo"
"Alpha,Bravo,Charlie"%"Alpha"
"Software and Computers"%"comput@"
Note: For more information about the rules concerning how keywords are taken into account, please refer to the following address: http://www.unicode.org/unicode/reports/tr29/#Word_Boundaries.
- The wildcard character (@) can be used in any string comparison to match any number of characters. For example, the following expression is TRUE:
"abcdefghij"="abc@"
The wildcard character must be used within the second operand (the string on the right side) in order to match any number of characters. The following expression is FALSE, because the @ is considered only as a one character in the first operand:
"abc@"="abcdefghij"
The wildcard means “one or more characters or nothing”. The following expressions are TRUE:
"abcdefghij"="abcdefghij@"
"abcdefghij"="@abcdefghij"
"abcdefghij"="abcd@efghij"
"abcdefghij"="@abcdefghij@"
"abcdefghij"="@abcde@fghij@"
On the other hand, whatever the case, a string comparison with two consecutive wildcards will always return FALSE. The following expression is FALSE:
"abcdefghij"="abc@@fg"
When the comparison operator is or contains a < or > symbol, only comparison with a single wildcard located at the end of the operand is supported:
"abcd"<="abc@"
"abcd"<="abc@ef"/Not a valid comparison/
Tip:If you want to execute comparisons or queries using @ as a character (and not as a wildcard), you have two options:
- Use the Character code (At sign) instruction.
Imagine, for example, that you want to know if a string ends with the @ character.
- the following expression (if $vsValue is not empty) is always TRUE:
($vsValue≤Length($vsValue)≥="@")
- the following expression will be evaluated correctly:
- Use the "Consider @ as a wildcard only when at the beginning or end of text patterns" option which can be accessed using the Database Settings dialog box.
This option lets you define how the @ character is interpreted when it is included in a character string. As such, it can influence how comparison operators are used in Query or Order By. For more information, refer to the 4D Design Reference manual.