RunError: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | A **RunError** is a low-level error emitted by the Free Pascal [[RTL|Run Time Library]]. | |
| 2 | 2 | ||
| 3 | - | ||
| 4 | - | ||
| 5 | - | ||
| 6 | - | ||
| 3 | + |  | |
| 7 | 4 | ||
| 8 | - | ||
| 9 | - | ||
| 10 | - | ||
| 11 | - | ||
| 12 | - | ||
| 13 | - | ||
| 14 | - | ||
| 15 | - | ||
| 16 | - | ||
| 17 | - | ||
| 18 | - | ||
| 19 | - | ||
| 20 | - | ||
| 21 | - | ||
| 22 | - | ||
| 23 | - | ||
| 24 | - | ||
| 25 | - | ||
| 26 | - | ||
| 27 | - | ||
| 28 | - | ||
| 29 | - | ||
| 30 | - | ||
| 31 | - | ||
| 32 | - | ||
| 33 | - | ||
| 34 | - | ||
| 35 | - | ||
| 36 | - | ||
| 37 | - | ||
| 38 | - | ||
| 39 | - | ||
| 40 | - | ||
| 41 | - | ||
| 42 | - | ||
| 43 | - | ||
| 44 | - | ||
| 45 | - | ||
| 46 | - | ||
| 47 | - | ||
| 48 | - | ||
| 49 | - | ||
| 50 | - | ||
| 51 | - | ||
| 52 | - | ||
| 53 | - | ||
| 54 | - | ||
| 55 | - | ||
| 56 | - | ||
| 57 | - | ||
| 58 | - | ||
| 59 | - | ||
| 60 | - | ||
| 61 | - | ||
| 62 | - | ||
| 63 | - | ||
| 64 | - | ||
| 65 | - | ||
| 66 | - | ||
| 67 | - | ||
| 68 | - | ||
| 69 | - | ||
| 70 | - | ||
| 71 | - | ||
| 72 | - | ||
| 73 | - | ||
| 74 | - | ||
| 75 | - | ||
| 76 | - | ||
| 77 | - | ||
| 78 | - | ||
| 79 | - | ||
| 80 | - | ||
| 81 | - | ||
| 82 | - | ||
| 83 | - | ||
| 84 | - | ||
| 85 | - | ||
| 86 | - | ||
| 87 | - | ||
| 88 | - | ||
| 89 | - | ||
| 90 | - | ||
| 91 | - | ||
| 92 | - | ||
| 93 | - | ||
| 94 | - | ||
| 95 | - | ||
| 96 | - | ||
| 97 | - | ||
| 98 | - | ||
| 99 | - | ||
| 100 | - | ||
| 101 | - | ||
| 102 | - | ||
| 103 | - | ||
| 104 | - | ||
| 105 | - | ||
| 106 | - | ||
| 107 | - | ||
| 108 | - | ||
| 109 | - | ||
| 110 | - | ||
| 111 | - | ||
| 112 | - | ||
| 113 | - | ||
| 114 | - | ||
| 115 | - | ||
| 116 | - | ||
| 117 | - | ||
| 118 | - | ||
| 119 | - | ||
| 120 | - | ||
| 121 | - | ||
| 122 | - | ||
| 123 | - | ||
| 124 | - | ||
| 125 | - | ||
| 126 | - | ||
| 127 | - | ||
| 128 | - | ||
| 129 | - | ||
| 130 | - | ||
| 131 | - | ||
| 132 | - | ||
| 133 | - | ||
| 134 | - | ||
| 135 | - | ||
| 136 | - | ||
| 137 | - | ||
| 138 | - | ||
| 139 | - | ||
| 140 | - | ||
| 141 | - | ||
| 142 | - | ||
| 143 | - | ||
| 144 | - | ||
| 145 | - | ||
| 146 | - | ||
| 147 | - | ||
| 148 | - | ||
| 149 | - | ||
| 150 | - | ||
| 151 | - | ||
| 152 | - | ||
| 153 | - | ||
| 154 | - | ||
| 155 | - | ||
| 156 | - | ||
| 157 | - | ||
| 158 | - | ||
| 159 | - | ||
| 160 | - | ||
| 161 | - | ||
| 162 | - | ||
| 163 | - | ||
| 164 | - | ||
| 165 | - | ||
| 166 | - | ||
| 167 | - | ||
| 168 | - | ||
| 169 | - | ||
| 170 | - | ||
| 171 | - | ||
| 172 | - | ||
| 173 | - | ||
| 174 | - | ||
| 175 | - | ||
| 176 | - | ||
| 177 | - | ||
| 178 | - | ||
| 179 | - | ||
| 180 | - | ||
| 181 | - | ||
| 182 | - | ||
| 183 | - | ||
| 184 | - | ||
| 185 | - | ||
| 186 | - | ||
| 187 | - | ||
| 188 | - | ||
| 189 | - | ||
| 190 | - | ||
| 191 | - | ||
| 192 | - | ||
| 193 | - | ||
| 194 | - | ||
| 195 | - | ||
| 196 | - | ||
| 197 | - | ||
| 198 | - | ||
| 199 | - | ||
| 200 | - | ||
| 201 | - | ||
| 202 | - | ||
| 203 | - | ||
| 204 | - | ||
| 205 | - | ||
| 206 | - | ||
| 207 | - | ||
| 208 | - | ||
| 209 | - | ||
| 210 | - | ||
| 211 | - | ||
| 212 | - | ||
| 213 | - | ||
| 214 | - | ||
| 215 | - | ||
| 216 | - | ||
| 217 | - | ||
| 218 | - | ||
| 219 | - | ||
| 220 | - | ||
| 221 | - | ||
| 222 | - | ||
| 223 | - | ||
| 224 | - | ||
| 225 | - | ||
| 226 | - | ||
| 227 | - | ||
| 228 | - | ||
| 229 | - | ||
| 230 | - | ||
| 231 | - | ||
| 232 | - | ||
| 233 | - | ||
| 234 | - | ||
| 235 | - | ||
| 236 | - | ||
| 237 | - | ||
| 238 | - | ||
| 239 | - | ||
| 240 | - | ||
| 241 | - | ||
| 242 | - | ||
| 243 | - | ||
| 244 | - | ||
| 245 | - | ||
| 246 | - | ||
| 247 | - | ||
| 248 | - | ||
| 249 | - | ||
| 250 | - | ||
| 251 | - | ||
| 252 | - | ||
| 253 | - | ||
| 254 | - | ||
| 255 | - | ||
| 256 | - | ||
| 257 | - | ||
| 258 | - | ||
| 259 | - | ||
| 260 | - | ||
| 261 | - | ||
| 262 | - | ||
| 263 | - | ||
| 264 | - | ||
| 265 | - | ||
| 266 | - | ||
| 267 | - | ||
| 268 | - | ||
| 269 | - | ||
| 270 | - | ||
| 271 | - | ||
| 272 | - | ||
| 273 | - | ||
| 274 | - | ||
| 275 | - | ||
| 276 | - | ||
| 277 | - | ||
| 278 | - | ||
| 279 | - | ||
| 280 | - | ||
| 281 | - | ||
| 282 | - | ||
| 283 | - | ||
| 284 | - | ||
| 285 | - | ||
| 286 | - | ||
| 287 | - | ||
| 288 | - | ||
| 289 | - | ||
| 290 | - | ||
| 291 | - | ||
| 292 | - | ||
| 293 | - | ||
| 294 | - | ||
| 295 | - | ||
| 296 | - | ||
| 297 | - | ||
| 298 | - | ||
| 299 | - | ||
| 300 | - | ||
| 301 | - | ||
| 302 | - | ||
| 303 | - | ||
| 304 | - | ||
| 305 | - | ||
| 306 | - | ||
| 307 | - | ||
| 308 | - | ||
| 309 | - | ||
| 310 | - | ||
| 311 | - | ||
| 312 | - | ||
| 313 | - | ||
| 314 | - | ||
| 315 | - | ||
| 5 | + | **\#** | |
| 6 | + | ||
| 7 | + | **Short description** | |
| 8 | + | ||
| 9 | + | **Explanation** | |
| 10 | + | ||
| 11 | + | 1 | |
| 12 | + | ||
| 13 | + | Invalid function number | |
| 14 | + | ||
| 15 | + | An invalid operating system call was attempted. | |
| 16 | + | ||
| 17 | + | 2 | |
| 18 | + | ||
| 19 | + | File not found | |
| 20 | + | ||
| 21 | + | Reported when trying to erase, rename or open a non-existent file. | |
| 22 | + | ||
| 23 | + | 3 | |
| 24 | + | ||
| 25 | + | Path not found | |
| 26 | + | ||
| 27 | + | Reported by the directory handling routines when a path does not exist or is invalid. Also reported when trying to access a non-existent file. | |
| 28 | + | ||
| 29 | + | 4 | |
| 30 | + | ||
| 31 | + | Too many open files | |
| 32 | + | ||
| 33 | + | The maximum number of files currently opened by your process has been reached. Certain operating systems limit the number of files which can be opened concurrently, and this error can occur when this limit has been reached. | |
| 34 | + | ||
| 35 | + | 5 | |
| 36 | + | ||
| 37 | + | File access denied | |
| 38 | + | ||
| 39 | + | Permission to access the file is denied. This error might be caused by one of several reasons: | |
| 40 | + | ||
| 41 | + | - Trying to open for writing a file which is read-only, or which is actually a directory. | |
| 42 | + | - File is currently locked or used by another process. | |
| 43 | + | - Trying to create a new file, or directory while a file or directory of the same name already exists. | |
| 44 | + | - Trying to read from a file which was opened in write-only mode. | |
| 45 | + | - Trying to write from a file which was opened in read-only mode. | |
| 46 | + | - Trying to remove a directory or file while it is not possible. | |
| 47 | + | - No permission to access the file or directory. | |
| 48 | + | ||
| 49 | + | 6 | |
| 50 | + | ||
| 51 | + | Invalid file handle | |
| 52 | + | ||
| 53 | + | If this happens, the file variable you are using is trashed; it indicates that your memory is corrupted. | |
| 54 | + | ||
| 55 | + | 12 | |
| 56 | + | ||
| 57 | + | Invalid file access code | |
| 58 | + | ||
| 59 | + | Reported when a reset or rewrite is called with an invalid FileMode value. | |
| 60 | + | ||
| 61 | + | 15 | |
| 62 | + | ||
| 63 | + | Invalid drive number | |
| 64 | + | ||
| 65 | + | The number given to the Getdir or ChDir function specifies a non-existent disk. | |
| 66 | + | ||
| 67 | + | 16 | |
| 68 | + | ||
| 69 | + | Cannot remove current directory | |
| 70 | + | ||
| 71 | + | Reported when trying to remove the currently active directory. | |
| 72 | + | ||
| 73 | + | 17 | |
| 74 | + | ||
| 75 | + | Cannot rename across drives | |
| 76 | + | ||
| 77 | + | You cannot rename a file such that it would end up on another disk or partition. | |
| 78 | + | ||
| 79 | + | 100 | |
| 80 | + | ||
| 81 | + | Disk read error | |
| 82 | + | ||
| 83 | + | An error occurred when reading from disk. Typically happens when you try to read past the end of a file. | |
| 84 | + | ||
| 85 | + | 101 | |
| 86 | + | ||
| 87 | + | Disk write error | |
| 88 | + | ||
| 89 | + | Reported when the disk is full, and you’re trying to write to it. | |
| 90 | + | ||
| 91 | + | 102 | |
| 92 | + | ||
| 93 | + | File not assigned | |
| 94 | + | ||
| 95 | + | This is reported by Reset, Rewrite, Append, Rename and Erase, if you call them with an unassigned file as a parameter. | |
| 96 | + | ||
| 97 | + | 103 | |
| 98 | + | ||
| 99 | + | File not open | |
| 100 | + | ||
| 101 | + | Reported by the following functions : Close, Read, Write, Seek, EOf, FilePos, FileSize, Flush, BlockRead, and BlockWrite if the file is not open. | |
| 102 | + | ||
| 103 | + | 104 | |
| 104 | + | ||
| 105 | + | File not open for input | |
| 106 | + | ||
| 107 | + | Reported by Read, BlockRead, Eof, Eoln, SeekEof or SeekEoln if the file is not opened with Reset. | |
| 108 | + | ||
| 109 | + | 105 | |
| 110 | + | ||
| 111 | + | File not open for output | |
| 112 | + | ||
| 113 | + | Reported by write if a text file isn’t opened with Rewrite. | |
| 114 | + | ||
| 115 | + | 106 | |
| 116 | + | ||
| 117 | + | Invalid numeric format | |
| 118 | + | ||
| 119 | + | Reported when a non-numeric value is read from a text file, and a numeric value was expected. | |
| 120 | + | ||
| 121 | + | 107 | |
| 122 | + | ||
| 123 | + | Invalid enumeration | |
| 124 | + | ||
| 125 | + | Reported when a text representation of an enumerated constant cannot be created in a call to str or write(ln). | |
| 126 | + | ||
| 127 | + | 150 | |
| 128 | + | ||
| 129 | + | Disk is write-protected | |
| 130 | + | ||
| 131 | + | (Critical error) | |
| 132 | + | ||
| 133 | + | 151 | |
| 134 | + | ||
| 135 | + | Bad drive request struct length | |
| 136 | + | ||
| 137 | + | (Critical error) | |
| 138 | + | ||
| 139 | + | 152 | |
| 140 | + | ||
| 141 | + | Drive not ready | |
| 142 | + | ||
| 143 | + | (Critical error) | |
| 144 | + | ||
| 145 | + | 154 | |
| 146 | + | ||
| 147 | + | CRC error in data | |
| 148 | + | ||
| 149 | + | (Critical error) | |
| 150 | + | ||
| 151 | + | 156 | |
| 152 | + | ||
| 153 | + | Disk seek error | |
| 154 | + | ||
| 155 | + | (Critical error) | |
| 156 | + | ||
| 157 | + | 157 | |
| 158 | + | ||
| 159 | + | Unknown media type | |
| 160 | + | ||
| 161 | + | (Critical error) | |
| 162 | + | ||
| 163 | + | 158 | |
| 164 | + | ||
| 165 | + | Sector Not Found | |
| 166 | + | ||
| 167 | + | (Critical error) | |
| 168 | + | ||
| 169 | + | 159 | |
| 170 | + | ||
| 171 | + | Printer out of paper | |
| 172 | + | ||
| 173 | + | (Critical error) | |
| 174 | + | ||
| 175 | + | 160 | |
| 176 | + | ||
| 177 | + | Device write fault | |
| 178 | + | ||
| 179 | + | (Critical error) | |
| 180 | + | ||
| 181 | + | 161 | |
| 182 | + | ||
| 183 | + | Device read fault | |
| 184 | + | ||
| 185 | + | (Critical error) | |
| 186 | + | ||
| 187 | + | 162 | |
| 188 | + | ||
| 189 | + | Hardware failure | |
| 190 | + | ||
| 191 | + | (Critical error) | |
| 192 | + | ||
| 193 | + | 200 | |
| 194 | + | ||
| 195 | + | Division by zero | |
| 196 | + | ||
| 197 | + | The application attempted to divide a number by zero. | |
| 198 | + | ||
| 199 | + | 201 | |
| 200 | + | ||
| 201 | + | Range check error | |
| 202 | + | ||
| 203 | + | If you compiled your program with range checking on, then you can get this error in the following cases: | |
| 204 | + | ||
| 205 | + | 1. An array was accessed with an index outside its declared range. | |
| 206 | + | 2. Trying to assign a value to a variable outside its range (for instance an enumerated type). | |
| 207 | + | ||
| 208 | + | 202 | |
| 209 | + | ||
| 210 | + | Stack overflow error | |
| 211 | + | ||
| 212 | + | The stack has grown beyond its maximum size (in which case the size of 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. | |
| 213 | + | ||
| 214 | + | 203 | |
| 215 | + | ||
| 216 | + | Heap overflow error | |
| 217 | + | ||
| 218 | + | The heap has grown beyond its boundaries. This is caused when trying to allocate memory explicitly with New, GetMem or ReallocMem, or when a class or object instance is created and no memory is left. Please note that, by default, Free Pascal provides a growing heap, i.e. the heap will 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 this error. | |
| 219 | + | ||
| 220 | + | 204 | |
| 221 | + | ||
| 222 | + | Invalid pointer operation | |
| 223 | + | ||
| 224 | + | You will get this in several cases: | |
| 225 | + | ||
| 226 | + | - if you call Dispose or Freemem with an invalid pointer | |
| 227 | + | - in case New or GetMem is called, and there is no more memory available. The behavior in this case depends on the setting of ReturnNilIfGrowHeapFails. If it is True, then Nil is returned. if False, then runerror 204 is raised. | |
| 228 | + | ||
| 229 | + | 205 | |
| 230 | + | ||
| 231 | + | Floating point overflow | |
| 232 | + | ||
| 233 | + | You are trying to use or produce real numbers that are too large. | |
| 234 | + | ||
| 235 | + | 206 | |
| 236 | + | ||
| 237 | + | Floating point underflow | |
| 238 | + | ||
| 239 | + | You are trying to use or produce real numbers that are too small. | |
| 240 | + | ||
| 241 | + | 207 | |
| 242 | + | ||
| 243 | + | Invalid floating point operation | |
| 244 | + | ||
| 245 | + | Can occur if you try to calculate the square root or logarithm of a negative number. | |
| 246 | + | ||
| 247 | + | 210 | |
| 248 | + | ||
| 249 | + | Object not initialized | |
| 250 | + | ||
| 251 | + | When compiled with range checking on, a program will report this error if you call a virtual method without having called its object’s constructor. | |
| 252 | + | ||
| 253 | + | 211 | |
| 254 | + | ||
| 255 | + | Call to abstract method | |
| 256 | + | ||
| 257 | + | Your program tried to execute an abstract virtual method. Abstract methods should be overridden, and the overriding method should be called. | |
| 258 | + | ||
| 259 | + | 212 | |
| 260 | + | ||
| 261 | + | Stream registration error | |
| 262 | + | ||
| 263 | + | This occurs when an invalid type is registered in the objects unit. | |
| 264 | + | ||
| 265 | + | 213 | |
| 266 | + | ||
| 267 | + | Collection index out of range | |
| 268 | + | ||
| 269 | + | You are trying to access a collection item with an invalid index (objects unit). | |
| 270 | + | ||
| 271 | + | 214 | |
| 272 | + | ||
| 273 | + | Collection overflow error | |
| 274 | + | ||
| 275 | + | The collection has reached its maximal size, and you are trying to add another element (objects unit). | |
| 276 | + | ||
| 277 | + | 215 | |
| 278 | + | ||
| 279 | + | Arithmetic overflow error | |
| 280 | + | ||
| 281 | + | This error is reported when the result of an arithmetic operation is outside of its supported range. Contrary to Turbo Pascal, this error is only reported for 32-bit or 64-bit arithmetic overflows. This is due to the fact that everything is converted to 32-bit or 64-bit before doing the actual arithmetic operation. | |
| 282 | + | ||
| 283 | + | 216 | |
| 284 | + | ||
| 285 | + | [[General Protection fault]] | |
| 286 | + | ||
| 287 | + | The application tried to access invalid memory space. This can be caused by several problems: | |
| 288 | + | ||
| 289 | + | 1. Dereferencing a nil pointer. | |
| 290 | + | 2. Trying to access memory which is out of bounds (for example, calling move with an invalid length). | |
| 291 | + | ||
| 292 | + | 217 | |
| 293 | + | ||
| 294 | + | Unhandled exception occurred | |
| 295 | + | ||
| 296 | + | An exception occurred, and there was no exception handler present. The [[sysutils]] unit installs a default exception handler which catches all exceptions and exits gracefully. | |
| 297 | + | ||
| 298 | + | 218 | |
| 299 | + | ||
| 300 | + | Invalid value specified | |
| 301 | + | ||
| 302 | + | Error 218 occurs when an invalid value was specified to a system call, for instance when specifying a negative value to a seek() call. | |
| 303 | + | ||
| 304 | + | 219 | |
| 305 | + | ||
| 306 | + | Invalid typecast | |
| 307 | + | ||
| 308 | + | Thrown when an invalid typecast is attempted on a class using the as 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 -CR compiler option is used. | |
| 309 | + | ||
| 310 | + | 222 | |
| 311 | + | ||
| 312 | + | Variant dispatch error | |
| 313 | + | ||
| 314 | + | No dispatch method to call from variant. | |
| 315 | + | ||
| 316 | + | 223 | |
| 317 | + | ||
| 318 | + | Variant array create | |
| 319 | + | ||
| 320 | + | The variant array creation failed. Usually when there is not enough memory. | |
| 321 | + | ||
| 322 | + | 224 | |
| 323 | + | ||
| 324 | + | Variant is not an array | |
| 325 | + | ||
| 326 | + | This error occurs when a variant array operation is attempted on a variant which is not an array. | |
| 327 | + | ||
| 328 | + | 225 | |
| 329 | + | ||
| 330 | + | Var Array Bounds check error | |
| 331 | + | ||
| 332 | + | This error occurs when a variant array index is out of bounds. | |
| 333 | + | ||
| 334 | + | 227 | |
| 335 | + | ||
| 336 | + | Assertion failed error | |
| 337 | + | ||
| 338 | + | An assertion failed, and no [[AssertErrorProc]] procedural variable was installed. | |
| 339 | + | ||
| 340 | + | 229 | |
| 341 | + | ||
| 342 | + | Safecall error check | |
| 343 | + | ||
| 344 | + | This error occurs is a safecall check fails, and no handler routine is available. | |
| 345 | + | ||
| 346 | + | 231 | |
| 347 | + | ||
| 348 | + | Exception stack corrupted | |
| 349 | + | ||
| 350 | + | This error occurs when the exception object is retrieved and none is available. | |
| 351 | + | ||
| 352 | + | 232 | |
| 353 | + | ||
| 354 | + | Threads not supported | |
| 355 | + | ||
| 356 | + | Thread management relies on a separate driver on some operating systems (notably, Unixes). The unit with this driver needs to be specified on the uses clause of the program, preferably as the first unit (cthreads on unix). | |
| 357 | + | ||
| 358 | + | Add **{\$define UseCThreads}** in the top of the first Pascal unit (usually the project .lpr file) | |
| 316 | 359 | ||
| 317 | 360 | ## See also | |
| 318 | 361 | ||
| 319 | 362 | - [[compile-time error|Compile time errors]] | |
| 320 | 363 | - [List of Run-time errors](http://www.freepascal.org/docs-html/user/userap4.html) | |
| 321 | 364 | ||
| 322 | 365 | --- | |
| 323 | 366 | *From the Free Pascal wiki, page "RunError", as it stood on 2023-11-11 after a change by Bart, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* | |
| 324 | 367 | Category: Debugging | |
| 325 | 368 | Category: FPC | |
| 326 | 369 | Category: Glossary | |
| 327 | 370 | Category: Troubleshooting |