Возвращает начальную позицию первого вхождения символьного выражения или memo-поля в другое символьное выражение или memo-поле, по отношению к позиции самого левого символа.
Синтаксис:
AT(cSearchExpression, cExpressionSearched [, nOccurrence])
Параметры:
cSearchExpression
Задает символьное выражение, которое функция AT( ) ищет в выражении cExpressionSearched.
cExpressionSearched
Задает символьное выражение, просматриваемое в поисках выражения cSearchExpression.
В качестве cSearchExpression и cExpressionSearched могут фигурировать memo-поля любого размера.
nOccurrence
Указывает, какое вхождение выражения cSearchExpression (первое, второе, третье и т.д.) ищется в выражении cExpressionSearched. По умолчанию функция AT( ) ищет первое вхождение cSearchExpression (nOccurrence = 1). Задавая nOccurrence, вы можете инициировать поиск различных вхождений cSearchExpression в выражение cExpressionSearched. AT( ) возвращает 0, если nOccurrence больше общего числа вхождений cSearchExpression в выражение cExpressionSearched.
Результат:
Числовой
Комментарии:
Функция AT( ) просматривает второе символьное выражение на предмет первого вхождения первого символьного выражения. Затем она возвращает целое число, указывающее позицию первого символа в найденном символьном выражении. Если символьное выражение не найдено, AT( ) возвращает 0.
Поиск, осуществляемый функцией AT( ), ведется с учетом регистра. Чтобы выполнить поиск без учета регистра, воспользуйтесь функцией ATC( ).
Пример:
STORE 'Now is the time for all good men' TO gcString STORE 'is the' TO gcFindString CLEAR ? AT(gcFindString,gcString) && Displays 5 STORE 'IS' TO gcFindString ? AT(gcFindString,gcString) && Displays 0, case-sensitive