SPANINCLUDING |
Description Gets characters from a string, from the beginning to a character that is not in a specified set of characters. The search is case-sensitive.
Returns A string; characters from string, from the beginning to a character that is not in set.
Category String functions
Function syntax
    SpanIncluding(string, set)
See also GetToken, SpanExcluding; "Caching parts of ColdFusion pages"in Chapter 13, "Designing and Optimizing a ColdFusion Application," in ColdFusion MX Developer's Guide
Parameters
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>

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.