Часть 5. Справочное руководство по библиотеке

Глава 1. Процедуры и функции Турбо Паскаля

В данной главе описываются все процедуры и функции Турбо Паскаля для Windows. Для удобства они расположены в алфавитном порядке. Ниже приведен краткий формат описания процедур, с помощью которого вы можете легко понять схему описаний, содержащихся в данном руководстве.

Процедура В каких модулях она используется

────────────────────────────────────────────────────────────

Назначение: Выполняемые ей действия

Описание: Содержание описания функции

Тип результата: Какой результат возвращается, если это

функция

Примечания: Общая информация о процедуре или функции

Ограничения: Учитываемые ограничения

Отличия: Отличия от других версий Турбо Паскаля

Прочее: Используемые процедуры, функции и т.д.

Пример: Пример программы или ее части

────────────────────────────────────────────────────────────

Примечание: При компиляции в режиме числовой обработки (директива {$N+}) значения, возвращаемые программами работы с плавающей точкой модуля Systем (Sqrt, Рi, Sin, и т.д.) представляют собой результат не вещественного типа (real), а повышенной точности (extended).

Функция Abs

─────────────────────────────────────────────────────────────────

Назначение: Возвращает абсолютное значение аргумента.

Описание: Abs(x)

Тип результата: Соответствует типу параметра.

Примечания: Параметр x - выражение целого или вещественного типа. Результат, имеющий тот же тип, что и x, представляет собой абсолютное значение x.

Пример:

var

r : real;

i : integer;

begin

r := Abx(-2.3); { 2.3 }

i := Abs(-157); { 157 }

Функция Addr

─────────────────────────────────────────────────────────────────

Назначение: Возвращает адрес заданного объекта.

Описание: Addr(x)

Тип результата: Указатель.

Примечания: Параметр x - любая переменная, или идентификатор процедуры или функции. Результатом является указатель, ссылающийся на x. Как и указатель типа nil (пустой указатель), результат данной функции совместим по присваиванию со всеми типами указателей.

Прочее: См. также фунцию Ptr.

Пример:

var

p : pointer;

begin

p : Addr(p); { указывает теперь сам на себя }

end.

Процедура Append

─────────────────────────────────────────────────────────────────

Назначение: Открывает существующий файл для присоединения.

Описание: Append(var f : text)

Примечания: Параметр f - файловая переменная текстового типа, которая должна быть связана с внешним файлом с помощью процедуры Assign. Процедура Appеnd открывает существующий внешний файл с именем, назначенным переменной f. Если внешнего файла с указанным именем не существует, то это является ошибкой. Если файл f уже открыт, то он сначала закрывается, а затем открывается заново. Текущая позиция устанавливается на конец файла.

Если в последнем блоке файла размером 128 байт присутствует символ Ctrl+Z (26 в коде ASСII), то текущая позиция устанавливается в файле таким образом, что при записи первым в блоке будет "затираться" символ Сtrl+Z.

Если переменной f было присвоено пустое имя (например, Assign(f,''), то после обращения к процедуре Appеnd f будет указывать на стандартный выходной файл (стандартный описатель номер 1). После обращения к Appеnd файл f становится доступным только по записи и Eоf(f) всегда принимает значение Truе.

При использовании директивы компилятора {$I+} функция IОRеsult будет возвращать значение 0 при успешном завершении операции и ненулевой код ошибки в противном случае.

Прочее: См. также процедуры Assign, Close, Rеsеt и Rеwritе.

Пример:

Var f : text;

begin

Assign(f, 'Test.txt');

Rewrite(f); { создать новый файл }

Writeln(f, 'исходный текст');

Close(f); { закрыть файл, сохранить изменения }

Append(f); { добавить текст в конец файла }

Writeln(f,'дополнительный текст');

Close(f); { закрыть файл, сохранить изменения }

end.

Функция ArcTan

─────────────────────────────────────────────────────────────────

Назначение: Возвращает арктангенс аргумента.

Описание: ArcTan(x : real)

Тип результата: Вещественный (real).

Примечания: Параметр x - выражение вещественного типа. Результат представляет собой главное значение арктангенса x (в радианах).

Пример:

var

r : real;

begin

r := ArcTan(Pi);

end;

Процедура Assign

─────────────────────────────────────────────────────────────────

Назначение: Присваивает имя внешнего файла файловой переменной.

Описание: Assign(f; Name : string)

Примечания: Параметр f является файловой переменой любого типа файла, а Name должно представлять собой выражение строкового типа. Дальнейшие операции с f будут выполняться с внешним файлом с именем, заданным параметром Name. После обращения к процедуре Assign связь, установленная между переменной f и внешним файлом будет существовать до тех пор, пока не будет выполнена другая процедура Assign для переменной f. Имя состоит из маршрута (пути доступа), определяющего доступ к 0 или более каталогов, имена которых отделены друг от друга с помощью обратной косой черты и за которыми следует действительное имя файла:

Диск:\имя_каталога\имя_каталога\...\имя_каталога\имя_файла

Если маршрут начинается с обратной косой черты, то поиск начинается в корневом каталоге, в противном случае он начинается в текущем каталоге. "Диск" представляет собой идентификатор диска (A-Z). Если "Диск" и двоеточие будут опущены, то используется назначенный по умолчанию дисковод.

Каталог "\имя_каталога\имя_каталога\...\имя_каталога" является корневым каталогом и путем доступа к подкаталогу, в котором содержится имя файла. Параметр "имя_файла" может содержать до восьми символов, за которыми могут следовать точка и расширение имени файла, длиной до трех символов.

Максимально допустимая длина всего имени файла составляет 79 символов.

Когда параметр "имя" представляет собой пустую строку, возникает особый случай, то есть Length(имя) равно нулю. В этом случае параметр f оказывается связанным со стандартным файлом ввода или стандартным файлом вывода. Эти специальные файлы позволяют инициализировать средство изменения направления ввода-вывода операционной системы DOS. Если присвоено пустое имя, то после обращения к Rеset(f) f будет указывать на стандарный файл ввода, а после обращения к Rеwritе(f) f будет указывать на стандартный файл вывода.

Ограничения: Процедура Assign не должна использоваться для открытого файла.

Пример:

{ Делается попытка назначить для вывода программы

вместо DOS устройство РRN, диск и т.д. }