User Guide Cancel

WriteOutput

 

Description

Appends text to the page-output stream. This function writes to the page-output stream regardless of conditions established by the cfsetting tag.

Category

Other functionsSystem functionsData output functions

Function syntax

WriteOutput(string [,encodefor])
WriteOutput(string [,encodefor])
WriteOutput(string [,encodefor])

History

Introduced in ColdFusion 4.5

Parameters

Parameter

Description

string

A string or a variable that contains one.

encodefor

This parameter's functionality is similar to the ' encodeFor ' functions.

The valid values are html , htmlattribute , url , javascript, css , xml , xmlattribute , xpath , ldap , and dn . Based on the respective value, the encoding will be applied on the input string. This parameter is optional.

 

Returns

A Boolean.

See also

Usage

Within the cfquery and cfmail tags, this function does not output to the current page; it writes to the current SQL statement or mail text. Do not use WriteOutput within cfquery and cfmail. Although you can call this function anywhere within a page, it is most useful inside a cfscript block.

Example 1

<cfscript>
// encodeFor=url
writeoutput("encoding for url: ");
writeoutput("lorem ipsum _*&%^$%&@","url");
</cfscript>
<cfscript> // encodeFor=url writeoutput("encoding for url: "); writeoutput("lorem ipsum _*&%^$%&@","url"); </cfscript>
<cfscript>
    // encodeFor=url
    writeoutput("encoding for url: ");
    writeoutput("lorem ipsum _*&%^$%&@","url");
</cfscript>

Output

encoding for url: lorem+ipsum+_*%26%25%5E%24%25%26%40

Example 2

 

<cfscript>
// encodeFor=html
writeoutput("encoding for html: ");
writeoutput("lorem ipsum _*&%^$%&@","html");
</cfscript>
<cfscript> // encodeFor=html writeoutput("encoding for html: "); writeoutput("lorem ipsum _*&%^$%&@","html"); </cfscript>
<cfscript>
    // encodeFor=html
    writeoutput("encoding for html: ");
    writeoutput("lorem ipsum _*&%^$%&@","html");
</cfscript>

Output

encoding for html: lorem ipsum _*&%^$%&@

Example 3

 

<cfscript>
// encodeFor=css
writeoutput("encoding for css: ");
writeoutput("lorem ipsum _*&%^$%&@","css");
</cfscript>
<cfscript> // encodeFor=css writeoutput("encoding for css: "); writeoutput("lorem ipsum _*&%^$%&@","css"); </cfscript>
<cfscript>
    // encodeFor=css
    writeoutput("encoding for css: ");
    writeoutput("lorem ipsum _*&%^$%&@","css");
</cfscript>

Output

encoding for css: lorem\20 ipsum\20 \5f \2a \26 \25 \5e \24 \25 \26 \40

Get help faster and easier

New user?

Adobe MAX 25

Adobe MAX

The Creativity Conference

Oct 28–30 Los Angeles and online

Adobe MAX

The Creativity Conference

Oct 28–30 Los Angeles and online

Adobe MAX 25

Adobe MAX

The Creativity Conference

Oct 28–30 Los Angeles and online

Adobe MAX

The Creativity Conference

Oct 28–30 Los Angeles and online