MACROMEDIA COLDFUSION 5-CFML Service manual

Macromedia® Incorporated
CFML Reference
ColdFusion 5

Copyright Notice
© 2001 Macromedia Incorporated. All rights reserved.
This manual, as well as thesoftware describedin it,is furnished under license and
maybeusedorcopiedonlyinaccordancewiththetermsofsuchlicense.Thecontent
of thismanual is furnishedfor informational use only, is subject to change without
notice,and shouldnotbe construedasacommitment byMacromediaIncorporated.
Macromedia Incorporated assumes no responsibility or liability for any errors or
inaccuracies that may appear in this book.
Except as permitted by such license, no part of this publication may be reproduced,
stored in a retrieval system, or transmitted in any form or by any means, electronic,
mechanical, recording, or otherwise, without the prior written permission of
Macromedia Incorporated.
ColdFusion and HomeSite are federally registered trademarks of Macromedia
Incorporated. HomeSite, the ColdFusion logo and the Allaire logo are trademarks of
Macromedia Incorporated in the USA and other countries. Microsoft, Windows,
WindowsNT,Windows95,MicrosoftAccess,andFoxProareregisteredtrademarksof
Microsoft Corporation. Solaris is a trademark of Sun Microsystems Inc. UNIX is a
trademark of The Open Group. PostScript is a trademark of Adobe Systems Inc. All
other productsor namebrands are thetrademarks of their respective holders.
Part number: ZCF50MREF

Contents
About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
Intended Audience . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . . xvi
Developer Resources . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . . xvi
About ColdFusion Documentation. . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . xvii
Printed and online documentation set . . . . . . .. . . . . . . . . .. . . . . . .. . . . . xvii
Viewing online documentation . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . xvii
Printing ColdFusion documentation . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . xvii
Getting Answers. . . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . xviii
Contacting Macromedia . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . xviii
Chapter 1 ColdFusion Expressions: Operands, Operators
and Other Constructs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Elementsof ColdFusionExpressions . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . 2
Operands: data types, constants, and variables . . . . . . .. . . . . . . . . .. . . . . .. 2
Data typesof constants and variables . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . 2
Noteson date-and-time values .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . 5
Constants . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . 5
Variables . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . 6
Variable naming conventions . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . 6
ColdFusion variable types . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . 6
CGI Environment Variables . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . 13
Testing for CGI variables . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . 13
CGI server variables . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . 13
CGI client variables . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . 14
CGI client certificate variables . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . . 15
Operators . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . 16
Arithmetic operators . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . . 16
Booleanoperators . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . . 16
Decisionoperators . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . . 17
Shorthand notation for decision operators . . . . . .. . . . . . . . . .. . . . . . .. . . 17
String operators . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . 18
Operator precedence . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . . 18
Functions as Operators . . . . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . 19

iv Contents
Functionsyntax . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . . 19
Optional function arguments . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . 19
Pound Signs . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . 20
Pound signs in cfoutput tags . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . . 20
Pound signs in strings . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . 21
Pound signs in tag attribute values . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . 22
Pound signs in custom tag attribute values . . . . . .. . . . . . . . . .. . . . . . .. . . 22
Nestedpound signs . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . 22
Pound signs in general expressions . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . 23
Chapter 2 ColdFusion Tags . . . . . . . . . . . . . . . . . . . . . 25
Alphabetical List of ColdFusion Tags .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . . 26
New tagsin ColdFusion5 . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . 30
Forms tags . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . . 30
Database manipulation tags . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . 30
Data output tags . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . 30
Exception handling tags . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . . 30
Extensibility tags . . . . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . . 31
File management tags . . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . 31
Flow-control tags . . . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . . 31
InternetProtocol tags . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . . 31
Java servlet andJava object tags . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . 31
Page processing tags . . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . 31
Variable manipulation tags . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . 32
Web application frameworktags . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . 32
cfabort . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . 33
cfapplet . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . 35
cfapplication . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . . 37
cfassociate . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . 40
cfauthenticate . . . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . 41
cfbreak . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . 43
cfcache . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . 44
cfcol . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . 47
cfcollection . . . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . . 49
cfcontent . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . 52
cfcookie . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . 54
cfdirectory . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . 57
cfdump .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . 60
cferror . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . .. . 61
cfexecute . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . .. 65
cfexit . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . 67
cffile .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . .. . . . 70
cfform . . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . 85
cfflush . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . 89
cfftp .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . 91
cfgraph . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . .102
cfgraphdata . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 118
cfgrid . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 119

