SpanIncluding

Description

Gets characters from a string, from the beginning and stops when it encounters any character that is not in a specified set of characters. The search is case sensitive.

For example, SpanIncluding("mystring", "mystery") returns "mystr". Because, in the string "mystring", after "mystr", the character 'i' (which is not present in the second string "mystery") is encountered.

Returns

A string; characters from string, from the beginning to a character that is not in set.

Function syntax

SpanIncluding(string, set)

See also

GetToken, SpanExcluding; Caching parts of ColdFusion pages in the Developing ColdFusion Applications

Parameters

Parameter

Description

string

A string or a variable that contains the search string.

set

A string or a variable that contains a set of characters. Must contain one or more characters.

Example

<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, until the characters in the set have been found, is: 
<cfoutput>#SpanIncluding(FORM.myString, FORM.mySet)#</cfoutput> 
</cfif> 
 
<p>Returns characters of a string, from beginning to a character  
    that is not in set. 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>