Subroutine declaration; Overload; {Other directives...}
Description
The Overload directive allows you to have different versions of the same named function or procedure with different arguments.
This is useful when there are a number of ways that code may want to use the routine. For example, if the routine is a class constructor, you may want one version of Create that sets default values, and another that takes these values as parameters.
You must code the Overload directive before any other directives.
When calling an overloaded routine, Delphi chooses the appropriate version based first on number of arguments, then on the argument types. If it cannot make a decision, it throws an exception.
When the argument count is the same, it always tries to satisfy the simplest/smallest data types first - for example, the above value 23 would satisfy a Byte argument ahead of an Integer argument.
Sometimes, you can avoid the need for overloading by giving final arguments default values. The caller can then call with or without these final parameters.
procedure MyProc(a : Byte; b : Byte = 23);
can be called in two ways:
MyProc(15, 16);
MyProc(45); // Defaults b to value 23
Overloading is not restricted to class methods. In line functons and procedures can be similarly overloaded.
Related commands
Abstract Defines a class method only implemented in subclasses
Function Defines a subroutine that returns a value
Override Defines a method that replaces a virtual parent class method
Procedure Defines a subroutine that does not return a value
Example code : Two versions of a class constructor
// Full Unit code.
// -----------------------------------------------------------
// You must store this code in a unit called Unit1 with a form
// called Form1 that has an OnCreate event called FormCreate.
unit Unit1;
interface
uses
Windows, Messages, SysUtils, Variants, Classes, Graphics, Controls, Forms,
Dialogs;
type
// Class with overloaded methods
TRectangle = class
private
coords: array[0..3] of Integer;
public
constructor Create(left, top, right, bottom : Integer); Overload;
published
// Only one version of an overloaded method can be published
constructor Create(topLeft, bottomRight : TPoint); Overload;
end;
// The form class itself
TForm1 = class(TForm)
procedure FormCreate(Sender: TObject);
end;
var
Form1: TForm1;
implementation
{$R *.dfm}
// Constructor version 1 : takes integers as the coordinate values
constructor TRectangle.Create(left, top, right, bottom: Integer);
begin
// Save the passed values
coords[0] := left;
coords[1] := top;
coords[2] := right;
coords[3] := bottom;
end;
// Constructor version 2 : takes points as the coordinate values
constructor TRectangle.Create(topLeft, bottomRight: TPoint);
begin
// Save the passed values
coords[0] := topLeft.X;
coords[1] := topLeft.Y;
coords[2] := bottomRight.X;
coords[3] := bottomRight.Y;
end;
// Main line code
procedure TForm1.FormCreate(Sender: TObject);
var
rect1, rect2 : TRectangle;
point1, point2 : TPoint;
begin
point1 := Point(122,133);
point2 := Point(144,155);
// Create two rectangles using two different constructors
rect1 := TRectangle.Create(22, 33, 44, 55);
rect2 := TRectangle.Create(point1, point2);
end;
end.
The program runs wihtout producing any output
Example code : Ilustrating how Delphi chooses routines according to parameter value
// Full Unit code.
// -----------------------------------------------------------
// You must store this code in a unit called Unit1 with a form
// called Form1 that has an OnCreate event called FormCreate.
unit Unit1;
interface
uses
Windows, Messages, SysUtils, Variants, Classes, Graphics, Controls, Forms,
Dialogs, StdCtrls;
type
// The form class itself
TForm1 = class(TForm)
Button1: TButton;
procedure FormCreate(Sender: TObject);
procedure Button1Click(Sender: TObject);
end;
var
Form1: TForm1;
implementation
{$R *.dfm}
procedure TForm1.Button1Click(Sender: TObject);
begin
form1.close;
end;
// In line overloaded functions
function MaxValue(a, b : Byte) : string; Overload;
begin
if a > b
then ShowMessageFmt('%d byte > %d',[a,b])
else ShowMessageFmt('%d byte <= %d',[a,b]);
end;
function MaxValue(a, b : Integer) : string; Overload;
begin
if a > b
then ShowMessageFmt('%d integer > %d',[a,b])
else ShowMessageFmt('%d integer <= %d',[a,b]);
end;
function MaxValue(a, b : Extended) : string; Overload;
begin
if a > b
then ShowMessageFmt('%f extended > %f',[a,b])
else ShowMessageFmt('%f extended <= %f',[a,b]);
end;
function MaxValue(a, b : string) : string; Overload;
begin
if a > b
then ShowMessageFmt('''%s'' string > ''%s''',[a,b])
else ShowMessageFmt('''%s'' string <= ''%s''',[a,b]);
end;
// Main line code
procedure TForm1.FormCreate(Sender: TObject);
begin
// Demonstrate different calls using the same name
MaxValue(15 , 23);
MaxValue(1500, 23);
MaxValue(15.0, 23.0);
MaxValue('15', '23');
end;
end.
15 byte <= 23
1500 integer > 23
15.0 extended <= 23.0
'15' string <= '23'