Функция MLINE( )

Возвращает указанную строку memo-поля в виде символьной строки.

Синтаксис

MLINE(MemoFieldName, nLineNumber [, nNumberOfCharacters])

Параметры

MemoFieldName

Задает имя memo-поля, из которого функция MLINE( ) возвращает строку. Если memo-поле находится в таблице, которая открыта в рабочей области, отличной от текущей, поставьте перед именем memo-поля точку и псевдоним таблицы.

nLineNumber

Задает номер строки, которую нужно возвратить из memo-поля. Если номер nLineNumber отрицателен, равен 0 или больше общего числа строк memo-поля, возвращается пустая строка.

nNumberOfCharacters

Задает число символов, отсчитываемых от начала memo-поля, после которых MLINE( ) возвращает заданную строку.

Обычно в качестве nNumberOfCharacters используется системная переменная памяти _MLINE. Значение этой переменной автоматически регулируется при каждом вызове функции MLINE( ).

В рекурсивных процедурах, возвращающих строки из больших memo-полей, наивысшая производительность достигается в результате включения _MLINE в качестве nNumberOfCharacters.

Результат

Символьный

Комментарии

Функция MLINE( ) отсекает все концевые пробелы в строке, заданной параметром nLineNumber.

Длина и количество строк memo-поля определяются текущим значением установки SET MEMOWIDTH (по умолчанию длина строки составляет 50 символов). Если вст ечается возврат каретки, никакие дополнительные символы не возвращаются. Текущая установка _WRAP определяет способ отображения строки memo-поля.

Если вы ищете в memo-поле символьную строку, функцией ATLINE( ) или ATCLINE( ) можно получить номер строки, в которой найдена символьная строка. Используя тот номер в функции MLINE( ), можно возвратить содержимое нужной строки из memo-поля.