CFML Reference Previous Up One Level Next Search
ColdFusion Functions


Replace

Description

Returns string with occurrences of substring1 replaced with substring2 in a specified scope.

Category

String functions

Syntax 

Replace(string, substring1, substring2 [, scope ])

See also

REFind, ReplaceNoCase, ReplaceList, REReplace

Parameters

Parameter
Description
string
 A string
substring1
 String to replace
substring2
 String that replaces occurrences of substring1
scope
 Defines how to complete the replace operation:
  • ONE    Replace only the first occurrence (default)
  • ALL    Replace all occurrences
Defines how to complete the replace operation:

Example 

<!--- This example shows the use of Replace --->
<html>
<head>
<title>
Replace Example
</title>
</head>
<body bgcolor = silver>
<H3>Replace Example</H3>

<P>The Replace function returns <I>string</I> with <I>substring1</I> 
replaced by <I>substring2</I> in the specified scope. This is a 
case-sensitive search.

<cfif IsDefined("FORM.MyString")>
<P>Your original string, <cfoutput>#FORM.MyString#</cfoutput>
<P>You wanted to replace the substring <cfoutput>#FORM.MySubstring1#
 </cfoutput>
with the substring <cfoutput>#FORM.MySubstring2#</cfoutput>.
<P>The result: <cfoutput>#Replace(FORM.myString,
FORM.MySubstring1, FORM.mySubString2)#</cfoutput>
</cfif>
...
Copyright © 2001, Macromedia Inc. All rights reserved. Previous Up Next Search