Contents v
How data isreturned from cfgrid . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 124
Using thehref attribute . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 126
cfgridcolumn . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 129
cfgridrow . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 136
cfgridupdate . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 137
cfheader . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 140
cfhtmlhead . . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 141
cfhttp . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 142
cfhttpparam . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 148
cfif/cfelseif/cfelse . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 150
cfimpersonate . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 152
cfinclude . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 154
cfindex . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. .155
cfinput . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . .159
cfinsert . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. .163
cfldap . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. .167
cflocation . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 173
cflock . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 174
cflog . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 181
cfloop . . . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . .183
cfmail . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. .192
cfmailparam . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 195
cfmodule . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 197
cfobject . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . .200
cfoutput . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 207
cfparam . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 209
cfpop . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . .211
cfprocessingdirective . . . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 215
cfprocparam . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 216
cfprocresult . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 220
cfquery . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . .222
cfqueryparam . . . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 228
cfregistry . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. .233
cfreport . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. .239
cfrethrow . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 241
cfsavecontent . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 243
cfschedule . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 244
cfscript . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . .247
cfsearch . . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 249
cfselect . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . .253
cfservlet . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. .256
cfservletparam . . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 258
cfset . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 260
cfsetting . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . .262
cfsilent . . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. .264
cfslider . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. .265
cfstoredproc . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 270
cfswitch/cfcase/cfdefaultcase . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 274
cftable . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . .276

vi Contents
cftextinput . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 278
cfthrow . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 282
cftransaction . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 284
cftree . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 287
cftreeitem . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 292
cftry cfcatch . . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . 296
cfupdate . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 301
cfwddx . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 305
Chapter 3 ColdFusion Functions . . . . . . . . . . . . . . . . 307
Alphabetical List of ColdFusion Functions . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 308
New functions in ColdFusion 5 . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 310
Array functions .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 310
Authentication functions . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 310
Conversion functions . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 310
Dateand time functions . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 311
Decisionfunctions . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 311
Display and formatting functions . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 311
Dynamic evaluation functions . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 312
International functions . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 312
List functions . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 312
Mathematicalfunctions . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 312
Query functions . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 313
String functions . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 313
Structurefunctions . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 314
Systemfunctions . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 314
Other functions . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 314
Abs . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 315
ACos . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . .316
ArrayAppend . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 318
ArrayAvg . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 319
ArrayClear . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 321
ArrayDeleteAt . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 322
ArrayInsertAt . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 323
ArrayIsEmpty . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 324
ArrayLen . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 325
ArrayMax . . . . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 326
ArrayMin . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 328
ArrayNew . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 330
ArrayPrepend . . . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 331
ArrayResize . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 332
ArraySet . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 333
ArraySort . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 334
ArraySum . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 335
ArraySwap . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 337
ArrayToList . . . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . 338
Asc . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 339
ASin . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 340

Contents vii
Atn . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 342
AuthenticatedContext . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . 343
AuthenticatedUser .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 344
BitAnd . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. .345
BitMaskClear . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 346
BitMaskRead . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 347
BitMaskSet . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 348
BitNot . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . .349
BitOr . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 350
BitSHLN .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 351
BitSHRN . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 352
BitXor . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. .353
Ceiling . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . .354
Chr . . . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 355
CJustify .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . .356
Compare . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 357
CompareNoCase . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 359
Cos . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 360
CreateDate . . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 361
CreateDateTime . . . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 363
CreateObject . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 365
CreateODBCDate . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 369
CreateODBCDateTime . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 371
CreateODBCTime . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 373
CreateTime . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 375
CreateTimeSpan . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 376
CreateUUID . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 378
DateAdd . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 379
DateCompare . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 381
DateConvert . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 384
DateDiff . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 387
DateFormat . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 389
DatePart . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 391
Day . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 393
DayOfWeek . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 395
DayOfWeekAsString . . . . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 397
DayOfYear . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 398
DaysInMonth . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 400
DaysInYear . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 401
DE (Delay Evaluation) . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 402
DecimalFormat . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 403
DecrementValue . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 404
Decrypt . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 405
DeleteClientVariable . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 406
DirectoryExists . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 407
DollarFormat . . . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 408
Duplicate . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 409
Encrypt . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 410
Evaluate . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 412

