3.5.7.35 SpanIncluding

Description

Extracts characters from the string strSource, starting with the first character that are in the set of characters identified by strExclude. If the first character of the string is not in the character set, then SpanIncluding returns an empty string. Otherwise, it returns a sequence of consecutive characters which are in the set. Case sensitive.

Syntax

string SpanIncluding(string strSource$, string strInclude$ )$

Parameters

strSource

is the string to search.

strInclude

is the string with a set of characters to include.

Return

A substring that contains characters in the string strSource that are in strInclude, beginning with the first character in the string and ending when a character is found in the string that is not in strInclude. SpanIncluding returns an empty substring if the first character in the string is not in the specified set.

Example

str1$= "cabinet";
str2$ = "acB";
SpanIncluding(str1$, str2$)$= ; //should return ca
//Notes: it is best to pass a string variable into this method,
//because in Labtalk method, string will always pass as Uppercase,
//but this method is case sensitive.

See Also

SpanExcluding