fpc/rtl/objpas/sysutils.pp
2000-08-06 14:19:06 +00:00

473 lines
11 KiB
ObjectPascal

{
$Id$
This file is part of the Free Pascal run time library.
Copyright (c) 1999-2000 by Florian Klaempfl
member of the Free Pascal development team
See the file COPYING.FPC, included in this distribution,
for details about the copyright.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
**********************************************************************}
unit sysutils;
interface
{$MODE objfpc}
{ force ansistrings }
{$H+}
uses
{$ifdef linux}
linux
{$endif}
{$ifdef win32}
dos,windows
{$endif}
{$ifdef go32v1}
go32,dos
{$endif}
{$ifdef go32v2}
go32,dos
{$endif}
{$ifdef os2}
doscalls,dos
{$endif}
;
{ Read String Handling functions declaration }
{$i sysstrh.inc}
type
{ some helpful data types }
tprocedure = procedure;
tfilename = string;
tsyscharset = set of char;
longrec = packed record
lo,hi : word;
end;
wordrec = packed record
lo,hi : byte;
end;
TMethod = packed record
Code, Data: Pointer;
end;
{ exceptions }
Exception = class(TObject)
private
fmessage : string;
fhelpcontext : longint;
public
constructor Create(const msg : string);
constructor CreateFmt(const msg : string; const args : array of const);
constructor CreateRes(ResString: PString);
constructor CreateResFmt(ResString: PString; const Args: array of const);
constructor CreateHelp(const Msg: string; AHelpContext: Integer);
constructor CreateFmtHelp(const Msg: string; const Args: array of const;
AHelpContext: Integer);
constructor CreateResHelp(ResString: PString; AHelpContext: Integer);
constructor CreateResFmtHelp(ResString: PString; const Args: array of const;
AHelpContext: Integer);
{ !!!! }
property helpcontext : longint read fhelpcontext write fhelpcontext;
property message : string read fmessage write fmessage;
end;
ExceptClass = class of Exception;
{ integer math exceptions }
EInterror = Class(Exception);
EDivByZero = Class(EIntError);
ERangeError = Class(EIntError);
EIntOverflow = Class(EIntError);
{ General math errors }
EMathError = Class(Exception);
EInvalidOp = Class(EMathError);
EZeroDivide = Class(EMathError);
EOverflow = Class(EMathError);
EUnderflow = Class(EMathError);
{ Run-time and I/O Errors }
EInOutError = class(Exception)
public
ErrorCode : Longint;
end;
EInvalidPointer = Class(Exception);
EOutOfMemory = Class(Exception);
EAccessViolation = Class(Exception);
EInvalidCast = Class(Exception);
{ String conversion errors }
EConvertError = class(Exception);
{ Other errors }
EAbort = Class(Exception);
EAbstractError = Class(Exception);
EAssertionFailed = Class(Exception);
{ Exception handling routines }
function ExceptObject: TObject;
function ExceptAddr: Pointer;
function ExceptionErrorMessage(ExceptObject: TObject; ExceptAddr: Pointer;
Buffer: PChar; Size: Integer): Integer;
procedure ShowException(ExceptObject: TObject; ExceptAddr: Pointer);
procedure Abort;
procedure OutOfMemoryError;
procedure Beep;
Var
OnShowException : Procedure (Msg : ShortString);
{ FileRec/TextRec }
{$i filerec.inc}
{$i textrec.inc}
{ Read internationalization settings }
{$i sysinth.inc}
{ Read date & Time function declarations }
{$i datih.inc}
{ Read pchar handling functions declration }
{$i syspchh.inc}
{ Read filename handling functions declaration }
{$i finah.inc}
{ Read other file handling function declarations }
{$i filutilh.inc}
{ Read disk function declarations }
{$i diskh.inc}
implementation
{ Read message string definitions }
{
Add a language with IFDEF LANG_NAME
just befor the final ELSE. This way English will always be the default.
}
{$IFDEF LANG_GERMAN}
{$i strg.inc} // Does not exist yet !!
{$ELSE}
{$i stre.inc}
{$ENDIF}
{ Read filename handling functions implementation }
{$i fina.inc}
{ Read String Handling functions implementation }
{$i sysstr.inc}
{ Read other file handling function implementations }
{$i filutil.inc}
{ Read disk function implementations }
{$i disk.inc}
{ Read date & Time function implementations }
{$i dati.inc}
{ Read pchar handling functions implementation }
{$i syspch.inc}
constructor Exception.Create(const msg : string);
begin
inherited create;
fmessage:=msg;
end;
constructor Exception.CreateFmt(const msg : string; const args : array of const);
begin
inherited create;
fmessage:=Format(msg,args);
end;
constructor Exception.CreateRes(ResString: PString);
begin
inherited create;
fmessage:=ResString^;
end;
constructor Exception.CreateResFmt(ResString: PString; const Args: array of const);
begin
inherited create;
fmessage:=Format(ResString^,args);
end;
constructor Exception.CreateHelp(const Msg: string; AHelpContext: Integer);
begin
inherited create;
fmessage:=Msg;
fhelpcontext:=AHelpContext;
end;
constructor Exception.CreateFmtHelp(const Msg: string; const Args: array of const;
AHelpContext: Integer);
begin
inherited create;
fmessage:=Format(Msg,args);
fhelpcontext:=AHelpContext;
end;
constructor Exception.CreateResHelp(ResString: PString; AHelpContext: Integer);
begin
inherited create;
fmessage:=ResString^;
fhelpcontext:=AHelpContext;
end;
constructor Exception.CreateResFmtHelp(ResString: PString; const Args: array of const;
AHelpContext: Integer);
begin
inherited create;
fmessage:=Format(ResString^,args);
fhelpcontext:=AHelpContext;
end;
{$ifopt S+}
{$define STACKCHECK_WAS_ON}
{$S-}
{$endif OPT S }
Procedure CatchUnhandledException (Obj : TObject; Addr,Frame: Pointer);
Var
Message : String;
begin
Writeln(stdout,'An unhandled exception occurred at 0x',HexStr(Longint(Addr),8),' :');
if Obj is exception then
begin
Message:=Exception(Obj).Message;
Writeln(stdout,Message);
end
else
Writeln(stdout,'Exception object ',Obj.ClassName,' is not of class Exception.');
{ to get a nice symify }
Writeln(stdout,BackTraceStrFunc(Longint(Addr)));
Dump_Stack(stdout,longint(frame));
Writeln(stdout,'');
Halt(217);
end;
Var OutOfMemory : EOutOfMemory;
InValidPointer : EInvalidPointer;
Procedure RunErrorToExcept (ErrNo : Longint; Address,Frame : Pointer);
Var E : Exception;
S : String;
begin
Case Errno of
1,203 : E:=OutOfMemory;
204 : E:=InvalidPointer;
2,3,4,5,6,100,101,102,103,105,106 : { I/O errors }
begin
Case Errno of
2 : S:=SFileNotFound;
3 : S:=SInvalidFileName;
4 : S:=STooManyOpenFiles;
5 : S:=SAccessDenied;
6 : S:=SInvalidFileHandle;
15 : S:=SInvalidDrive;
100 : S:=SEndOfFile;
101 : S:=SDiskFull;
102 : S:=SFileNotAssigned;
103 : S:=SFileNotOpen;
104 : S:=SFileNotOpenForInput;
105 : S:=SFileNotOpenForOutput;
106 : S:=SInvalidInput;
end;
E:=EinOutError.Create (S);
EInoutError(E).ErrorCode:=IOresult; // Clears InOutRes !!
end;
// We don't set abstracterrorhandler, but we do it here.
// Unless the use sets another handler we'll get here anyway...
200 : E:=EDivByZero.Create(SDivByZero);
201 : E:=ERangeError.Create(SRangeError);
205 : E:=EOverflow.Create(SOverflow);
206 : E:=EOverflow.Create(SUnderflow);
207 : E:=EInvalidOp.Create(SInvalidOp);
211 : E:=EAbstractError.Create(SAbstractError);
215 : E:=EIntOverflow.Create(SIntOverflow);
216 : E:=EAccessViolation.Create(SAccessViolation);
219 : E:=EInvalidCast.Create(SInvalidCast);
227 : E:=EAssertionFailed.Create(SAssertionFailed);
else
E:=Exception.CreateFmt (SUnKnownRunTimeError,[Errno]);
end;
Raise E at longint(Address),longint(Frame);
end;
Procedure AssertErrorHandler (Const Msg,FN : ShortString;LineNo,TheAddr : Longint);
Var
S : String;
begin
If Msg='' then
S:=SAssertionFailed
else
S:=Msg;
Raise EAssertionFailed.Createfmt(SAssertError,[S,Fn,LineNo]); // at Pointer(theAddr);
end;
{$ifdef STACKCHECK_WAS_ON}
{$S+}
{$endif}
Procedure InitExceptions;
{
Must install uncaught exception handler (ExceptProc)
and install exceptions for system exceptions or signals.
(e.g: SIGSEGV -> ESegFault or so.)
}
begin
ExceptProc:=@CatchUnhandledException;
// Create objects that may have problems when there is no memory.
OutOfMemory:=EOutOfMemory.Create(SOutOfMemory);
InvalidPointer:=EInvalidPointer.Create(SInvalidPointer);
AssertErrorProc:=@AssertErrorHandler;
ErrorProc:=@RunErrorToExcept;
OnShowException:=Nil;
end;
{ Exception handling routines }
function ExceptObject: TObject;
begin
If RaiseList=Nil then
Result:=Nil
else
Result:=RaiseList^.FObject;
end;
function ExceptAddr: Pointer;
begin
If RaiseList=Nil then
Result:=Nil
else
Result:=RaiseList^.Addr;
end;
function ExceptionErrorMessage(ExceptObject: TObject; ExceptAddr: Pointer;
Buffer: PChar; Size: Integer): Integer;
Var
S : AnsiString;
Len : Integer;
begin
S:=Format(SExceptionErrorMessage,[ExceptObject.ClassName,ExceptAddr]);
If ExceptObject is Exception then
S:=Format('%s:'#10'%s',[S,Exception(ExceptObject).Message]);
Len:=Length(S);
If S[Len]<>'.' then
begin
S:=S+'.';
Inc(len);
end;
If Len>Size then
Len:=Size;
Move(S[1],Buffer^,Len);
Result:=Len;
end;
procedure ShowException(ExceptObject: TObject; ExceptAddr: Pointer);
// use shortstring. On exception, the heap may be corrupt.
Var
Buf : ShortString;
begin
SetLength(Buf,ExceptionErrorMessage(ExceptObject,ExceptAddr,@Buf[1],255));
If IsConsole Then
writeln(Buf)
else
If Assigned(OnShowException) Then
OnShowException (Buf);
end;
procedure Abort;
begin
Raise EAbort.Create(SAbortError) at Get_Caller_addr(Get_Frame)
end;
procedure OutOfMemoryError;
begin
Raise OutOfMemory;
end;
procedure Beep;
begin
{$ifdef win32}
MessageBeep(0);
{$else}
{$endif}
end;
{ Initialization code. }
Initialization
InitExceptions; { Initialize exceptions. OS independent }
InitInternational; { Initialize internationalization settings }
Finalization
OutOfMemory.Free;
InValidPointer.Free;
end.
{
$Log$
Revision 1.5 2000-08-06 14:19:06 peter
* overload directives removed (merged)
Revision 1.4 2000/07/27 16:20:52 sg
* Applied patch by Markus Kaemmerer with minor modifications: More methods
of the Exception class are now implemented (in a manner so that they can
be used as in Delphi, although the declarations are somewhat different)
Revision 1.3 2000/07/14 10:33:10 michael
+ Conditionals fixed
Revision 1.2 2000/07/13 11:33:51 michael
+ removed logs
}