viii Contents
Exp . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 413
ExpandPath . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 414
FileExists . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 415
Find . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . 416
FindNoCase . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 417
FindOneOf . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 418
FirstDayOfMonth . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 419
Fix . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . . . . 420
FormatBaseN . . . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 421
GetBaseTagData . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 422
GetBaseTagList . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 423
GetBaseTemplatePath . . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 424
GetClientVariablesList . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 425
GetCurrentTemplatePath . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 426
GetDirectoryFromPath .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 427
GetException . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 428
GetFileFromPath . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 429
GetFunctionList . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 430
GetHttpRequestData . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 431
GetHttpTimeString . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 433
GetLocale . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 434
GetMetricData . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 436
GetProfileString . . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 438
GetTempDirectory . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 440
GetTempFile . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 441
GetTemplatePath . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 442
GetTickCount . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 443
GetTimeZoneInfo . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 444
GetToken . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 445
Hash . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . .446
Hour . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. .447
HTMLCodeFormat . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 448
HTMLEditFormat . . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 450
IIf . . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . . . . 452
IncrementValue . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 454
InputBaseN . . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 455
Insert . . . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 456
Int . . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . . . . 457
IsArray . . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . .458
IsAuthenticated . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 459
IsAuthorized . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 460
IsBinary . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 462
IsBoolean . . . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 463
IsCustomFunction . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 464
IsDate . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . .466
IsDebugMode . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 467
IsDefined . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 468
IsLeapYear . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 469
IsNumeric . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 470

Contents ix
IsNumericDate . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 471
IsProtected . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 472
IsQuery . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 475
IsSimpleValue . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 476
IsStruct . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. .477
IsWDDX . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 478
JavaCast . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 480
JSStringFormat . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 481
LCase . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. .482
Left . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . .. . . 483
Len . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 484
ListAppend . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 485
ListChangeDelims . . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 486
ListContains . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 487
ListContainsNoCase . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 489
ListDeleteAt . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 490
ListFind . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. .491
ListFindNoCase . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 493
ListFirst . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . .494
ListGetAt . . . . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 495
ListInsertAt . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 496
ListLast . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . .497
ListLen . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . .498
ListPrepend . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 499
ListQualify . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 500
ListRest . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . .502
ListSetAt . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 503
ListSort . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . .505
ListToArray . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 507
ListValueCount . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 508
ListValueCountNoCase . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 510
LJustify . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . .512
Log . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 513
Log10 . . . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. .514
LSCurrencyFormat . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 515
LSDateFormat . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 518
LSEuroCurrencyFormat . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 520
LSIsCurrency . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 523
LSIsDate . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 524
LSIsNumeric .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 525
LSNumberFormat . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 526
LSParseCurrency . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 529
LSParseDateTime . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 532
LSParseEuroCurrency . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 534
LSParseNumber . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 536
LSTimeFormat . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 537
LTrim . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. .539
Max . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 540
Mid . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 541

