* information on heaptrc and env. variables (2.0+)

* some spelling mistakes fixes
  * FPC_HECK_OBJECT_EXT now gives runerror 219 and not 220
This commit is contained in:
carl 2002-10-10 15:50:44 +00:00
parent 4bf356ab09
commit 6c725f11e7

View File

@ -2466,6 +2466,10 @@ Call trace for block 0x0040FA50 size 128
\end{verbatim} \end{verbatim}
The output of the heaptrc unit is customizable by setting some variables. The output of the heaptrc unit is customizable by setting some variables.
\begin{ver2}
Output can also be customized using environment variables.
\end{ver2}
You can find more information about the usage of the \file{heaptrc} unit You can find more information about the usage of the \file{heaptrc} unit
in the \unitsref. in the \unitsref.
@ -3304,9 +3308,9 @@ Permission accessing the file is denied. This error might
be caused by several reasons: be caused by several reasons:
\begin{itemize} \begin{itemize}
\item Trying to open for writing a file which is \item Trying to open for writing a file which is
read only, or which is actually a directory. read only, or which is actually a directory.
\item File is currently locked byanother process. \item File is currently locked or used by another process.
\item Trying to create a new file, or directlry while a \item Trying to create a new file, or directory while a
file or directory of the same name already exists. file or directory of the same name already exists.
\item Trying to read from a file which was opened \item Trying to read from a file which was opened
in write only mode. in write only mode.
@ -3345,47 +3349,47 @@ Reported when the disk is full, and you're trying to write to it.
\item [102 File not assigned] \item [102 File not assigned]
This is reported by \var{Reset}, \var{Rewrite}, \var{Append}, This is reported by \var{Reset}, \var{Rewrite}, \var{Append},
\var{Rename} and var{Erase}, if you call \var{Rename} and \var{Erase}, if you call
them with an unassigned file as a parameter. them with an unassigned file as a parameter.
\item [103 File not open] \item [103 File not open]
Reported by the following functions : Close , Read, Write, Seek, Reported by the following functions : \var{Close, Read, Write, Seek,
EOf, FilePos, FileSize, Flush, BlockRead, and BlockWrite if the file is not EOf, FilePos, FileSize, Flush, BlockRead,} and \var{BlockWrite} if the
open. file is not open.
\item [104 File not open for input] \item [104 File not open for input]
Reported by Read, BlockRead, Eof, Eoln, SeekEof or SeekEoln if the file Reported by \var{Read, BlockRead, Eof, Eoln, SeekEof} or \var{SeekEoln} if
is not opened with Reset. the file is not opened with \var{Reset}.
\item [105 File not open for output] \item [105 File not open for output]
Reported by write if a text file isn't opened with Rewrite. Reported by write if a text file isn't opened with \var{Rewrite}.
\item [106 Invalid numeric format] \item [106 Invalid numeric format]
Reported when a non-numeric value is read from a text file, when a numeric Reported when a non-numeric value is read from a text file, when a numeric
value was expected. value was expected.
\item [150 Disk is write-protected] \item [150 Disk is write-protected]
(Critical error, \dos only.) (Critical error)
\item [151 Bad drive request struct length] \item [151 Bad drive request struct length]
(Critical error, \dos only.) (Critical error)
\item [152 Drive not ready] \item [152 Drive not ready]
(Critical error, \dos only.) (Critical error)
\item [154 CRC error in data] \item [154 CRC error in data]
(Critical error, \dos only.) (Critical error)
\item [156 Disk seek error] \item [156 Disk seek error]
(Critical error, \dos only.) (Critical error)
\item [157 Unknown media type] \item [157 Unknown media type]
(Critical error, \dos only.) (Critical error)
\item [158 Sector Not Found] \item [158 Sector Not Found]
(Critical error, \dos only.) (Critical error)
\item [159 Printer out of paper] \item [159 Printer out of paper]
(Critical error, \dos only.) (Critical error)
\item [160 Device write fault] \item [160 Device write fault]
(Critical error, \dos only.) (Critical error)
\item [161 Device read fault] \item [161 Device read fault]
(Critical error, \dos only.) (Critical error)
\item [162 Hardware failure] \item [162 Hardware failure]
(Critical error, \dos only.) (Critical error)
\item [200 Division by zero] \item [200 Division by zero]
The application attempted to divide a number by zero. The application attempted to divide a number by zero.
\item [201 Range check error] \item [201 Range check error]
@ -3394,7 +3398,7 @@ error in the following cases:
\begin{enumerate} \begin{enumerate}
\item An array was accessed with an index outside its declared range. \item An array was accessed with an index outside its declared range.
\item Trying to assign a value to a variable outside its range (for \item Trying to assign a value to a variable outside its range (for
instance a enumerated type). instance an enumerated type).
\end{enumerate} \end{enumerate}
\item [202 Stack overflow error] \item [202 Stack overflow error]
The stack has grown beyond its maximum size (in which case the size of The stack has grown beyond its maximum size (in which case the size of
@ -3402,15 +3406,15 @@ local variables should be reduced to avoid this error), or the stack has
become corrupt. This error is only reported when stack checking is enabled. become corrupt. This error is only reported when stack checking is enabled.
\item [203 Heap overflow error] \item [203 Heap overflow error]
The heap has grown beyond its boundaries. This is caused when trying to allocate The heap has grown beyond its boundaries. This is caused when trying to allocate
memory exlicitly with \var{new}, \var{getmem} or \var{reallocmem}, or when memory exlicitly with \var{New}, \var{GetMem} or \var{ReallocMem}, or when
a class or object instance is created and no memory is left. Please note a class or object instance is created and no memory is left. Please note
that, by default, \fpc provides a growing heap, i.e. the heap will that, by default, \fpc provides a growing heap, i.e. the heap will
try to allocate more memory if needed. However, if the heap has reached the try to allocate more memory if needed. However, if the heap has reached the
maximum size allowed by the operating system or hardware, then you will get maximum size allowed by the operating system or hardware, then you will get
this error. this error.
\item [204 Invalid pointer operation] \item [204 Invalid pointer operation]
This you will get if you call dispose or Freemem with an invalid pointer This you will get if you call \var{Dispose} or \var{Freemem} with an invalid
(notably, \var{Nil}) pointer (notably, \var{Nil})
\item [205 Floating point overflow] \item [205 Floating point overflow]
You are trying to use or produce too large real numbers. You are trying to use or produce too large real numbers.
\item [206 Floating point underflow] \item [206 Floating point underflow]
@ -3420,7 +3424,7 @@ Can occur if you try to calculate the square root or logarithm of a negative
number. number.
\item [210 Object not initialized] \item [210 Object not initialized]
When compiled with range checking on, a program will report this error if When compiled with range checking on, a program will report this error if
you call a virtal method without having initialized the VMT. you call a virtual method without having called istr constructor.
\item [211 Call to abstract method] \item [211 Call to abstract method]
Your program tried to execute an abstract virtual method. Abstract methods Your program tried to execute an abstract virtual method. Abstract methods
should be overridden, and the overriding method should be called. should be overridden, and the overriding method should be called.
@ -3449,16 +3453,20 @@ be caused by several problems:
\item [217 Unhandled exception occurred] \item [217 Unhandled exception occurred]
An exception occurred, and there was no exception handler present. An exception occurred, and there was no exception handler present.
The \file{sysutils} unit installs a default exception handler which catches The \var{sysutils} unit installs a default exception handler which catches
all excpetions and exits gracefully. all excpetions and exits gracefully.
\item [219 Invalid typecast] \item [219 Invalid typecast]
Thrown when an invalid typecast is attempted on a class using the \var{as} Thrown when an invalid typecast is attempted on a class using the \var{as}
operator. operator. This error is also thrown when an object or class is
typecast to an invalid class or object and a virtual method of
that class or object is called. This last error is only detected
if the \var{-CR} compiler option is used.
\item [227 Assertion failed error] \item [227 Assertion failed error]
An assertion failed, and no AssertErrorProc procedural variable was installed. An assertion failed, and no \var{AssertErrorProc} procedural variable was
installed.
\end{description} \end{description}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%