# AT()

Locates the position of a substring in a main string.

Syntax

  AT( <cSearch>, <cString>, [<nStart>], [<nEnd>] ) --> nPos

Arguments

  <cSearch> Substring to search for
  <cString> Main string
  <nStart> First position to search in cString, by default 1
  <nEnd> End posistion to search, by default cString length

Returns

  AT() return the starting position of the first occurrence of the substring in the main string

Description

  This function searches the string <cString> for the characters in the first string <cSearch>. If the substring is not contained within the second expression,the function will return 0. The third and fourth parameters lets you indicate a starting and end offset to search in.

Examples

          QOUT( "at( 'cde', 'abcdefgfedcba' ) = '" +;
          at( 'cde', 'abcsefgfedcba' ) + "'" )

Status

  Ready

Compliance

  This function is sensitive to HB_C52_STRICT settings during the compilation of source/rtl/at.c
  <nStart> and <nEnd> are Harbour extensions and do not exist if HB_C52_STRICT is defined. In that case, the whole string is searched.

Platforms

  All

Files

  Library is rtl

See Also

- RAT()