xContents
Min . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 542
Minute . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 543
Month . . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 544
MonthAsString . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 545
Now . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . .546
NumberFormat . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 547
ParagraphFormat . . . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 550
ParameterExists . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 551
ParseDateTime . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 552
Pi . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 554
PreserveSingleQuotes . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 555
Quarter . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 556
QueryAddColumn . . . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 557
QueryAddRow . . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 559
QueryNew . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 560
QuerySetCell . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 561
QuotedValueList . . . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 563
Rand . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . .564
Randomize . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 565
RandRange . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 566
REFind . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 567
REFindNoCase . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 570
RemoveChars . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 573
RepeatString . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 574
Replace . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 575
ReplaceList . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 576
ReplaceNoCase . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 578
REReplace . . . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 579
REReplaceNoCase . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 580
Reverse . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 581
Right . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 582
RJustify . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. .583
Round . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 584
RTrim . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . .585
Second . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 586
SetLocale . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 587
SetProfileString . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 589
SetVariable . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 591
Sgn . . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 593
Sin . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 594
SpanExcluding . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 595
SpanIncluding . . . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 596
Sqr . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 597
StripCR . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 598
StructAppend . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 599
StructClear . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 601
StructCopy . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 602
StructCount . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 606
StructDelete . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 607

Contents xi
StructFind . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 609
StructFindKey . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 610
StructFindValue . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 611
StructGet . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 612
StructInsert . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 613
StructIsEmpty . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 615
StructKeyArray . . . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 616
StructKeyExists . . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 619
StructKeyList . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 620
StructNew . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 623
StructSort . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 624
StructUpdate . . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 626
Tan . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 627
TimeFormat . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 628
ToBase64 . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 630
ToBinary . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 632
ToString . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 634
Trim . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 636
UCase . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . .637
URLDecode . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . 638
URLEncodedFormat . . . . . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 639
Val . . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . . . . 640
ValueList . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 641
Week . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. .642
WriteOutput . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 643
XMLFormat . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 644
Year . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 645
YesNoFormat . . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 646
Chapter 4 ColdFusion C++ CFX Reference . . . . . . . . 647
C++ Class Overview. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 648
CCFXException Class. . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 649
Class members . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 649
CCFXException::GetError . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 649
CCFXException::GetDiagnostics . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 649
CCFXQuery Class. . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 651
Class members . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 651
CCFXQuery::AddRow . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 651
CCFXQuery::GetColumns . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 652
CCFXQuery::GetData . . . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 652
CCFXQuery::GetName . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 653
CCFXQuery::GetRowCount . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 653
CCFXQuery::SetData . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 653
CCFXQuery::SetQueryString . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 654
CCFXQuery::SetTotalTime . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 654
CCFXRequest Class. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 655
Class Members . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 655

xii Contents
CCFXRequest::AddQuery . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 656
CCFXRequest::AttributeExists . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 656
CCFXRequest::CreateStringSet . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 657
CCFXRequest::Debug . . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 657
CCFXRequest::GetAttribute . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 658
CCFXRequest::GetAttributeList . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 658
CCFXRequest::GetCustomData . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 659
CCFXRequest::GetQuery . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 659
CCFXRequest::GetSetting . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 659
CCFXRequest::ReThrowException . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 660
CCFXRequest::SetCustomData . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 661
CCFXRequest::SetVariable . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 661
CCFXRequest::ThrowException . . . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 662
CCFXRequest::Write .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 662
CCFXRequest::WriteDebug . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 663
CCFXStringSet Class. .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 664
Class members . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 664
CCFXStringSet::AddString . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 664
CCFXStringSet::GetCount . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 664
CCFXStringSet::GetIndexForString . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 665
CCFXStringSet::GetString . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 665
Chapter 5 ColdFusion Java CFX Reference . . . . . . . 667
Overview ClassLibraries . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 668
CustomTag Interface . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 669
Methods . . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . 669
processRequest . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 669
Query Interface . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 670
Methods . . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . 670
addRow . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 670
getColumnIndex . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 671
getColumns . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 671
getData . . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 672
getName . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 672
getRowCount . . . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 673
setData . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 673
Request Interface. .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 675
Methods . . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . 675
attributeExists . . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 675
debug . . . . . . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 676
getAttribute . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 676
getAttributeList . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 677
getIntAttribute . . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 677
getQuery . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 678
getSetting . . . . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 678
Response Interface . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 680

