Description
Gets characters from a string_,_ from the beginning and stops when it encounters any of the characters in a specified set of characters. The search is case sensitive. For example, SpanExcluding("MyString", "inS") excludes "String" from "MyString" and returns "My". Because, in the string "MyString", after "My", the character 'S' (which is present in the second string "inS") is encountered.
Returns
A string; characters from string, from the beginning to a character that is in set.
Category
Function syntax
SpanExcluding(string, set) |
See also
GetToken, SpanIncluding; 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 one |
set |
A string or a variable that contains one. Must contain one or more characters |
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> |
