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.
Category
Function syntax
SpanIncluding(string, set) |
See also
GetToken, SpanExcluding; Caching parts of ColdFusion pages in Optimizing ColdFusion applications 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> |