Contents xiii
Methods . . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . 680
addQuery . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 680
setVariable . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 681
write . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 681
writeDebug . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 682
Debugging Classes Reference. . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . 683
DebugRequest . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 683
DebugResponse . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 683
DebugQuery . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 683
Chapter 6 WDDX JavaScript Objects . . . . . . . . . . . . . 685
JavaScript Object Overview. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . 686
WddxSerializer Object . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . 687
Functions . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 687
serialize . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 687
serializeVariable . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 688
serializeValue . . . . . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 688
write . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 689
WddxRecordset Object. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 691
Functions . . . . . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 691
addColumn . . . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . 691
addRows . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 692
getField . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . 692
getRowCount . . . . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 693
setField . . . . .. . . . . . .. . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . .. . . . . 693
wddxSerialize . . . . . . .. . . . . .. . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 694

xiv Contents

About This Book
TheCFML Reference is your primary ColdFusion Markup Language (CFML)reference
guide.Use this guide to learn about individual CFML tags and functions, as wellas
ColdFusion expressions, using JavaScript objects for WDDX in ColdFusion. You can
also find detailed references for Java and C++ CFX interfaces.
Contents
•Intended Audience................................................................................................... xvi
•Developer Resources................................................................................................ xvi
•About ColdFusion Documentation ....................................................................... xvii
•Getting Answers .....................................................................................................xviii
•Contacting Macromedia........................................................................................xviii

xvi About This Book
Intended Audience
The CFML Reference is intendedfor ColdFusiondevelopersbuilding pages and
writing CFMLcode.
Developer Resources
MacromediaCorporation is committed to setting the standard for customer support
in developer education, technical support, and professional services. The Web site is
designed to give you quick access to the entire range of online resources, as the
following table describes.
Resource Description URL
MacromediaWeb
site General information about Macromedia products and services www.macromedia.com/
Information on
ColdFusion Detailed product information on ColdFusion and related topics www.coldfusion.com/products/coldfusion/
Technical
Support Professional support programs that Macromedia offers. www.coldfusion.com/support/
ColdFusion
Support Forum Access to experienced ColdFusion developers through participation in the
Online Forums, where you can post
messages and read replies on many
subjects relating to ColdFusion.
http://forums.coldfusion.com/
coldfusionconf/
Installation
Support Support for installation-related issues for all Macromedia products www.coldfusion.com/support/installation/
Professional
Education Information about classes, on-site training, and online courses offered by
Macromedia
www.coldfusion.com/developer/training.cfm
Developer
Community All the resources that you need to stay on the cutting edge of ColdFusion
development, including online
discussion groups, Knowledge Base,
technical papers and more
www.coldfusion.com/developer/
ColdFusion Dev
Center Development tips, articles, documentation, and white papers www.allaire.com/developer/ coldfusionreferencedesk/
Macromedia
Alliance Connection with the growing network of solution providers, application
developers, resellers, and hosting
services creating solutions with
ColdFusion
www.coldfusion.com/partners/

About ColdFusion Documentation xvii
About ColdFusion Documentation
ColdFusion documentation is designed to provide support for the complete
spectrumof participants.Theprintandonlineversionsareorganizedtoallowyouto
quicklylocatetheinformationthatyouneed.TheColdFusion onlinedocumentation
is provided in HTML and Adobe Acrobat formats.
Printed and online documentation set
The ColdFusion documentation set consists of the following titles.
Viewing online documentation
All ColdFusiondocumentation is available onlinein HTML and Adobe Acrobat PDF
formats. To view the HTML documentation,openthe following URL on the Web
server running ColdFusion: http://localhost/coldfusion/docs/dochome.htm.
To view and print ColdFusion documentation in Acrobat format, open the following
URL on the Web server running ColdFusion: http://localhost/coldfusion/docs/
AcrobatDocs/index.htm.
Printing ColdFusion documentation
To read printed documentation, locate the AdobeAcrobat PDF files on theproduct
CD-ROM. The PDF files offer excellent print output.You can print an entire book or
individual sections.
Book Description
Installing and Configuring ColdFusion
Server Describes system installation and basic configuration for Windows NT, Windows 2000, Solaris, Linux, HP-UX.
Advanced ColdFusion Administration Describes how to connect your data sources to the ColdFusion
Server, configure security for your applications, and how to use
ClusterCATS to manage scalability, clustering, and
load-balancing for your site.
Developing ColdFusion Applications Describes how to use ColdFusion Server to develop your
dynamic Web applications, including retrieving and updating
your data, using structures, and forms.
CFML Reference Provides descriptions, syntax, usage, and code examples for all
ColdFusion tags, functions, and variables, including WDDX,
and references for both coding Java and C++ CFXs.
CFML Quick Reference A brief guide that shows the syntax of ColdFusion tags,
functions, and variables.

