User Guide

ManualsBrandsMacromedia ManualsOtherCOLFUSION MX 7-CFML REFERENCE

331

332

333

334

335

336

337

338

339

340

cfprocessingdirective 335

Attributes

Usage

The cfprocssingdirective tag has limitations that depend on the attribute you use. For this

reason, Macromedia recommends that you include either the

pageencoding or

suppresswhitespace attribute in a cfprocessingdirective tag, not both. To specify both

values, use separate tags.

In a ColdFusion component (.cfc file), the

cfprocessingdirective tag must follow the

cfcomponent tag.

If you use the

pageEncoding attribute, the following rules apply:

• You must put the tag within the first 4096 bytes of a page. It can be positioned after a

cfsetting or cfsilent tag.

• If you use the tag on a page that includes other pages by using the cfinclude or cfmodule

tags, custom tag invocation, and so on, the tag has no effect on the included pages.

Attribute Req/Opt Default Description

suppressWhiteSpace Optional Boolean; whether to suppress white space

characters within the

cfprocessingdirective block

that are generated by CFML tags and often do not

affect HTML appearance. Does not affect any

white space in HTML code.

pageEncoding Optional Character

encoding

identified by

the page

byte order

mark, if any;

otherwise,

system

default

encoding

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

cfprocessing tag body. The value may be enclosed

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