Возвращает номер строки с первым вхождением символьного выражения или memo-поля в другое символьное выражение или memo-поле, считая от первой строки.
ATLINE(cSearchExpression, cExpressionSearched) |
Параметры
- cSearchExpression
-
Задает символьное выражение, которое Visual FoxPro ищет в выражении cExpressionSearched.
- cExpressionSearched
-
Задает символьное выражение, просматриваемое в поисках cSearchExpression.
В качестве cSearchExpression и cExpressionSearched могут фигурировать memo-поля любых размеров.
Чтобы получить всю символьную строку, содержащую найденное символьное выражение, используйте функцию MLINE( ).
Совет
Функция ATLINE( ) предлагает удобный способ просмотра memo-полей.
Возвращаемое значение
Numeric
Замечания
Функция ATLINE( ) просматривает второе символьное выражение в поисках первого символьного выражения. При этом принимается во внимание регистр символов этих выражений. Для поиска без учета регистра используйте функцию ATCLINE( ).
Если поиск завершается успешно, функция ATLINE( ) возвращает номер строки, в которой найдено выражение. Если поиск не приводит к успеху, ATLINE( ) возвращает 0.
Номер строки, возвращаемый функцией ATLINE( ), определяется установкой SET MEMOWIDTH, даже если cExpressionSearched не является memo-полем. Для более подробной информации смотрите Команда SET MEMOWIDTH.
Пример
Пример 1 ищет первое вхождение символьной строки в memo-поле, а затем выводит на экран имя и фамилию служащего и строку memo-поля, содержащую искомую строку.
Пример 2 показывает, как ширина memo-поля влияет на ATLINE( ).
![]() | |
---|---|
* Пример 1 CLOSE DATABASES OPEN DATABASE (HOME(2) + 'Data\testdata') USE employee && Open employee table CLEAR STORE 'Japanese' TO gcFindString && Case sensitive LOCATE FOR ATLINE(gcFindString, notes) != 0 ? First_Name ?? Last_Name ? MLINE(notes, ATLINE(gcFindString, notes)) * Пример 2 STORE '1234567890ABCDEFGHIJ' TO gcString SET MEMOWIDTH TO 20 ? ATLINE('AB', gcString) && Displays 1 SET MEMOWIDTH TO 10 ? ATLINE('AB', gcString) && Displays 2 |
Смотрите также
Справочное руководство
AT( ), функцияAT_C( ), функция
ATC( ), функция
ATCC( ), функция
ATCLINE( ), функция
LEFT( ), функция
RAT( ), функция
RATLINE( ), функция
RIGHT( ), функция
SUBSTR( ), функция
LEFTC( ), функция
RIGHTC( ), функция
SUBSTRC( ), функция
MLINE( ), функция
SET MEMOWIDTH, команда
$, оператор
OCCURS( ), функция
INLIST( ), функция
Прочие ресурсы
ФункцииСправочное руководство по языку (Visual FoxPro)