View comments | RSS feed
Contents > CFML Reference > ColdFusion Functions > HTMLCodeFormat PreviousNext

HTMLCodeFormat

Replaces special characters in a string with their HTML-escaped equivalents and inserts <pre> and </pre> tags at the beginning and end of the string.

HTML-escaped string string, enclosed in <pre> and </pre> tags. Returns are removed from string. Special characters (> < " &) are escaped.

Display and formatting functions

HTMLCodeFormat(string [, version ])

HTMLEditFormat

Parameter

Description

string

A string or a variable that contains one.

version

HTML version to use: currently ignored.

  • -1: The latest implementation of HTML
  • 2.0: HTML 2.0 (Default)
  • 3.2: HTML 3.2

This function typically increases the length of a string. This can cause unpredictable results when performing certain string functions (Left, Right, and Mid, for example) against the expanded string.

The only difference between this function and HTMLEditFormat is that HTMLEditFormat does not surround the text in an HTML pre tag.

<!--- This example shows the effects of HTMLCodeFormat and 
      HTMLEditFormat. View it in your browser, then View it
      using your browser's the View Source command. --->
<cfset testString="This is a test
        & this is another 
<This text is in angle brackets>

Previous line was blank!!!">

<cfoutput>
    <h3>The text without processing</h3>
    #testString#<br>
    <h3>Using HTMLCodeFormat</h3>
    #HTMLCodeFormat(testString)#
    <h3>Using HTMLEditFormat</h3>
    #HTMLEditFormat(testString)#
</cfoutput>

Contents > CFML Reference > ColdFusion Functions > HTMLCodeFormat PreviousNext

ColdFusion 8 | ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX | Forums | Developer Center | Bug Reporting

Version 6.1

Comments are no longer accepted for ColdFusion MX 6.1. ColdFusion 8 is the current version.

Comments


RavenCecil said on Mar 19, 2004 at 3:19 PM :
"Returns are removed from string." This is not true, and thank Murphy, because if all the returns were removed and then wrapped in a <pre> tag, then the entire content of the tag would be on a single line!
ASMORGAN04 said on May 25, 2004 at 10:09 PM :
As far as I've tried, the returns are removed.

 

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/coldfusion/6.1/htmldocs/funct115.htm