Difference between revisions of "="
From Xojo Documentation
(→See Also) |
(Changed deprecated StrComp to String.Compare.) |
||
(28 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
+ | {{OperatorBox}} | ||
+ | {{Description | ||
+ | |text=The = character is to determine whether one expression is equal to another or to assign a value to a property or variable. [[String|String]] comparisons are case-insensitive. | ||
+ | }} | ||
− | + | == Usage == | |
− | ==''' | + | ''result'' = ''expression1'' = ''expression2'' |
− | + | {| cellpadding="6" cellspacing="0" border="1" | |
− | + | ! width=15% style="background-color:#e0e0e0" | Part | |
− | + | ! width=25% style="background-color:#e0e0e0" | Type | |
− | |||
− | |||
− | |||
− | {| cellpadding=" | ||
− | |||
− | ! width= | ||
− | |||
− | ! width= | ||
− | |||
! width=55% style="background-color:#e0e0e0" | Description | ! width=55% style="background-color:#e0e0e0" | Description | ||
|- | |- | ||
|result | |result | ||
− | |||
|[[Boolean|Boolean]] | |[[Boolean|Boolean]] | ||
|Returns [[True|True]] if ''expression1'' is equal to ''expression2''. | |Returns [[True|True]] if ''expression1'' is equal to ''expression2''. | ||
− | |||
|- | |- | ||
|expression1 | |expression1 | ||
− | |||
|[[String|String]], Number, [[Boolean|Boolean]], [[Color|Color]], or [[Object|Object]] | |[[String|String]], Number, [[Boolean|Boolean]], [[Color|Color]], or [[Object|Object]] | ||
|Any expression. | |Any expression. | ||
− | |||
|- | |- | ||
|expression2 | |expression2 | ||
− | |||
|[[String|String]], Number, [[Boolean|Boolean]], [[Color|Color]] or [[Object|Object]] | |[[String|String]], Number, [[Boolean|Boolean]], [[Color|Color]] or [[Object|Object]] | ||
|Any expression. | |Any expression. | ||
− | |||
|- | |- | ||
|} | |} | ||
− | + | ''result''=''value'' | |
− | {| cellpadding=" | + | {| cellpadding="6" cellspacing="0" border="1" |
− | + | ! width=15% style="background-color:#e0e0e0" | Part | |
− | ! width= | + | ! width=25% style="background-color:#e0e0e0" | Type |
− | |||
− | ! width= | ||
− | |||
! width=55% style="background-color:#e0e0e0" | Description | ! width=55% style="background-color:#e0e0e0" | Description | ||
|- | |- | ||
|result | |result | ||
− | |||
|Any | |Any | ||
− | |||
|The property, variable, array, or array element that is assigned ''value''. | |The property, variable, array, or array element that is assigned ''value''. | ||
− | |||
|- | |- | ||
|value | |value | ||
− | |||
|Any | |Any | ||
− | |||
|The value assigned to result. | |The value assigned to result. | ||
− | |||
|- | |- | ||
|} | |} | ||
+ | == Notes == | ||
+ | The data types of ''expression1'' and ''expression2'' must match. You can make comparisons between objects of any data type and between objects. If you compare objects, '''=''' compares their references, not their contents. For example, when you compare two [[FolderItem|FolderItems]], '''=''' determines whether they have the same reference, not whether they point to the same file. | ||
− | + | Use [[String.Compare]] to do a case-sensitive [[String|string]] comparison. | |
− | |||
− | |||
− | |||
You can use [[Operator_Compare|Operator_Compare]] to define comparisons for classes. | You can use [[Operator_Compare|Operator_Compare]] to define comparisons for classes. | ||
+ | == Sample Code == | ||
+ | The following example tests whether two strings are equal. | ||
+ | <rbcode> | ||
+ | Var t1 As String = "Hello" | ||
+ | Var t2 As String = "There" | ||
− | + | If t1 = t2 Then | |
− | + | // t1 is equal to t2 | |
− | + | Else | |
− | + | // t1 is not equal to t2 | |
− | + | End If | |
− | + | </rbcode> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | < | ||
− | |||
− | |||
− | |||
− | |||
+ | == See Also == | ||
+ | [[Equals]], [[Greater_than|>]], [[Greater_than=|>=]], [[Less_than|<]], [[Less_than=|<=]], [[Not_equal|<>]] operators; [[Operator_Compare|Operator_Compare]], [[String.Compare]] functions; [[Operator_Precedence |Operator precedence]]. | ||
− | [[Category: | + | [[Category:Text_Strings]] |
− |
Latest revision as of 14:16, 26 January 2021
The = character is to determine whether one expression is equal to another or to assign a value to a property or variable. String comparisons are case-insensitive.
Usage
result = expression1 = expression2
Part | Type | Description |
---|---|---|
result | Boolean | Returns True if expression1 is equal to expression2. |
expression1 | String, Number, Boolean, Color, or Object | Any expression. |
expression2 | String, Number, Boolean, Color or Object | Any expression. |
result=value
Part | Type | Description |
---|---|---|
result | Any | The property, variable, array, or array element that is assigned value. |
value | Any | The value assigned to result. |
Notes
The data types of expression1 and expression2 must match. You can make comparisons between objects of any data type and between objects. If you compare objects, = compares their references, not their contents. For example, when you compare two FolderItems, = determines whether they have the same reference, not whether they point to the same file.
Use String.Compare to do a case-sensitive string comparison.
You can use Operator_Compare to define comparisons for classes.
Sample Code
The following example tests whether two strings are equal.
Var t2 As String = "There"
If t1 = t2 Then
// t1 is equal to t2
Else
// t1 is not equal to t2
End If
See Also
Equals, >, >=, <, <=, <> operators; Operator_Compare, String.Compare functions; Operator precedence.