dBL Language Reference

dBASE
dBASEdBASE
release
2.0
for Windows® 95, 98, 2000,
VERSION 7.5
NT, ME and XP

dBASE, Inc.  Vestal, NY  Santa Cruz, CA

http://www.dbase.com  news://news.dbase.com
dBASE Inc. or Borland International may have patents and/or pending patent appli
cations covering subject matter in
this document. The furnishing of this document does not give you any license to
these patents.
COPYRIGHT © 1996 Borland International, 2000 dBASE Inc. All rights reserved. All d
BASE product names are
trademarks or registered trademarks of dBASE Inc. All Borland product names are
trademarks or registered
trademarks of Borland International, Inc. Other brand and product names are trad
emarks or registered trademarks
of their respective holders.
Printed in the U.S.A.
Contents Contents
Chapter 1
Introduction 1-1
How this book isorganized . . . . . . . . . . . . . 1-1
Typographical conventions . . . . . . . . . . . . . 1-2
Using the online version.. . . . . . . . . . . . . . 1-2
Chapter 2
Language definition 2-1
Basic attributes. . . . . . . . . . . . . . . . . . . . 2-1
Data types . . . . . . . . . . . . . . . . . . . . . . 2-2
Simple datatypes. . . . . . . . . . . . . . . . . 2-2
String data . . . . . . . . . . . . . . . . . .2-2
Numeric data . . . . . . . . . . . . . . . . . 2-2
Logical data. . . . . . . . . . . . . . . . . . 2-3
Date data . . . . . . . . . . . . . . . . . . . 2-3
Null values . . . . . . . . . . . . . . . . . . 2-3
Database-specific data types . . . . . . . . . . . 2-3
Memo data . . . . . . . . . . . . . . . . . . 2-3
Binary and OLE data. . . . . . . . . . . . . 2-4
Programming data types. . . . . . . . . . . . . 2-4
Operators and symbols. . . . . . . . . . . . . . . . 2-4
Names . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Expressions . . . . . . . . . . . . . . . . . . . . .2-5
Basic expressions. . . . . . . . . . . . . . . . . 2-5
Variables . . . . . . . . . . . . . . . . . . . . . 2-5
Assigning variables.. . . . . . . . . . . . . 2-5
Using variables and field names in expressions2-5
Type conversion . . . . . . . . . . . . . . . . . 2-6
Automatic type conversion . . . . . . . . . . 2-6
Explicit typeconversion . . . . . . . . . . . 2-6
Arrays . . . . . . . . . . . . . . . . . . . . . .2-6
Literal arrays . . . . . . . . . . . . . . . . . 2-6
Complex expressions. . . . . . . . . . . . . . . 2-7
Statements . . . . . . . . . . . . . . . . . . . . . . 2-7
Basic statements . . . . . . . . . . . . . . . . . 2-7
Control statements . . . . . . . . . . . . . . . . 2-8
Functions and codeblocks. . . . . . . . . . . . . . 2-8
Function pointers. . . . . . . . . . . . . . . . . 2-9
Codeblocks. . . . . . . . . . . . . . . . . . . . 2-9
Codeblocks vs. functions . . . . . . . . . . .2-10
Objectsand classes . . . . . . . . . . . . . . . . .2-10
Dynamic subclassing. . . . . . . . . . . . . . .2-10
Methods . . . . . . . . . . . . . . . . . . . . .2-11
A simple class . . . . . . . . . . . . . . . . . .2-11
Programs. . . . . . . . . . . . . . . . . . . . . . .2-11
Programfiles. . . . . . . . . . . . . . . . . . .2-11
Programexecution . . . . . . . . . . . . . . . .2-12
Functions and classes. . . . . . . . . . . . .2-12
Comments . . . . . . . . . . . . . . . . . . . .2-12
Preprocessor directives. . . . . . . . . . . . . .2-13
A simple program . . . . . . . . . . . . . . . .2-13
Chapter 3
Syntax conventions 3-1
Syntax notation . . . . . . . . . . . . . . . . . . .3-1
Syntax example . . . . . . . . . . . . . . . . . . . 3-2
Capitalization guidelines. . . . . . . . . . . . . . . 3-2
SET command defaults . . . . . . . . . . . . . . . 3-3
Chapter 4
Operators and symbols 4-1
Operatorprecedence . . . . . . . . . . . . . . . . .4-2
Assignment operators. . . . . . . . . . . . . . . . .4-2
+( plus )operator . . . . . . . . . . . . . . . . . .4-3
- ( minus ) operator . . . . . . . . . . . . . . . . .4-4
Numeric operators . . . . . . . . . . . . . . . . . .4-4
Logical operators . . . . . . . . . . . . . . . . . . .4-5
Comparisonoperators. . . . . . . . . . . . . . . . .4-6
Object operators . . . . . . . . . . . . . . . . . . .4-7
NEW operator. . . . . . . . . . . . . . . . . . .4-7
Index operator. . . . . . . . . . . . . . . . . . .4-8
Dot operator. . . . . . . . . . . . . . . . . . . .4-8
Scope resolution operator. . . . . . . . . . . . .4-8
Call, indirection, grouping operator . . . . . . . . . 4-9
Alias operator. . . . . . . . . . . . . . . . . . . . .4-9
Macro operator . . . . . . . . . . . . . . . . . . . 4-10
Non-operational symbols. . . . . . . . . . . . . . 4-12
String delimiters. . . . . . . . . . . . . . . . . 4-12
Name/database delimiters . . . . . . . . . . . . 4-12
Comment symbols. . . . . . . . . . . . . . . . 4-12
Statement separator, line continuation . . . . . 4-13
Codeblock, literal date, literal array symbol . . 4-13
Preprocessor directive symbol . . . . . . . . . 4-14
Chapter 5
Core language 5-1
class Designer. . . . . . . . . . . . . . . . . . . . .5-1
class Exception . . . . . . . . . . . . . . . . . . . .5-2
class Object . . . . . . . . . . . . . . . . . . . . . .5-3
ARGCOUNT(). . . . . . . . . . . . . . . . . . . .5-4
ARGVECTOR() . . . . . . . . . . . . . . . . . . .5-4
baseClassName . . . . . . . . . . . . . . . . . . . .5-4
CASE . . . . . . . . . . . . . . . . . . . . . . . . .5-5
CATCH. . . . . . . . . . . . . . . . . . . . . . . .5-5
CLASS . . . . . . . . . . . . . . . . . . . . . . . .5-5
className. . . . . . . . . . . . . . . . . . . . . . .5-6
CLEAR MEMORY . . . . . . . . . . . . . . . . .5-6
CLEAR PROGRAM. . . . . . . . . . . . . . . . .5-7
CLOSE PROCEDURE . . . . . . . . . . . . . . . .5-7
DEFINE. . . . . . . . . . . . . . . . . . . . . . . .5-7
DO . . . . . . . . . . . . . . . . . . . . . . . . . .5-8
DOCASE . . . . . . . . . . . . . . . . . . . . . 5-10
DOWHILE. . . . . . . . . . . . . . . . . . . . . 5-11
DO...UNTIL . . . . . . . . . . . . . . . . . . . . 5-12
ELSE. . . . . . . . . . . . . . . . . . . . . . . . 5-13
ELSEIF. . . . . . . . . . . . . . . . . . . . . . . 5-13
EMPTY(). . . . . . . . . . . . . . . . . . . . . . 5-13
ENUMERATE( ) . . . . . . . . . . . . . . . . . . 5-14
EXIT . . . . . . . . . . . . . . . . . . . . . . . . 5-15
FINALLY. . . . . . . . . . . . . . . . . . . . . . 5-15
FINDINSTANCE(). . . . . . . . . . . . . . . . . 5-15
FOR...ENDFOR . . . . . . . . . . . . . . . . . . 5-16
FUNCTION. . . . . . . . . . . . . . . . . . . . . 5-17
IF . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18
IIF() . . . . . . . . . . . . . . . . . . . . . . . . 5-19
LOCAL . . . . . . . . . . . . . . . . . . . . . . . 5-19
LOOP. . . . . . . . . . . . . . . . . . . . . . . . 5-20
i
OTHERWISE . . . . . . . . . . . . . . . . . . . .5-20
PARAMETERS . . . . . . . . . . . . . . . . . . .5-20
parent . . . . . . . . . . . . . . . . . . . . . . . .5-23
PCOUNT() . . . . . . . . . . . . . . . . . . . . .5-23
PRIVATE. . . . . . . . . . . . . . . . . . . . . . .5-24
PROCEDURE . . . . . . . . . . . . . . . . . . . .5-24
PUBLIC . . . . . . . . . . . . . . . . . . . . . . .5-25
QUIT . . . . . . . . . . . . . . . . . . . . . . . .5-25
REDEFINE . . . . . . . . . . . . . . . . . . . . .5-26
REFCOUNT().. . . . ... . . . .. . . . . .. .5-26
RELEASE. . . . . . . . . . . . . . . . . . . . . .5-26
RELEASE OBJECT . . . . . . . . . . . . . . . .5-27
RESTORE. . . . . . . . . . . . . . . . . . . . . .5-27
RETURN . . . . . . . . . . . . . . . . . . . . . .5-28
SAVE . . . . . . . . . . . . . . . . . . . . . . . .5-28
SET LIBRARY . . . . . . . . . . . . . . . . . . .5-29
SET PROCEDURE . . . . . . . . . . . . . . . . .5-29
SET() . . . . . . . . . . . . . . . . . . . . . . . .5-31
SETTO() . . . . . . . . . . . . . . . . . . . . . .5-31
STATIC . . . . . . . . . . . . . . . . . . . . . . .5-32
STORE . . . . . . . . . . . . . . . . . . . . . . .5-33
THROW . . . . . . . . . . . . . . . . . . . . . . .5-33
TRY . . . . . . . . . . . . . . . . . . . . . . . . .5-34
TYPE() . . . . . . . . . . . . . . . . . . . . . . .5-36
WITH . . . . . . . . . . . . . . . . . . . . . . . .5-38
Chapter 6
String objects 6-1
class String. . . . . . . . . . . . . . . . . . . . . . 6-1
ASC() . . . . . . . . . . . . . . . . . . . . . . . . 6-3
asc(). . . . . . . . . . . . . . . . . . . . . . . . . 6-3
AT(). . . . . . . . . . . . . . . . . . . . . . . . . 6-4
CENTER() . . . . . . . . . . . . . . . . . . . . .6-4
charAt(). . . . . . . . . . . . . . . . . . . . . . . 6-5
CHR() . . . . . . . . . . . . . . . . . . . . . . .6-5
chr(). . . . . . . . . . . . . . . . . . . . . . . . . 6-6
DIFFERENCE() . . . . . . . . . . . . . . . . . .6-6
getByte() . . . . . . . . . . . . . . . . . . . . . .6-6
indexOf() . . . . . . . . . . . . . . . . . . . . . . 6-7
ISALPHA() . . . . . . . . . . . . . . . . . . . . . 6-8
isAlpha() . . . . . . . . . . . . . . . . . . . . . .6-8
ISLOWER() . . . . . . . . . . . . . . . . . . . .6-8
isLower() . . . . . . . . . . . . . . . . . . . . . . 6-9
ISUPPER() . . . . . . . . . . . . . . . . . . . . . 6-9
isUpper() . . . . . . . . . . . . . . . . . . . . . . 6-9
lastIndexOf() . . . . . . . . . . . . . . . . . . . . 6-9
LEFT() . . . . . . . . . . . . . . . . . . . . . . .6-10
left(). . . . . . . . . . . . . . . . . . . . . . . . .6-10
leftTrim() . . . . . . . . . . . . . . . . . . . . . .6-11
LEN() . . . . . . . . . . . . . . . . . . . . . . . .6-11
length . . . . . . . . . . . . . . . . . . . . . . . .6-11
LENNUM( ) . . . . . . . . . . . . . . . . . . . . .6-11
LIKE() . . . . . . . . . . . . . . . . . . . . . . .6-12
LOWER() . . . . . . . . . . . . . . . . . . . . .6-12
LTRIM() . . . . . . . . . . . . . . . . . . . . . .6-13
PROPER() . . . . . . . . . . . . . . . . . . . . .6-13
RAT() . . . . . . . . . . . . . . . . . . . . . . . .6-13
REPLICATE() . . . . . . . . . . . . . . . . . . .6-14
replicate(). . . . . . . . . . . . . . . . . . . . . .6-15
RIGHT() . . . . . . . . . . . . . . . . . . . . . .6-15
right() . . . . . . . . . . . . . . . . . . . . . . . .6-15
rightTrim() . . . . . . . . . . . . . . . . . . . . .6-16
RTRIM() . . . . . . . . . . . . . . . . . . . . . . 6-16
setByte() . . . . . . . . . . . . . . . . . . . . . . 6-16
SOUNDEX() . .. . . . ... . . . ... . . . . 6-17
SPACE() . . . . . . . . . . . . . . . . . . . . . . 6-18
space(). . . . . . . . . . . . . . . . . . . . . . . 6-18
STR() . . . . . . . . . . . . . . . . . . . . . . . 6-18
STUFF() . . . . . . . . . . . . . . . . . . . . . . 6-19
stuff(). . . . . . . . . . . . . . . . . . . . . . . . 6-20
SUBSTR(). . . . . . . . . . . . . . . . . . . . . 6-20
substring() . . . . . . . . . . . . . . . . . . . . . 6-20
toLowerCase() . . . . . . . . . . . . . . . . . . . 6-21
toProperCase(). . . . . . . . . . . . . . . . . . . 6-21
toUpperCase() . . . . . . . . . . . . . . . . . . . 6-21
TRANSFORM(). . . . . . . . . . . . . . . . . . 6-21
TRIM() . . . . . . . . . . . . . . . . . . . . . . 6-22
UPPER() . . . . . . . . . . . . . . . . . . . . . . 6-22
VAL() . . . . . . . . . . . . . . . . . . . . . . . 6-23
Chapter 7
Math / Money 7-1
abs() . . . . . . . . . . . . . . . . . . . . . . . . .7-1
acos(). . . . . . . . . . . . . . . . . . . . . . . . .7-1
asin() . . . . . . . . . . . . . . . . . . . . . . . . .7-1
atan(). . . . . . . . . . . . . . . . . . . . . . . . .7-2
atan2() . . . . . . . . . . . . . . . . . . . . . . . .7-2
ceil(). . . . . . . . . . . . . . . . . . . . . . . . .7-3
cos() . . . . . . . . . . . . . . . . . . . . . . . . .7-3
dtor() . . . . . . . . . . . . . . . . . . . . . . . . .7-3
exp() . . . . . . . . . . . . . . . . . . . . . . . . .7-4
floor() . . . . . . . . . . . . . . . . . . . . . . . .7-4
FV() . . . . . . . . . . . . . . . . . . . . . . . . .7-4
int() . . . . . . . . . . . . . . . . . . . . . . . . .7-5
log() . . . . . . . . . . . . . . . . . . . . . . . . .7-5
log10() . . . . . . . . . . . . . . . . . . . . . . . .7-6
max() . . . . . . . . . . . . . . . . . . . . . . . .7-6
min() . . . . . . . . . . . . . . . . . . . . . . . . .7-6
MOD() . . . . . . . . . . . . . . . . . . . . . . . .7-7
PAYMENT() . . . . . . . . . . . . . . . . . . . . .7-7
PI() . . . . . . . . . . . . . . . . . . . . . . . . . .7-8
PV() . . . . . . . . . . . . . . . . . . . . . . . . .7-8
random() . . . . . . . . . . . . . . . . . . . . . . .7-9
round() . . . . . . . . . . . . . . . . . . . . . . . .7-9
rtod() . . . . . . . . . . . . . . . . . . . . . . . . 7-10
SET CURRENCY . . . . . . . . . . . . . . . . . 7-10
SET DECIMALS. . . . . . . . . . . . . . . . . . 7-11
SET POINT. . . . . . . . . . . . . . . . . . . . . 7-11
SET PRECISION.. . . . . . . . . . . . . . . . . 7-11
SET SEPARATOR . . . . . . . . . . . . . . . . . 7-12
SIGN() . . . . . . . . . . . . . . . . . . . . . . . 7-13
sin() . . . . . . . . . . . . . . . . . . . . . . . . 7-13
sqrt() . . . . . . . . . . . . . . . . . . . . . . . . 7-13
tan() . . . . . . . . . . . . . . . . . . . . . . . . 7-14
Chapter 8
Date and time objects 8-1
class Date . . . . . . . . . . . . . . . . . . . . . . .8-1
class Timer . . . . . . . . . . . . . . . . . . . . . .8-4
CDOW() . . . . . . . . . . . . . . . . . . . . . . .8-5
CMONTH() . . . . . . . . . . . . . . . . . . . . .8-5
CTOD() . . . . . . . . . . . . . . . . . . . . . . .8-6
CTODT( ). . . . . . . . . . . . . . . . . . . . . . .8-6
CTOT( ). . . . . . . . . . . . . . . . . . . . . . . .8-7
ii
DATE() . . . . . . . . . . . . . . . . . . . . . . . 8-7
DATETIME( ). . . . . . . . . . . . . . . . . . . . 8-7
DAY() . . . . . . . . . . . . . . . . . . . . . . . . 8-8
DMY() . . . . . . . . . . . . . . . . . . . . . . .8-8
DOW() . . . . . . . . . . . . . . . . . . . . . . .8-8
DTOC(). . . . . . . . . . . . . . . . . . . . . . . 8-9
DTODT( ) . . . . . . . . . . . . . . . . . . . . . . 8-9
DTOS() . . . . . . . . . . . . . . . . . . . . . . .8-10
DTTOC( ) . . . . . . . . . . . . . . . . . . . . . .8-10
DTTOD( ) . . . . . . . . . . . . . . . . . . . . . .8-10
DTTOT( ) . . . . . . . . . . . . . . . . . . . . . .8-11
ELAPSED() . . . . . . . . . . . . . . . . . . . .8-11
enabled. . . . . . . . . . . . . . . . . . . . . . . .8-12
getDate() . . . . . . . . . . . . . . . . . . . . . .8-12
getDay(). . . . . . . . . . . . . . . . . . . . . . .8-12
getHours() . . . . . . . . . . . . . . . . . . . . .8-13
getMinutes() . . . . . . . . . . . . . . . . . . . .8-13
getMonth() . . . . . . . . . . . . . . . . . . . . .8-14
getSeconds() . . . . . . . . . . . . . . . . . . . .8-14
getTime() . . . . . . . . . . . . . . . . . . . . . .8-14
getTimezoneOffset() . . . . . . . . . . . . . . . .8-15
getYear() . . . . . . . . . . . . . . . . . . . . . .8-15
interval . . . . . . . . . . . . . . . . . . . . . . . .8-16
MDY() . . . . . . . . . . . . . . . . . . . . . . .8-16
MONTH() . . . . . . . . . . . . . . . . . . . . .8-16
onTimer . . . . . . . . . . . . . . . . . . . . . . .8-17
parse() . . . . . . . . . . . . . . . . . . . . . . .8-18
SECONDS()... . . . ... . . . .. . . . . .. .8-18
SET CENTURY. . . . . . . . . . . . . . . . . . .8-18
SET DATE . . . . . . . . . . . . . . . . . . . . .8-19
SET DATE TO . . . . . . . . . . . . . . . . . . .8-20
SET EPOCH.. . . . . . . . . . . . . . . . . . . .8-20
SET HOURS... . . . ... . . . .. . . . . .. .8-20
SET MARK . . . . . . . . . . . . . . . . . . . . .8-20
SET TIME . . . . . . . . . . . . . . . . . . . . . .8-21
setDate() . . . . . . . . . . . . . . . . . . . . . .8-21
setHours() . . . . . . . . . . . . . . . . . . . . .8-21
setMinutes() . . . . . . . . . . . . . . . . . . . .8-22
setMonth() . . . . . . . . . . . . . . . . . . . . .8-22
setSeconds() . . . . . . . . . . . . . . . . . . . .8-22
setTime() . . . . . . . . . . . . . . . . . . . . . .8-22
setYear() . . . . . . . . . . . . . . . . . . . . . .8-23
TIME() . . . . . . . . . . . . . . . . . . . . . . .8-23
toGMTString() . . . . . . . . . . . . . . . . . . .8-23
toLocaleString() . . . . . . . . . . . . . . . . . .8-24
toString() . . . . . . . . . . . . . . . . . . . . . .8-24
TTIME( ). . . . . . . . . . . . . . . . . . . . . . .8-24
TTOC( ) . . . . . . . . . . . . . . . . . . . . . . .8-25
UTC(). . . . . . . . . . . . . . . . . . . . . . . .8-25
YEAR(). . . . . . . . . . . . . . . . . . . . . . .8-25
Chapter 9
Bitwise 9-1
BITAND() . . . . . . . . . . . . . . . . . . . . .9-1
BITLSHIFT() . . . . . . . . . . . . . . . . . . . . 9-2
BITNOT(). . . . . . . . . . . . . . . . . . . . . . 9-3
BITOR() . . . . . . . . . . . . . . . . . . . . . .9-3
BITRSHIFT() . . . . . . . . . . . . . . . . . . . . 9-3
BITSET() . . . . . . . . . . . . . . . . . . . . . . 9-4
BITXOR() . . . . . . . . . . . . . . . . . . . . .9-4
BITZRSHIFT() . . . . . . . . . . . . . . . . . . . 9-4
HTOI() . . . . . . . . . . . . . . . . . . . . . . .9-5
ITOH(). . . . . . . . . . . . . . . . . . . . . . . .9-5
Chapter 10
Array objects 10-1
Array functions . . . . . . . . . . . . . . . . . . . 10-1
class Array . . . . . . . . . . . . . . . . . . . . . 10-2
class AssocArray . . . . . . . . . . . . . . . . . . 10-4
ACOPY(). . . . . . . . . . . . . . . . . . . . . . 10-5
add() . . . . . . . . . . . . . . . . . . . . . . . . 10-6
ADEL(). . . . . . . . . . . . . . . . . . . . . . . 10-6
ADIR(). . . . . . . . . . . . . . . . . . . . . . . 10-9
AELEMENT() . . . . . . . . . . . . . . . . . . 10-10
AFIELDS(). . . . . . . . . . . . . . . . . . . . .10-11
AFILL() . . . . . . . . . . . . . . . . . . . . . 10-12
AGROW() . . . . . . . . . . . . . . . . . . . . 10-13
AINS(). . . . . . . . . . . . . . . . . . . . . . 10-14
ALEN(). . . . . . . . . . . . . . . . . . . . . . 10-17
ARESIZE(). . . . . . . . . . . . . . . . . . . . 10-17
ASCAN(). . . . . . . . . . . . . . . . . . . . . 10-20
ASORT(). . . . . . . . . . . . . . . . . . . . . 10-21
ASUBSCRIPT() . . . . . . . . . . . . . . . . . 10-23
count(). . . . . . . . . . . . . . . . . . . . . . 10-24
DECLARE . . . . . . . . . . . . . . . . . . . . 10-25
delete(). . . . . . . . . . . . . . . . . . . . . . 10-26
dimensions . . . . . . . . . . . . . . . . . . . . 10-28
dir() . . . . . . . . . . . . . . . . . . . . . . . 10-28
dirExt(). . . . . . . . . . . . . . . . . . . . . . 10-30
element() . . . . . . . . . . . . . . . . . . . . . 10-31
fields() . . . . . . . . . . . . . . . . . . . . . . 10-32
fill(). . . . . . . . . . . . . . . . . . . . . . . . 10-33
firstKey . . . . . . . . . . . . . . . . . . . . . . 10-34
getFile( ) . . . . . . . . . . . . . . . . . . . . . 10-34
grow() . . . . . . . . . . . . . . . . . . . . . . 10-35
insert(). . . . . . . . . . . . . . . . . . . . . . 10-37
isKey(). . . . . . . . . . . . . . . . . . . . . . 10-39
nextKey(). . . . . . . . . . . . . . . . . . . . . 10-39
removeAll(). . . . . . . . . . . . . . . . . . . . 10-40
removeKey() . . . . . . . . . . . . . . . . . . . 10-40
resize(). . . . . . . . . . . . . . . . . . . . . . 10-41
scan(). . . . . . . . . . . . . . . . . . . . . . . 10-44
size . . . . . . . . . . . . . . . . . . . . . . . . 10-45
sort() . . . . . . . . . . . . . . . . . . . . . . . 10-46
subscript() . . . . . . . . . . . . . . . . . . . . 10-48
Chapter 11
File/OS 11-1
File commands and functions. . . . . . . . . . . . 11-1
File utility commands . . . . . . . . . . . . . . 11-1
File information functions. . . . . . . . . . . . 11-1
Low-level filefunctions. . . . . . . . . . . . . 11-2
Dynamic External Objects - DEO . . . . . . . . . 11-2
Source Aliasing. . . . . . . . . . . . . . . . . . . 11-4
class File . . . . . . . . . . . . . . . . . . . . . . 11-5
! . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-7
accessDate() . . . . . . . . . . . . . . . . . . . . 11-7
CD . . . . . . . . . . . . . . . . . . . . . . . . . 11-8
close() . . . . . . . . . . . . . . . . . . . . . . . 11-8
copy() . . . . . . . . . . . . . . . . . . . . . . . 11-9
COPY FILE . . . . . . . . . . . . . . . . . . . .11-10
create() . . . . . . . . . . . . . . . . . . . . . .11-10
createDate() . . . . . . . . . . . . . . . . . . . .11-11
createTime() . . . . . . . . . . . . . . . . . . . .11-11
iii
date() . . . . . . . . . . . . . . . . . . . . . . . 11-12 BEGINTRANS(). . . . .
. . . . . . . . . . . . . 12-8
delete() . . . . . . . . . . . . . . . . . . . . . . 11-12 BINTYPE() . . . . . .
. . . . . . . . . . . . . . 12-9
DELETE FILE . . . . . . . . . . . . . . . . . . 11-13 BLANK . . . . .. . . . ...
. . . ... . . . . 12-9
DIR . . . . . . . . . . . . . . . . . . . . . . . . 11-13
DISKSPACE() . . . . . . . . . . . . . . . . . . 11-14
DISPLAY FILES . . . . . . . . . . . . . . . . . 11-14
DOS . . . . . . . . . . . . . . . . . . . . . . . . 11-14
eof(). . . . . . . . . . . . . . . . . . . . . . . . 11-15
ERASE . . . . . . . . . . . . . . . . . . . . . . 11-15
error(). . . . . . . . . . . . . . . . . . . . . . . 11-16
exists(). . . . . . . . . . . . . . . . . . . . . . . 11-16
FILE(). . . . . . . . . . . . . . . . . . . . . . . 11-17
flush() . . . . . . . . . . . . . . . . . . . . . . . 11-17
FNAMEMAX( ). . . . . . . . . . . . . . . . . . 11-18
FUNIQUE(). . . . . . . . . . . . . . . . . . . . 11-18
GETDIRECTORY() . . . . . . . . . . . . . . . 11-18
GETENV() . . . . . . . . . . . . . . . . . . . . 11-19
GETFILE() . . . . . . . . . . . . . . . . . . . . 11-19
gets() . . . . . . . . . . . . . . . . . . . . . . . 11-20
handle . . . . . . . . . . . . . . . . . . . . . . . 11-21
HOME(). . . . . . . . . . . . . . . . . . . . . . 11-21
LIST FILES . . . . . . . . . . . . . . . . . . . . 11-21
MD . . . . . . . . . . . . . . . . . . . . . . . . 11-22
MKDIR . . . . . . . . . . . . . . . . . . . . . . 11-22
open() . . . . . . . . . . . . . . . . . . . . . . . 11-22
OS(). . . . . . . . . . . . . . . . . . . . . . . . 11-23
C:\Program Files\dBASE\Plus\ . . . . . . . . . . 11-23
position. . . . . . . . . . . . . . . . . . . . . . . 11-24
PUTFILE() . . . . . . . . . . . . . . . . . . . . 11-24
puts() . . . . . . . . . . . . . . . . . . . . . . . 11-25
read() . . . . . . . . . . . . . . . . . . . . . . . 11-26
readln() . . . . . . . . . . . . . . . . . . . . . . 11-26
RENAME . . . . . . . . . . . . . . . . . . . . . 11-26
rename(). . . . . . . . . . . . . . . . . . . . . . 11-27
RUN. . . . . . . . . . . . . . . . . . . . . . . . 11-27
RUN() . . . . . . . . . . . . . . . . . . . . . . 11-28
seek() . . . . . . . . . . . . . . . . . . . . . . . 11-28
SET DIRECTORY. . . . . . . . . . . . . . . . . 11-29
SET FULLPATH . . . . . . . . . . . . . . . . . 11-29
SET PATH . . . . . . . . . . . . . . . . . . . . . 11-29
shortName(). . . . . . . . . . . . . . . . . . . . 11-30
size() . . . . . . . . . . . . . . . . . . . . . . . 11-30
time() . . . . . . . . . . . . . . . . . . . . . . . 11-30
TYPE . . . . . . . . . . . . . . . . . . . . . . . 11-31
VALIDDRIVE(). . . . . . . . . . . . . . . . . . 11-31
write(). . . . . . . . . . . . . . . . . . . . . . . 11-32
writeln(). . . . . . . . . . . . . . . . . . . . . . 11-33
_dbwinhome . . . . . . . . . . . . . . . . . . . . 11-33
Chapter 12
Xbase 12-1
Common command elements . . . . . . . . . . . .12-1
Filenames.. . . . . . . . . . . . . . . . . . . .12-1
Aliases . . . . . . . . . . . . . . . . . . . . . .12-2
Command scope . . . . . . . . . . . . . . . . .12-2
ALIAS() . . . . . . . . . . . . . . . . . . . . . .12-3
APPEND . . . . . . . . . . . . . . . . . . . . . .12-3
APPEND AUTOMEM . . . . . . . . . . . . . . .12-4
APPEND FROM . . . . . . . . . . . . . . . . . .12-5
APPEND FROM ARRAY . . . . . . . . . . . . .12-6
APPEND MEMO . . . . . . . . . . . . . . . . . .12-7
AVERAGE . . . . . . . . . . . . . . . . . . . . .12-8
BOF().. . . . . . . . . . . . . . . . . . . . . . 12-10
BOOKMARK() . . . . . . . . . . . . . . . . . .12-11
BROWSE . . . . . . . . . . . . . . . . . . . . .12-11
CALCULATE . . . . . . . . . . . . . . . . . . 12-13
CHANGE() . . . . . . . . . . . . . . . . . . . 12-14
CLEAR AUTOMEM . . . . . . . . . . . . . . 12-14
CLEAR FIELDS . . . . . . . . . . . . . . . . . 12-15
CLOSE DATABASES . . . . . . . . . . . . . . 12-15
CLOSE INDEXES. . . . . . . . . . . . . . . . 12-15
CLOSE TABLES . . . . . . . . . . . . . . . . . 12-15
COMMIT(). . . . . . . . . . . . . . . . . . . . 12-16
CONTINUE . . . . . . . . . . . . . . . . . . . 12-16
COPY . . . . . . . . . . . . . . . . . . . . . . 12-16
COPY BINARY . . . . . . . . . . . . . . . . . 12-18
COPY MEMO . . . . . . . . . . . . . . . . . . 12-18
COPY STRUCTURE . . . . . . . . . . . . . . 12-19
COPY STRUCTURE EXTENDED . . . . . . . 12-19
COPY TABLE . . . . . . . . . . . . . . . . . . 12-20
COPY TO ARRAY . . . . . . . . . . . . . . . 12-21
COUNT . . . . . . . . . . . . . . . . . . . . . 12-22
CREATE SESSION. . . . . . . . . . . . . . . . 12-23
CREATE...FROM . . . . . . . . . . . . . . . . 12-24
CREATE...STRUCTURE EXTENDED . . . . . 12-25
DATABASE() . . . . . . . . . . . . . . . . . . 12-25
DBF() . . . . . . . . . . . . . . . . . . . . . . 12-26
DELETE . . . . . . . . . . . . . . . . . . . . . 12-26
DELETE TABLE . . . . . . . . . . . . . . . . 12-27
DELETE TAG . . . . . . . . . . . . . . . . . . 12-27
DELETED() . . . . . . . . . . . . . . . . . . . 12-28
DESCENDING() . . . . . . . . . . . . . . . . 12-28
DISPLAY . . . . . . . . . . . . . . . . . . . . 12-28
EDIT . . . . . . . . . . . . . . . . . . . . . . . 12-29
EOF() . . . . . . . . . . . . . . . . . . . . . . 12-30
FDECIMAL() . . . . . . . . . . . . . . . . . . 12-30
FIELD() . . . . . . . . . . . . . . . . . . . . . 12-31
FLDCOUNT(). .. . . . ... . . . ... . . . 12-31
FLDLIST() . . . . . . . . . . . . . . . . . . . 12-32
FLENGTH() . . . . . . . . . . . . . . . . . . . 12-32
FLOCK() . . . . . . . . . . . . . . . . . . . . 12-33
FLUSH . . . . . . . . . . . . . . . . . . . . . . 12-33
FOR() . . . . . . . . . . . . . . . . . . . . . . 12-34
FOUND() . . . .. . . . ... . . . ... . . . 12-34
GENERATE . . . . . . . . . . . . . . . . . . . 12-35
GO . . . . . . . . . . . . . . . . . . . . . . . . 12-35
INDEX . . . . . . . . . . . . . . . . . . . . . . 12-36
ISBLANK() . . .. . . . ... . . . ... . . . 12-39
ISTABLE(). . . . . . . . . . . . . . . . . . . . 12-39
KEY() . . . . . . . . . . . . . . . . . . . . . . 12-39
KEYMATCH() . . . . . . . . . . . . . . . . . 12-40
LIST. . . . . . . . . . . . . . . . . . . . . . . . 12-41
LKSYS() . . . . . . . . . . . . . . . . . . . . . 12-41
LOCATE . . . . . . . . . . . . . . . . . . . . . 12-42
LOCK() . . . . . . . . . . . . . . . . . . . . . 12-43
LOOKUP() . . .. . . . ... . . . ... . . . 12-43
LUPDATE() . . . . . . . . . . . . . . . . . . . 12-44
MDX() . . . . . . . . . . . . . . . . . . . . . . 12-44
MEMLINES() . . . . . . . . . . . . . . . . . . 12-46
MLINE() . . . . . . . . . . . . . . . . . . . . . 12-46
NDX() . . . . . . . . . . . . . . . . . . . . . . 12-47
iv
ZAP . . . . . . . . . . . . . . . . . . . . . . . 12-84
ZAP . . . . . . . . . . . . . . . . . . . . . . . 12-84
Local SQL 13-1
Namingconventions . . . . . . . . . . . . . . . . 13-1
Tables . . . . . . . . . . . . . . . . . . . . . . 13-1
Columns. . . . . . . . . . . . . . . . . . . . . 13-2
Operators . . . . . . . . . . . . . . . . . . . . . . 13-2
Reserved words. . . . . . . . . . . . . . . . . . . 13-2
Datadefinition . . . . . . . . . . . . . . . . . . . 13-3
Datamanipulation . . . . . . . . . . . . . . . . . 13-4
Parameter substitutions in DML statements . . 13-4
Aggregate functions. . . . . . . . . . . . . . . 13-4
String functions. . . . . . . . . . . . . . . . . 13-4
Datefunction . . . . . . . . . . . . . . . . . . 13-5
Updatable queries . . . . . . . . . . . . . . . . 13-5
Restrictions on live queries . . . . . . . . . 13-5
Restrictions on live joins . . . . . . . . . . 13-6
Constraints.. . . . . . . . . . . . . . . . . 13-6
Statements supported . . . . . . . . . . . . . . . . 13-6
Chapter 14
Data objects 14-1
Understanding the data object hierarchy . . . . . . 14-1
Accessing tables. . . . . . . . . . . . . . . . . 14-2
Putting the data objects together. . . . . . . 14-2
Using stored procedures. . . . . . . . . . . . . 14-2
class Database. . . . . . . . . . . . . . . . . . . . 14-2
class DataModule. . . . . . . . . . . . . . . . . . 14-5
class DataModRef . . . . . . . . . . . . . . . . . 14-7
class DbError . . . . . . . . . . . . . . . . . . . . 14-8
class DbException . . . . . . . . . . . . . . . . . 14-8
class DbfField. . . . . . . . . . . . . . . . . . . . 14-9
class DBFIndex. . . . . . . . . . . . . . . . . . . 14-9
class Field. . . . . . . . . . . . . . . . . . . . . 14-10
class Index . . . . . . . . . . . . . . . . . . . . 14-12
class LockField . . . . . . . . . . . . . . . . . . 14-12
class Parameter . . . . . . . . . . . . . . . . . . 14-13
class PdxField. . . . . . . . . . . . . . . . . . . 14-14
class Query . . . . . . . . . . . . . . . . . . . . 14-15
class Rowset . . . . . . . . . . . . . . . . . . . 14-17
class Session . . . . . . . . . . . . . . . . . . . 14-21
class SqlField . . . . . . . . . . . . . . . . . . . 14-22
class StoredProc . . . . . . . . . . . . . . . . . 14-22
class TableDef . . . . . . . . . . . . . . . . . . 14-24
class UpdateSet . . . . . . . . . . . . . . . . . . 14-25
abandon() . . . . . . . . . . . . . . . . . . . . 14-26
abandonUpdates(). . . . . . . . . . . . . . . . 14-27
access(). . . . . . . . . . . . . . . . . . . . . . 14-27
active . . . . . . . . . . . . . . . . . . . . . . . 14-28
addPassword(). . . . . . . . . . . . . . . . . . 14-29
append() . . . . . . . . . . . . . . . . . . . . . 14-29
appendUpdate() . . . . . . . . . . . . . . . . . 14-30
applyFilter() . . . . . . . . . . . . . . . . . . . 14-30
applyLocate() . . . . . . . . . . . . . . . . . . 14-31
applyUpdates(). . . . . . . . . . . . . . . . . . 14-31
atFirst() . . . . . . . . . . . . . . . . . . . . . 14-32
atLast(). . . . . . . . . . . . . . . . . . . . . . 14-33
autoEdit . . . . . . . . . . . . . . . . . . . . . . 14-33
autoNullFields . . . . . . . . . . . . . . . . . . 14-33
beforeGetValue . . . . . . . . . . . . . . . . . . 14-34
beginAppend() . . . . . . . . . . . . . . . . . . 14-34
OPEN DATABASE . . . . . . . . . . . . . . .
ORDER() . . . . . . . . . . . . . . . . . . . .
PACK . . . . . . . . . . . . . . . . . . . . . .
RECALL . . . . . . . . . . . . . . . . . . . .
RECCOUNT() . . . . . . . . . . . . . . . . .
RECNO() . . . . . . . . . . . . . . . . . . . .
RECSIZE() . . . . . . . . . . . . . . . . . . .
REFRESH . . . . . . . . . . . . . . . . . . . .
REINDEX. . . . . . . . . . . . . . . . . . . .
RELATION() . . . . . . . . . . . . . . . . . .
RELEASE AUTOMEM . . . . . . . . . . . .
RENAME TABLE . . . . . . . . . . . . . . .
REPLACE . . . . . . . . . . . . . . . . . . . .
REPLACE AUTOMEM . . . . . . . . . . . .
REPLACE BINARY . . . . . . . . . . . . . .
REPLACE FROMARRAY. . . . . . . . . . .
REPLACE MEMO . . . . . . . . . . . . . . .
REPLACE OLE. . . . . . . . . . . . . . . . .
RLOCK() . . . . . . . . . . . . . . . . . . . .
ROLLBACK() . . . . . . . . . . . . . . . . .
SCAN . . . . . . . . . . . . . . . . . . . . . .
SEEK . . . . . . . . . . . . . . . . . . . . . .
SEEK() . . . . . . . . . . . . . . . . . . . . .
SELECT. . . . . . . . . . . . . . . . . . . . .
SELECT(). . . . . . . . . . . . . . . . . . . .
SET AUTOSAVE . . . . . . . . . . . . . . . .
SET DATABASE . . . . . . . . . . . . . . . .
SET DBTYPE. . . . . . . . . . . . . . . . . .
SET DELETED . . . . . . . . . . . . . . . . .
SET EXACT . . . . . . . . . . . . . . . . . .
SET EXCLUSIVE . . . . . . . . . . . . . . .
SET FIELDS . . . . . . . . . . . . . . . . . .
SET FILTER. . . . . . . . . . . . . . . . . . .
SET HEADINGS . . . . . . . . . . . . . . . .
SET INDEX . . . . . . . . . . . . . . . . . . .
SET KEYTO . . . . . . . . . . . . . . . . . .
SET LOCK . . . .