Home
IBM Domino Designer Basic User Guide and Reference
Basic product usage information and programming language reference information.
LotusScript® Language
Welcome to the LotusScript® Language section of Domino® Designer Help.
Expressions and Operators
This chapter describes the set of LotusScript® operators, how they may be combined with operands to form expressions, and how those expressions are evaluated.
Logical Operators
You use the logical operators And, Or, Xor, Eqv, and Imp to perform two kinds of operations:
Xor operator (LotusScript® Language)
Performs a logical exclusion on two expressions.

IBM Domino Designer Basic User Guide and Reference
Basic product usage information and programming language reference information.
- Accessibility and keyboard shortcuts
  Accessibility features assist users who have a disability, such as restricted mobility or limited vision, to use information technology content successfully.
- Application Design
  Welcome to the Application Design section of Domino® Designer Help.
- Application Management
  Welcome to the Application Management section of Domino® Designer Help.
- Domino® Query Language
  Domino Query Language (DQL) is a facility running in Domino core allowing for a terse shorthand syntax for finding documents according to a wide variety of complexity of terms. It leverages existing design elements without the need to write detailed code to access them.
- Composite Applications - Design and Management
  Composite applications are a key element in a service-oriented architecture (SOA) and contextual collaboration strategy. The ability to create and edit composite applications lets you easily integrate different types of components and technologies.
- DB2® Access views
  Domino® Designer includes two types of design elements to assist you in managing data contained in DB2® enabled Notes® databases:
- Programming Overview and User Interface
  This section contains general guidelines and examples that show where to use Java, LotusScript, and the formula language.
- Formula Language
  This section documents the formula language.
