SpanExcluding

Description

Gets characters from a string, from the beginning to a character that is 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 in set.

Category

String functions

Function syntax

SpanExcluding(string, set)

See also

GetToken, SpanIncluding; Caching parts of ColdFusion pages in Designing and Optimizing a ColdFusion Application in ColdFusion MX Developer's Guide

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>

View comments in LiveDocs