Help Center
Help CenterFreeBASIC

Operator Or (Inclusive Disjunction)operator

Returns the bitwise-or (inclusive disjunction) of two numeric values

Operatorsoperatordocumented

Syntax

Declare Operator Or ( ByRef lhs As T1, ByRef rhs As T2 ) As Ret

Parameters

NameDescription
lhsThe left-hand side expression.
T1Any numeric or boolean type.
rhsThe right-hand side expression.
T2Any numeric or boolean type.
RetA numeric or boolean type (varies with
T1and
T2).

Return value


Returns the bitwise-disjunction of the two operands.

Description


This operator returns the bitwise-disjunction of its operands, a logical operation that results in a value with bits set depending on the bits of the operands (for conversion of a boolean to an integer, false or true boolean value becomes 0 or -1 integer value).

The truth table below demonstrates all combinations of a boolean-disjunction operation:

Lhs BitRhs BitResult
000
101
011
111


No short-circuiting is performed - both expressions are always evaluated.

The return type depends on the types of values passed. Byte, UByte and floating-point type values are first converted to Integer. If the left and right-hand side types differ only in signedness, then the return type is the same as the left-hand side type (T1), otherwise, the larger of the two types is returned. Only if the left and right-hand side types are both Boolean, the return type is also Boolean.

This operator can be overloaded for user-defined types.

Remarks

Usage


result = lhs Or rhs

Dialect Differences


  • In the -lang qb dialect, this operator cannot be overloaded.

Differences from QB


  • None

See also


Example


' Using the OR operator on two numeric values

Dim As UByte numeric_value1, numeric_value2

numeric_value1 = 15 '00001111

numeric_value2 = 30 '00011110



'Result =  31  =     00011111       

Print numeric_value1 Or numeric_value2

Sleep


' Using the OR operator on two conditional expressions

Dim As UByte numeric_value

numeric_value = 10



If numeric_value = 5 Or numeric_value = 10 Then Print "Numeric_Value equals 5 or 10"

Sleep



' This will output "Numeric_Value equals 5 or 10" because

' while the first condition of the first IF statement is false, the second is true


Reference

  • Documented in KeyPgOpOr.html