- LotusScript® Language
  Welcome to the LotusScript® Language section of Domino® Designer Help.
  - Introduction to LotusScript®
    This chapter introduces LotusScript® and describes, in general terms, how to use the script editor to write and modify scripts, how to compile scripts, and how to use the debugger to locate problems in the logic of your applications.
  - Script and Statement Construction Rules
    This chapter describes the rules for writing the basic elements of a script in the LotusScript® language.
  - Data Types, Constants, and Variables
    This chapter provides information about LotusScript® constants and variables and the data types of the values that they can represent.
  - Expressions and Operators
    This chapter describes the set of LotusScript® operators, how they may be combined with operands to form expressions, and how those expressions are evaluated.
    - Overview of expressions and operators
      An operand is a language element that represents a value, and an operator is a language element that determines how the value of an expression is to be computed from its operand or operands. A unary operator performs an operation on a single operand, and a binary operator performs an operation on two operands. An expressionis a sequence of operators and operands that evaluates to a single value at run time.
    - Operator order of precedence
      You determine the value of an expression by the order in which the parts are evaluated. Operators with greater precedence are evaluated before operators with less precedence. Operators with the same precedence are evaluated from left to right.
    - Arithmetic operators in LotusScript®
      When an arithmetic expression contains a NULL operand, the expression as a whole evaluates to NULL.
    - Relational (comparison) operators
      Relational operators (also called comparison operators) compare two expressions.
    - Logical Operators
      You use the logical operators And, Or, Xor, Eqv, and Imp to perform two kinds of operations:
      - Bitwise Operators (LotusScript® Language)
        An expression consisting of the bitwise operator Not and a numeric operand evaluates to an Integer or Long value (or to NULL if the operand is NULL). This number is the result of reversing the values of the bits in the binary representation of the operand (one's complement).
      - Boolean Operators (Formula Language)
        An expression consisting of two operands and a Boolean operator evaluates to True if the expression is true, and False if it is false, unless one of the operands is NULL. In that case, the result may be NULL or True or False, depending on the operator and the operand. The possibilities are:
      - Not operator (LotusScript® Language)
        Performs logical negation on an expression. The Not operator has the effect of rounding its argument to the nearest integer, changing the sign, and subtracting 1.
      - And operator (LotusScript® Language)
        Performs a logical conjunction on two expressions. LotusScript® rounds to the nearest integer before performing the And operation.
      - Or operator (LotusScript® Language)
        Performs a logical disjunction on two expressions.
      - Xor operator (LotusScript® Language)
        Performs a logical exclusion on two expressions.
      - Eqv operator (LotusScript® Language)
        Performs a logical equivalence on two expressions.
      - Imp operator (LotusScript® Language)
        Performs a logical implication on two expressions.
    - Table of string operators
      You can use these operators in expressions whose operands represent string values:
    - Is operator (LotusScript® Language)
      Compares two object reference variables.
    - IsA operator (LotusScript® Language)
      Determines if an object reference variable is of a specified class or a class derived from the specified class.
  - Procedures: Functions, Subs, and Properties
  - File Handling
    This chapter describes file handling in the LotusScript® language.
  - Error Processing
    This chapter describes error processing in the LotusScript® language.
  - User-Defined Data Types and Classes
    This chapter describes two kinds of custom data structures that you can define in LotusScript®. Each can hold data of different types in a single data structure.
  - Managing Flow in Scripts
    The flow of execution of a script generally follows the sequence of statements in the script. This chapter describes the behavior of particular statements that alter the flow of execution.
  - Managing Asynchronous Web Agents in Domino®
    This chapter describes how to use multiple threads and synchronization to manage HTTP agents with Domino®.
  - Beyond Core LotusScript®
    This chapter discusses the role that LotusScript® plays with IBM® products, your operating environment, other programs, and interactive user applications.
  - LotusScript® Language Reference
    This chapter describes the use of statements, built-in functions, subs, data types, and directives in the LotusScript® language.
  - Language and Script Limits
    This appendix describes LotusScript® language limits of several kinds: for example, the legal ranges in data representation, the limits on numerical specifications within statements, and the maximum number of different kinds of elements that can be defined in a script.
  - Platform Differences
    The LotusScript® language and functionality on the UNIX™ platform, the Macintosh platform, and the OS/400® platform differ in various ways from the language and functionality described in the rest of this language reference. This appendix describes the differences.
  - LotusScript/REXX Integration
    This appendix provides an overview of REXX integration in the LotusScript® language.
  - LotusScript® Aliases
    This appendix lists the LotusScript® aliases and their equivalent text.
  - MIME Charset Names
  - Compile-time Error Messages
    This chapter describes the compile-time error messages in the LotusScript® language.
  - Run-time Error Messages
    This chapter describes the run-time error messages in the LotusScript® language.
- LotusScript/COM/OLE Classes
- Java/CORBA Classes
  This section documents the Java/CORBA classes.
- Lotus® Connectors
  Lotus® Connectors provide native access to a wide variety of DBMS products, ODBC, the platform File system, Enterprise Resource Planning systems, and Transaction Processing systems.
- Javadoc™ for Domino® Designer related APIs
  As part of providing additional Java™ reference documentation, Domino® Designer ships with a help plugin that contains Javadoc™ for additional Domino Designer related APIs.

Xor operator (LotusScript® Language)

Performs a logical exclusion on two expressions.

Syntax

expr1 Xor expr2

Elements

expr1, expr2

Any expressions. Their values must lie within the range for Long values.

Usage

The following table explains how LotusScript® determines the result of the Xor operation.


expr1	expr2	Result
TRUE	TRUE	FALSE
TRUE	FALSE	TRUE
FALSE	TRUE	TRUE
FALSE	FALSE	FALSE
TRUE	NULL	NULL
NULL	TRUE	NULL
FALSE	NULL	NULL
NULL	FALSE	NULL
NULL	NULL	NULL

In addition to performing a logical exclusion, the Xor operator compares identically positioned bits in two numeric expressions (known as a bit-wise comparison) and sets the corresponding bit in the result according to the following table.


Bit n in expr1	Bit n in expr2	Bit n in result
1	1	0
1	0	1
0	1	1
0	0	0

Example

' Boolean usage
Dim johnIsHere As Boolean, jimIsHere As Boolean
Dim oneButNotBothIsHere As Boolean
johnIsHere = TRUE
jimIsHere = FALSE
oneButNotBothIsHere = johnIsHere Xor jimIsHere
Print oneButNotBothIsHere         ' Prints True

' Bit-wise usage
Dim z As Integer, y As Integer
z% = &b11110000
y% = &b11001100
Print Bin$(z% Xor y%)              ' Prints 111100