Xbasic

ATC Function

Syntax

Position as N = ATC(C search_string,C string[,N occurrence])

Arguments

search_string

A character string.

string

The character string to examine for occurrences of search_string.

occurrence

Optional. Default = 1. The integer number specifying which occurrence to return. -1 Specifies the last occurrence of the search_string. If omitted, the first occurrence of the search_string will be returned. Numeric

Description

Returns the position where one string is found within another.

Discussion

ATC() returns a position integer indicating where the n th occurrence of the search_string begins in the string. If the search_string is not found, ATC() returns 0. n is specified through the occurence argument. Case insensitive. See AT() for a case-sensitive version of this function. Refer to the AT()function for more information and additional examples. The search_string argument is case sensitive.

Example

atc("dog",PRODUCT) -> 10, if PRODUCT contains "Dinky-Di Dog Food"
atc("def","ABCDEF") ->  4

See Also