MACROMEDIA COLFUSION MX 7-CFML, Reference

Page: 844 / 1108

844 Chapter 3: ColdFusion Functions
SpanExcluding
Description
Gets characters from a string
,
from the beginning to a character that is in a specified set of
characters. The search is case-sensitive.
Returns
A string; characters from string
,
from the beginning to a character that is in set .
Category
String functions
Function syntax
SpanExcluding ( string , set )
See also
GetToken
,
SpanIncluding
; “Caching parts of ColdFusion pages” in Chapter 13, “Designing and
Optimizing a ColdFusion Application,” in ColdFusion MX Developer’s Guide
Parameters
Example
<h3>SpanExcluding Example</h3>
<cfif IsDefined("FORM.myString")>
<p>Your string was <cfoutput>#FORM.myString#</cfoutput>
<p>Your set of characters was <cfoutput>#FORM.mySet#</cfoutput>
<p>Your string up until one of the characters in the set is:
<cfoutput>#
SpanExcluding(FORM.myString, FORM.mySet) #</cfoutput>
</cfif>
<p>Returns all characters from string from beginning to a character
from the set of characters. The search is case-sensitive.
<form method = post action = "spanexcluding.cfm">
<p>Enter a string:
<br><input type = "Text" name = "myString" value = "Hey, you!">
<p>And a set of characters:
<br><input type = "Text" name = "mySet" value = "Ey">
<br><input type = "Submit" name = "">
</form>
Parameter Description
string A string or a variable that contains one
set A string or a variable that contains one. Must contain one or more characters