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>