xviii About This Book
Getting Answers
Oneofthebest waysto solveparticular programmingproblems isto tapinto thevast
expertise of the ColdFusion developer communities on the ColdFusion Forums.
Otherdevelopersontheforumcanhelpyoufigureouthowtodojustaboutanything
with ColdFusion. The search facility can also help you search messages from the
previous 12 months, allowing youto learn how others have solved a problem that
you might be facing. The Forums is a great resource for learning ColdFusion, but it is
also a great place to see the ColdFusion developer community in action.
Contacting Macromedia
Corporate
headquarters Macromedia, Inc.
600 Townsend Street
San Francisco, CA 94103
Tel: [phone]
Fax: [phone]
Web: www.macromedia.com
Technical
support Telephone support is available Monday through Friday,
8 A.M. to 8 P.M. Eastern time(except holidays)
Toll Free: 888.939.2545 (U.S. and Canada)
Tel: [phone] (outside U.S. and Canada)
Postings to theColdFusionSupport Forum(http://
forums.coldfusion.com/DevConf/index.cfm) can be
made any time.
Sales Toll Free:888.939.2545
Tel: [phone]
Fax: [phone]
E-mail: [e-mail]@macromedia.com
Web: http://commerce.coldfusion.com/purchase/
index.cfm

Chapter 1
ColdFusion Expressions:
Operands, Operators and
Other Constructs
This chapter describesColdFusionexpressions — language constructs that let you
create sophisticated applications.
Contents
•Elements of ColdFusion Expressions ........................................................................2
•Variables.......................................................................................................................6
•CGI Environment Variables...................................................................................... 13
•Operators...................................................................................................................16
•Functions as Operators.............................................................................................19
•Pound Signs...............................................................................................................20

2 Chapter 1 ColdFusion Expressions: Operands, Operators and Other Constructs
Elements of ColdFusion Expressions
ColdFusion expressions consist of operands and operators.Operands are comprised
of constants and variables. Operators are the verbs that act on the operands;
functions are a form of operator. This chapter first describes the operands and then
describes the operators.
Operands: data types, constants, and variables
The sections on operands provide detailed information on the following:
•Data types of ColdFusion operands
•ColdFusion constants
•ColdFusion variables: naming conventions, types, scoping, and other details
Data types of constants and variables
InColdFusion, constants and variables have implied datatypes. The reason for the
term “implied”is that there are no variable declarations that define the scalar data
typeof a variable,asonefinds instaticallytypedlanguagessuchas Pascal.Whenever
you use a constant or set the value of a variable, the value you use has a type, such as
integer, real, orstring. For example,if you usecfset to create a variable AGE and set
its value to 62, theimplied data typeis integer. In addition tothese scalar types,
ColdFusion also supports lists, structures, and arrays. The following table describes
the types of variables and constants you can use in a ColdFusion application page.
Type Description
Integer Numbers with no decimal point. The lower limit for asigned integer is
-2,147,483,648, and the upper limit for a signed integer is
2,147,483,647.
If you specify an integer outside the limits, ColdFusion converts it to
a floating point value to avoid overflow. In doing so, ColdFusion
preserves the number’s magnitude. However, the conversion to
floating point comes at the expense of precision, since ColdFusion
has only a fixed number of bits to work with.
Real number Numbers with a decimal part. Also known as floating point numbers.
The range of ColdFusion numbers is approximately ±10300. Most
operations are accurate to 12 digits after the decimal point.
ColdFusion supports scientific notation; this means that you can
enter numbers in the form 3 E 16 and perform calculations on them.