Custom Tag: cf_trimvars
Version: 2.0
(c) 2004, Rizal Firmansyah, rizal.firmansyah@masrizal.com

Disclaimer:
This custom tag was written to help developers trim variables.

This custom tag comes with a very low price.
I believe the price of this custom tag is less than an average 1 hour programmers rate.
But by using this custom tag, you save lots of your valuable time writing code to trim each and every variables.
And because of its very low price (esp. comparing your rate and effort to trim all variables),
i would like to give a license to use this tag is for "1 copy per developer".
That means each developer must purchase a copy of this custom tag for his/her own use.

This custom tag also support trimming structure inside of structure.
For example if you have a structure that contains recordsets, or another child structures,
this custom tag will recursively trim all variables inside them too.

For full license and disclaimer about this tag, please read: license.txt
-------------------------------------------------------------------------------

cf_trimvars is a quick solution to trim and 'html escaped' structure variables, such as form and url variables.

*** Requirements: 
ColdFusion 5, MX and up

*** Usage:
<cf_trimvars structure = "Structure containing variables to trim and html escaped- mandatory, default: form and url" 
             exclude = "list of variables not to be trimmed"
             dontescape = "list of variables not to be html escaped">

*** Examples:
1. Trim and escape all URL and FORM variables. Just put below line in your application.cfm
<cf_trimvars structure="form,url">

2. Trim and escape all URL and FORM variables, except form.UploadFile as it contains uploaded file. 
Put below line in your application.cfm
<cf_trimvars structure="form,url" exclude="UploadFile">

3. Trim and escape all URL and FORM variables, except form.UploadFile cause it contains uploaded file, and HTMLText cause it contains HTML tags.
Put below line in your application.cfm
<cf_trimvars structure="form,url" exclude="UploadFile" dontescape="HTMLText">

4. Trim query result. 
<!--- query database for information --->
<cfquery name = "GetParks" dataSource = "cfsnippets">
SELECT   PARKNAME, REGION, STATE
FROM     Parks 
</cfquery>
<cf_trimvars structure="GetParks">

-------------------------------------------------------------------------------

Hope you find this tag useful.

Sincerely,
Rizal Firmansyah
<rizal.firmansyah@masrizal.com>