User Guide
Chapter 2: ColdFusion Functions 519
SpanIncluding
Returns all characters from string from its beginning until it reaches a character that is
not included in the specified set of characters. The search is case-sensitive.
See also GetToken and SpanExcluding.
Syntax SpanIncluding(
string
,
set
)
string
Any string.
set
String containing one or more characters being sought.
Examples <!--- Displays SpanIncluding --->
<HTML>
<HEAD>
<TITLE>
SpanIncluding Example
</TITLE>
</HEAD>
<BODY BGCOLOR=silver>
<H3>SpanIncluding 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 all of the characters in the set have been
found is:
<CFOUTPUT>#SpanIncluding(FORM.myString, FORM.mySet)#</CFOUTPUT>
</CFIF>
<P>Returns all characters from string from
beginning until it all characters from the set
of characters have been found. The search is case-sensitive.
<FORM ACTION="spanincluding.cfm" METHOD="POST">
<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,H">
<BR><INPUT TYPE="Submit" NAME="">
</FORM>
</BODY>
</HTML>