MACROMEDIA COLDFUSION MX 61-CFML Reference page 272

Attributes
Attribute
suppressWhiteSpace Optional
pageEncoding
Usage
The
cfprocssingdirective
reason, Macromedia recommends that you include either the
suppresswhitespace
values, use separate tags.
If you use the
pageEncoding
•
You must put the tag within the first 4096 bytes of a page. It can be positioned after a
or
cfsetting
•
If you use the tag on a page that includes other pages by using the
tags, custom tag invocation, and so on, the tag has no effect on the included pages.
•
You cannot embed the tag within conditional logic, because the
evaluated when ColdFusion compiles a page (not when it executes the page). For example, the
following code has no effect at execution time, because the
already been evaluated:
<cfif dynEncoding is not "dynamic encoding is not possible">
<cfprocessingdirective pageencoding=#dynEncoding#>
</cfif>
•
If you have multiple
attribute, they must all specify the same value; if not, ColdFusion throws an error.
•
If you specify only the
•
ColdFusion accepts character encoding names that are supported by the Java platform. If an
invalid name is specified, ColdFusion throws an InvalidEncodingSpecification exception.
272 Chapter 2: ColdFusion Tags
Req/Opt Default
Optional Character
encoding
identified by
the page
byte order
mark, if any;
otherwise,
system
default
encoding
tag has limitations that depend on the attribute you use. For this
attribute in a
cfprocessingdirective
attribute, the following rules apply:
tag.
cfsilent
cfprocessingdirective
pageencoding
Description
Boolean; whether to suppress white space
characters within the
that are generated by CFML tags and often do not
affect HTML appearance. Does not affect any
white space in HTML code.
A string literal; cannot be a variable. Identifies the
character encoding of the current CFML page. This
attribute affects the entire page, not just the
tag body. The value may be enclosed
cfprocessing
in single or double quotation marks, or none.
The following list includes commonly used values::
• utf-8
• iso-8859-1
• windows-1252
• us-ascii
• shift_jis
• iso-2022-jp
• euc-jp
• euc-kr
• big5
• euc-cn
• utf-16
For more information on character encodings, see:
www.w3.org/International/O-charset.html.
pageencoding
cfprocessingdirective
tags in one page that specify the
attribute, do not use a separate end tag.
cfprocessingdirective
or
tag, not both. To specify both
or
cfinclude cfmodule
attribute is
pageEncoding
pageEncoding
block
tag has