Возвращает номер строки с первым вхождением символьного выражения или memo-поля, независимо от регистра символов в обоих выражениях (то есть прописные или строчные).

ATCLINE(cSearchExpression, cExpressionSearched)

Параметры

cSearchExpression

Задает символьное выражение, которое функция ATCLINE( ) ищет в выражении cExpressionSearched.

cExpressionSearched

Задает символьное выражение, просматриваемое в поисках выражения cSearchExpression.

В качестве cSearchExpression и cExpressionSearched могут фигурировать memo-поля любого размера. Для получения строки, содержащей найденное символьное выражение, пользуйтесь функцией MLINE( ).

NoteTip

Функция ATCLINE( ) предлагает удобный способ просмотра memo-полей.

Expand imageВозвращаемое значение

Числовое

Expand imageПримечания

Если поиск завершается успешно, функция ATCLINE( ) возвращает номер строки, содержащей первое символьное выражение. Если поиск не приводит к успеху, ATCLINE( ) возвращает 0.

Номер строки, возвращаемый функцией ATCLINE( ), определяется установкой SET MEMOWIDTH, даже если cExpressionSearched не является memo-полем. Подробнее об этом смотрите SET MEMOWIDTH.

Use ATLINE( ) to perform a case-sensitive search.

Expand imageПример

В Примере 1 ищется первое вхождение символьной строки в memo-поле, а затем на экран выводятся имя и фамилия служащего и строка с memo-полем для этой записи.

В Примере 2 демонстрируется, как ширина memo-поля влияет на ATCLINE().
  CopyCode imageCopy Code
* Example 1
CLOSE DATABASES
OPEN DATABASE (HOME(2) + 'Data\testdata')
USE employee  && Open employee table

CLEAR
STORE 'JAPANESE' TO gcFindString  && Case insensitive
LOCATE FOR ATCLINE(gcFindString, notes) != 0
? First_Name
?? Last_Name
? MLINE(notes, ATCLINE(gcFindString, notes))

* Example 2
STORE '1234567890ABCDEFGHIJ' TO gcString
SET MEMOWIDTH TO 20
? ATCLINE('AB', gcString)  && Displays 1
SET MEMOWIDTH TO 10
? ATCLINE('AB', gcString)  && Displays 2

Expand imageСмотрите также