Click above to get retro games delivered to your door ever month!

AT()


Syntax:     AT(<expC1>, <expC2>)

Purpose:    To search a character string for the first instance of a
            specified substring and return the starting position as a
            numeric value.

Arguments:  <expC1> is the character string to locate.

            <expC2> is the character string to be searched.

Returns:    An integer numeric value.

            If the substring is contained within the target expression,
            AT() returns the starting character position of the
            substring.  If the substring is not found, AT() returns
            zero.

Usage:      AT() is a general purpose character string manipulation
            function.  Generally, you use AT() to determine the location
            of the first instance of a substring within a string when
            you need it as a numeric value.  If you only need to know
            whether a string is contained within another, use the $
            operator.

Library:    CLIPPER.LIB


----------------------------------- Examples -------------------------------

   ? AT("a", "abcde")         && Result: 1
   ? AT("bcd", "abcde")       && Result: 2
   ? AT("a", "bcde")          && Result: 0