Lscript.Pdf

Lot us Domino Designer
®

Version7

LotusScript Language Guide

G210-2374-00

Note: Before using this information and the product it supports, read the information in "Notices" at the end of this document.

First Edition (December, 2005)
This edition applies to IBM® Lotus® Domino® Designer 7 (product number L-GHUS-5RWNHM), and to all subsequent releases
and modifications, untilotherwise indicated in new editions.
© Copyright International Business Machines Corporation 1994, 2005. All rights reserved.
US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with
IBM Corp.

Contents
Chapter 1. Introduction to LotusScript. . 1
What is LotusScript? . . . .
Advantages of LotusScript . .
Working with scripts . . .Working in the script editor
Working with Lotus software .
Determining which product
Debugging applications . . .

.
.
.
.
.
file
.

.
.
.
.
.
is
.

..
..
..
..
..
being
..

..
..
..
..
..
used
..

.
.
.
.
.
.
.

.
.
.
.
.
.
.

1
1
2
3
4
4
5

Chapter 2. Script and Statement
Construction Rules . . . . . . . . . . 7
Statement constructionrules . . . . . . . . . 7
Example . . . . . . . . . . . . . . . 7
Literal number construction rules . . . . . . . 7
Literal string construction rules . . . . . . . . 8
Identifier construction rules . . . . . . . . . 9
Escape character for illegal identifiers . . . . . 9
Examples . . . . . . . . . . . . . . 9
Labels . . . . . . . . . . . . . . . . 9
Keywords . . . . . . . . . . . . . . .10
Alphabetical listing of LotusScript keywords . . 10
Special characters . . . . . . . . . . . . 13

Chapter 3. Data Types, Constants, and
Variables . . . . . . . . . . . . . . 17
Summary of LotusScript data types .
Data type conversion . . . . . .
Numeric operations . . . . .
Argument passing . . . . . .
Variant variables . . . . . . .
Explicit data type conversion . .
Automatic datatype conversion .
Constants and Variables . . . . .
Scope of declarations . . . . . .
Name conflicts and shadowing . .
Module scope . . . . . . .
Procedure scope . . . . . . .
Type or class scope . . . . . .
Constants . . . . . . . . . .
Built-in constants . . . . . .
Constants defined in LSCONST.LSS
Constants defined in LSPRVAL.LSS
Product-specific constants . . .
User-definedconstants . . . .
Variables . . . . . . . . . .
Declaring scalar variables explicitly
Declaring scalar variables implicitly
Examples of scalar variables . . .
Arrays . . . . . . . . . . .
Fixed arrays . . . . . . . .
Dynamic arrays . . . . . . .
Lists . . . . . . . . . . . .
Working with lists . . . . . .
Variants . . . . . . . . . .
Boolean values . . . . . . .

.
.
.
.
.
.
.
.
.
..
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
..
.
.
.
.
.
.
.
.
.

17
18
18
18
18
19
20
22
23
23
23
24
24
25
25
26
26
26
26
29
29
33
34
36
39
43
45
47
49
51

Dates/Time . . . .
Referring to Variants .

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

. 52
. 54

Chapter 4. Expressions and Operators
Overview of expressions and operators .
LotusScript operators . . . . . .Operator order of precedence . . . .
Examples . . . . . . . . . .
Table of numeric operators . . . .
Arithmetic Operators . . . . . . .
Exponentiation operator . . . . .
Negation operator . . . . . . .
Multiplication operator . . . . .
Division operator . . . . . . .
Integer division operator . . . . .
Mod operator. . . . . . . . .
Addition operator . . . . . . .
Subtraction operator . . . ....