Table Of Content

BORLAND Turbo Pascaf$J Version 6.0 Library Reference BORLAND INTERNATIONAL. INC. 1800 GREEN HILLS ROAD P.O. BOX 660001. SCOTTS VALLEY. CA 95067-0001 Copyright © 1983, 1990 by Borland International. All rights reserved. All Borland products are trademarks or registered trademarks of Borland International, Inc. Other brand and product names are trademarks or registered trademarks of their respective holders. PRINTED IN THE USA. R2 10 9 8 7 6 5 4 3 2 1 c o s N T E N T Introduction 1 Dispose procedure ................... 23 What's in this manual .................. 1 DosExitCode function ................ 24 DosV ersion function ................. 24 Chapter 1 The run-time library 3 DrawPoly procedure ................. 25 Sample procedure. . . . . . . . . . . . . . . . . . . .. 3 DSeg function ....................... 26 Abs function ......................... 4 Ellipse procedure .................... 26 'Addr function ........................ 4 EnvCount function . . . . . . . . . . . . . . . . . .. 27 Append procedure .. . . . . . . . . . . . . . . . . .. 5 EnvStr function ...................... 27 Arc procedure ... . . . . . . . . . . . . . . . . . . . .. 6 Eof function (text files) . .. . .. . . . . .. . . .. 28 ArcTan function ...................... 6 Eof function (typed, untyped files) ..... 28 Assign procedure ..................... 7 Eoln function . . . . . . . . . . . . . . . . . . . . . . .. 29 AssignCrt procedure .................. 8 Erase procedure ..................... 29 Bar procedure ........................ 8 Exec procedure ...................... 30 Bar3D procedure. . . . . . . . . . . . . . . . . . . . .. 9 Exit procedure . . . . . . . . . . . . . . . . . . . . . .. 31 BlockRead procedure ................. 10 Exp function ........................ 32 BlockWrite procedure ................ 11 FExpand function . . . . . . . . . . . . . . . . . . .. 32 ChDir procedure. . . . . . . . . . . . . . . . . . . .. 12 FilePos function ..................... 33 Chr function ........................ 13 FileSize function ..................... 33 Circle procedure . . . . . . . . . . . . . . . . . . . .. 13 FillChar procedure . . . . . . . . . . . . . . . . . .. 34 ClearDevice procedure ............... 14 FillEllipse procedure ................. 34 ClearViewPort procedure ............. 14 FillPoly procedure ................... 35 Close procedure ..................... 15 FindFirst procedure .................. 36 CloseGraph procedure ................ 16 FindNext procedure .................. 37 ClrEol procedure .................... 16 FloodFill procedure .................. 37 ClrScr procedure . . . . . . . . . . . . . . . . . . . .. 17 Flushprocedure ..................... 39 Concat function ...................... 17 Frac function ........................ 39 Copy function ....................... 18 FreeMem procedure . . . . . . . . . . . . . . . . .. 40 Cos function ........................ 18 FSearch function . . . . . . . . . . . . . . . . . . . .. 40 CSeg function ....................... 19 FSplit procedure ..................... 41 Dec procedure . . . . . . . . . . . . . . . . . . . . . .. 19 GetArcCoords procedure ............. 42 Delay procedure . . . . . . . . . . . . . . . . . . . .. 20 GetAspectRatio procedure ............ 43 Delete procedure .................... 20 GetBkColor function ................. 44 DelLine procedure ................... 20 GetCBreak procedure ................ 45 DetectGraph procedure . . . . . . . . . . . . . .. 21 GetColor function . . . . . . . . . . . . . . . . . . .. 45 DiskFree function . . . . . . . . . . . . . . . . . . .. 22 GetDate procedure ................... 46 DiskSize function .................... 22 GetDefaultPalette function ............ 46 GetDir procedure .................... 47 Keep procedure ...................... 81 GetDriverName function. . . . . . . . . . . . .. 48 Key Pressed function ................. 82 GetEnv function ..................... 48 Length function ..................... 82 GetFAttr procedure .................. 49 Line procedure ...................... 83 GetFillPattern procedure .............. 50 LineRelprocedure ................... 84 GetFillSettings procedure ............. 51 LineTo procedure .................... 84 GetFTime procedure ................. 52 Ln function ......................... 85 GetGraphMode function . . . . . . . . . . . . .. 52 Lo function ......................... 86 GetImage procedure. . . . . . . . . . . . . . . . .. 54 LowVideo procedure . . . . . . . . . . . . . . . .. 86 GetIntVec procedure ................. 55 Markprocedure ..................... 86 GetLineSettings procedure ............ 55 MaxAvail function ................... 87 GetMaxColor function . . . . . . . . . . . . . . .. 56 MemAvail function. . . . . . . . . . . . . . . . . .. 88 GetMaxMode function . . . . . . . . . . . . . . .. 56 MkDir procedure .................... 88 GetMaxX function ................... 57 Move procedure ..................... 89 GetMaxY function ................... 58 MoveRelprocedure .................. 89 GetMem procedure .................. 58 MoveTo procedure ................... 90 GetModeName function .............. 59 MsDos procedure . . . . . . . . . . . . . . . . . . .. 91 GetModeRange procedure ............ 60 New procedure ...................... 91 GetPalette procedure ................. 60 NormV ideo procedure. . . . . . . . . . . . . . .. 92 GetPaletteSize function ............... 61 NoSound procedure .................. 92 GetPixel function .................... 62 Odd function . . . . . . . . . . . . . . . . . . . . . . .. 92 GetTextSettings procedure ............ 62 Ofs function . . . . . . . . . . . . . . . . . . . . . . . .. 93 GetTime procedure .................. 63 Ord function ........................ 93 GetVerify procedure ................. 64 OutText procedure . . . . . . . . . . . . . . . . . .. 93 GetViewSettings procedure ........... 64 OutTextXY procedure ................ 95 GetX function ....................... 65 OvrClearBuf procedure . . . . . . . . . . . . . .. 96 GetY function ....................... 66 OvrGetBuf function .................. 97 GotoXYprocedure ................... 67 OvrInit procedure. . . . . . . . . . . . . . . . . . .. 97 GraphDefaults procedure ............. 67 OvrInitEMS procedure ............... 98 GraphErrorMsg function. . . . . . . . . . . . .. 68 OvrSetBuf procedure . . . . . . . . . . . . . . . .. 99 GraphResult function. . . . . . . . . . . . . . . .. 68 PackTime procedure ................ 100 Halt procedure ...................... 70 ParamCount function ............... 100 Hi function . . . . . . . . . . . . . . . . . . . . . . . . .. 70 ParamStr function ................... 101 HighV ideo procedure ................ 71 Pi function ......................... 101 ImageSize function . . . . . . . . . . . . . . . . . .. 71 PieSlice procedure .................. 102 Inc procedure ....................... 72 Pos function. . . . . . . . . . . . . . . . . . . . . . .. 102 InitGraph procedure ................. 73 Pred function . . . . . . . . . . . . . . . . . . . . . .. 103 Insert procedure ..................... 75 Ptr function ........................ 103 InsLine procedure. . . . . . . . . . . . . . . . . . .. 75 PutImage procedure ................. 104 InstallUserDriver function ............ 76 PutPixel procedure .................. 106 InstallUserFont function .............. 79 Random function ................... 107 Int function ......................... 79 Randomize procedure ............... 107 Intr procedure ....................... 80 Read procedure (text files) ........... 108 IOResult function .................... 80 Read procedure (typed files) .......... 109 ii ReadKey function . . . . . . . . . . . . . . . . . .. 109 SetTextStyle procedure .............. 143 Readlnprocedure ................... 110 SetTime procedure .................. 144 Rectangle procedure. . . . . . . . . . . . . . . .. 111 SetUserCharSize procedure .......... 145 RegisterBGIdriver function . . . . . . . . . .. 112 SetVerify procedure ................. 146 RegisterBGIfont function . . . . . . . . . . . .. 113 SetViewPort procedure .............. 146 Release procedure ................... 116 SetVisualPage procedure ............. 148 Rename procedure .................. 116 SetWriteMode procedure ............ 149 Reset procedure .................... 117 Sin function ........................ 150 RestoreCrtMode procedure. . . . . . . . . .. 118 SizeOf function ....... . . . . . . . . . . . . .. 151 Rewrite procedure .................. 119 Sound procedure ................... 151 RmIJrrprocedure ................... 120 SPtr function ....................... 152 Round function ..................... -120 Sqr function . . . . . . . . . . . . . . . . . . . . . . .. 152 RunError procedure . . . . . . . . . . . . . . . .. 121 Sqrt function ....................... 152 Sector procedure . . . . . . . . . . . . . . . . . . .. 121 SSeg function . . . . . . . . . . . . . . . . . . . . . .. 152 Seekprocedure ..................... 122 Str procedure. . . . . . . . . . . . . . . . . . . . . .. 153 SeekEof function . . . . . . . . . . . . . . . . . . .. 123 Succ function . . . . . . . . . . . . . . . . . . . . . .. 153 SeekEoln function . . . . . . . . . . . . . . . . . .. 123 Swap function ...................... 154 Seg function . . . . . . . .. . . . . . . . . . . . . . .. 124 SwapVectors procedure .............. 154 SetActivePage procedure ............ 124 TextBackground procedure .......... 155 SetAllPalette procedure .............. 125 TextColor procedure ................ 155 SetAspectRatio procedure ............ 126 TextHeight function . . . . . . . . . . . . . . . .. 156 SetBkColor procedure ............... 127 TextMode procedure ................ 157 SetCBreak procedure ................ 128 TextWidth function ................. 159 SetColor procedure ................. 129 Trunc function ..................... 160 SetIJate procedure .................. 129 Truncate procedure ................. 160 SetFAttr procedure .................. 130 TypeOf function .................... 160 SetFillPattem procedure ............. 130 UnpackTime procedure. . . . . . . . . . . . .. 161 SetFillStyle procedure ............... 132 UpCase function .................... 161 SetFfime procedure . . . . . . . . . . . . . . . .. 133 Val procedure ...................... 161 SetGraphBufSize procedure .......... 133 WhereX function. . . . . . . . . . . . . . . . . . .. 162 SetGraphMode procedure . . . . . . . . . . .. 134 WhereY function. . . . . . . . . . . . . . . . . . .. 163 SetIntVec procedure . . . . . . . . . . . . . . . .. 136 Window procedure ................. 163 SetLineStyle procedure .............. 136 Write procedure (text files) ........... 164 SetPalette procedure ................ 137 Write procedure (typed files) ......... 166 SetRGBPalette procedure ............ 139 Writeln procedure .................. 166 SetTextBuf procedure ................ 140 Index 169 SetTextJustify procedure ............. 142 iii s T A B L E 1.1: Components of the output string ... 165 1.2: Components of the fixed-point string ........................... 165 iv N T R o D u c T o N This manual contains definitions of all the Turbo Pascal library routines, along with example program code to illustrate how to use most of these procedures and functions. The Users Guide tells you If you are new to Pascal programming, you should first read the how to use this product: the User's Guide. The introduction to that book details the many Ubrary Reference and the features of Turbo Pascal and summarizes the contents of all four Programmers Guide focus on Pascal and programming volumes in this manual set. In the User's Guide you'll also find issues. reference information on the IDE, the project manager, the editor, and the command-line compilers. The Programmer's Guide summarizes Turbo Pascal's implemen tation of the Pascal language and discusses some advanced pro gramming topics. Run-time and compile-time error messages are in Appendix A, "Error messages." What's in this manual Chapter 1: Run-time library is an alphabetical reference of all Turbo Pascal library procedures and functions. Each entry gives syntax, an operative description, return values if necessary, together with a reference list of related routines and an example that demonstrates how the routines are used. Introduction 2 Turbo Pascal Ubrary Reference c H A p T E R 1 The run-time library This chapter contains a detailed description of all the procedures and functions in Turbo Pascal. The following sample library lookup entry explains where to look for details about each Turbo Pascal procedure and function. Sample procedure Unit it occupies Function What it does Declaration How it's declared; italicized items are user-defined Result type What it returns if it's a function Remarks General information about the procedure or function Restrictions Special requirements or items to watch for See also Related procedures and functions Example { Here you'll find a sample program that shows the use of the procedure or function in that entry. } Chapter 7, The run-time library 3