PosChar Function

Format

i = poschar(pattern_string, source_string);

Description

The poschar function searches for a collection of characters, represented in a pattern_string, within a source_string. The function returns the beginning position of the first occurrence of the pattern string in the source string. Both arguments are string expressions, and they are case sensitive, meaning that "c" is recognized as different from "C".

Return Value

The function returns the position of the first occurrence of the pattern string, or if no characters from the pattern string are found, the function returns 0.

Examples

VALUE = poschar("L", "CHILDREN"); // VALUE will be 4; this is where the
// pattern string (the letter "L")
// occurs in the source string ("CHILDREN")

VALUE = poschar("LCN", "CHILDREN"); // VALUE will be 1; of the characters in the
// pattern string, "C" is the first character
// encountered in the source string, and it is
// found at position 1