Những điểm khác biệt giữa DelphiScript và Delphi
Sơ lược
- Hiểu về các biến dựa trên kiểu Variant, việc chuyển đổi kiểu tại thời điểm chạy và tác động của chúng đến hoạt động kiểm thử cũng như hiệu năng.
- Tìm hiểu những tính năng của Delphi không được hỗ trợ hoặc có cách hoạt động khác, bao gồm mảng, toán tử tập hợp, chương trình con lồng nhau và xử lý ngoại lệ.
- Xem cách sử dụng các lớp có sẵn và giao diện đối tượng của Altium Designer, bao gồm một ví dụ tạo lỗ via trên PCB.
Khác biệt giữa DelphiScript và Delphi
Phần này trình bày những khác biệt cơ bản giữa ngôn ngữ viết script DelphiScript và ngôn ngữ lập trình Delphi của Embarcadero, cũng như ảnh hưởng của những khác biệt này khi sử dụng API Altium Designer.
Hệ thống viết script của Altium Designer sử dụng ngôn ngữ DelphiScript không định kiểu, vì vậy không có kiểu dữ liệu trong script. Mặc dù bạn có thể khai báo biến và kiểu của chúng, đồng thời chỉ định kiểu cho hàm/thủ tục hoặc tham số phương thức để mã dễ đọc hơn, DelphiScript sẽ chuyển đổi các biến chưa được khai báo khi script được thực thi. Vì vậy, chẳng hạn, bạn không thể định nghĩa bản ghi hoặc lớp.
Biến trong DelphiScript
Tất cả các biến trong script đều thuộc kiểu Variant; kiểu trong khai báo biến sẽ bị bỏ qua và có thể lược bỏ. Vì vậy, cả ba khai báo sau đều hợp lệ:
Var
a : Integer;
Var
b : Integer;
Var
c, d;
Kiểu của tham số trong khai báo thủ tục/hàm cũng bị bỏ qua và có thể lược bỏ. Ví dụ, đoạn mã sau là hợp lệ:
Function Sum(a, b) : Integer;
Begin
Result := a + b;
End;
Nhìn chung, biến Variant có thể được dùng để lưu trữ mọi kiểu dữ liệu và thực hiện nhiều phép toán cũng như chuyển đổi kiểu. Biến Variant được kiểm tra kiểu và tính toán tại thời điểm chạy. Trình biên dịch sẽ không cảnh báo về các lỗi có thể có trong mã; những lỗi này chỉ có thể được phát hiện thông qua kiểm thử kỹ lưỡng. Nhìn chung, những phần mã sử dụng biến Variant có thể được xem là mã thông dịch, vì nhiều phép toán không thể được xác định cho đến thời điểm chạy. Điều này có thể ảnh hưởng đến tốc độ thực thi mã.
Do đó, sau khi một biến Variant được khai báo và được gán một giá trị Variant, giá trị của biến có thể được sao chép sang bất kỳ kiểu dữ liệu tương thích hoặc không tương thích nào:
Var
V;
Begin
// variable V can be assigned values of several different types:
V := 10;
V := 'Hello, World';
V := 45.55;
End;
Nếu một biến được gán dữ liệu có kiểu không tương thích, trình thông dịch DelphiScript sẽ thực hiện chuyển đổi nếu có thể. Nếu không, lỗi thời gian chạy sẽ xuất hiện. Trên thực tế, biến Variant lưu thông tin kiểu cùng với dữ liệu, vì vậy DelphiScript chậm hơn mã Embarcadero Delphi tương đương đã được biên dịch.
Tập hợp trong script
DelphiScript không có kiểu tập hợp (Set) và không hỗ trợ các toán tử tập hợp, khác với ngôn ngữ Delphi vốn có kiểu tập hợp và hỗ trợ các toán tử tập hợp.
Để sử dụng tập hợp trong script DelphiScript, hãy dùng các hàm tích hợp sẵn để thao tác với tập hợp trong script.
Xem mục Sử dụng tập hợp trong DelphiScript để biết thêm thông tin
Hàm hoặc thủ tục nội bộ
Khi cân nhắc sử dụng hàm và thủ tục inside một hàm hoặc thủ tục, cách tiếp cận được khuyến nghị là viết các hàm/thủ tục độc lập — mặc dù vẫn cho phép sử dụng thủ tục/hàm đệ quy.
Không nên sử dụng đoạn mã hàm sau:
Function A
Function B
Begin
// blah
End;
Begin
B;
End;
Cấu trúc hàm được khuyến nghị:
Function B
Begin
// blah
End;
Function A
Begin
B;
End;
Từ khóa Result
Sử dụng từ khóa Result để đặt giá trị trả về trong một khối hàm. Ví dụ:
Function Foo : String;
Begin
Result := 'Foo Foo';
End;
Chương trình con lồng nhau
Các chương trình con lồng nhau được hỗ trợ, nhưng không thể sử dụng biến của hàm ngoài cùng từ chương trình con lồng bên trong.
Phần tử mảng
Kiểu của phần tử mảng bị bỏ qua và có thể lược bỏ, vì vậy hai khai báo sau là tương đương:
Var
x : array [1..2] of double;
Var
x : array [1..2];
Lưu ý rằng bạn không thể khai báo kiểu mảng, nhưng có thể khai báo biến mảng.
Illegal example:
Type
TVertices = Array [1..50] Of TLocation;
Var
NewVertices : TVertices;
Legal example:
Var
NewVertices : Array [1..50] of TLocation;
Khai báo mảng mở
Khai báo Open Array không được hỗ trợ.
Từ khóa Case
Từ khóa Case có thể được sử dụng với mọi kiểu. Vì vậy, đoạn mã sau là hợp lệ:
Case UserName of
'Alex', 'John' : IsAdministrator := true;
'Peter' : IsAdministrator := false;
Else
Raise('Unknown user');
End;
Khai báo lớp
Không thể định nghĩa lớp mới trong DelphiScript, nhưng bạn có thể sử dụng và khởi tạo các lớp DelphiScript hiện có. Ví dụ, có thể tạo và sử dụng các lớp TList và TStringList trong script của bạn.
See also
TList
TStringList
Hàm CreateObject
Hàm CreateObject có thể được dùng để tạo các đối tượng sẽ được tự động giải phóng khi không còn được sử dụng.
Vì vậy, thay vì:
Procedure Proc;
Var
l;
Begin
l := TList.Create;
Try
// do something with l
Finally
L.Free;
End;
...bạn có thể viết:
Procedure Proc;
Var
l;
Begin
l := CreateObject(TList);
// Do something with l
End;
See also
Hàm CreateObject.
Phát sinh ngoại lệ
Có thể sử dụng từ khóa Raise mà không cần tham số để phát sinh lại ngoại lệ gần nhất. Raise cũng có thể được dùng với một tham số chuỗi để phát sinh ngoại lệ kèm chuỗi thông báo được chỉ định. Các đối tượng Exception không được hỗ trợ trong DelphiScript vì từ khóa On không được hỗ trợ.
Example:
Raise(Format('Invalid value : %d', [Height]));
See also
Các từ khóa Try, Finally và Raise.
ThreadVar
Trong DelphiScript, từ khóa Threadvar được xử lý như Var. Lưu ý rằng trong Embarcadero Delphi, các biến được khai báo bằng từ khóa Threadvar có giá trị riêng biệt trong từng luồng.
Toán tử tập hợp
Toán tử tập hợp In không được hỗ trợ. Có thể sử dụng toán tử InSet để kiểm tra xem một giá trị có phải là phần tử của một tập hợp hay không. Ví dụ:
If InSet(fsBold, Font.Style) then
ShowMessage('Bold');
Lưu ý rằng các toán tử tập hợp Delphi +, -, *, <=, >= không hoạt động chính xác. Thay vào đó, các hàm DelphiScript tích hợp sẵn MkSet, MkSetRange, SetUnion, SetDifference, SetIntersection, SubSet and InSet được sử dụng:
ASet := BSet + CSet; \\ should be changed to
ASet := SetUnion(BSet, CSet);
Các cấu trúc tạo tập hợp [...] không được hỗ trợ — hãy sử dụng hàm MkSet để tạo một tập hợp:
Font.Style := MkSet(fsBold, fsItalic);
See also
Từ khóa MkSet
Từ khóa MkSetRange
Từ khóa InSet
Từ khóa SetDifference
Từ khóa SetIntersection
Từ khóa SetUnion
Từ khóa SubSet
Từ khóa InSet
Toán tử
Các toán tử ^ và @ không được hỗ trợ.
Chỉ thị
Các chỉ thị sau không được hỗ trợ (lưu ý rằng một số chỉ thị đã lỗi thời và cũng không được Embarcadero Delphi hỗ trợ): absolute, abstract, assembler, automated, cdecl, contains, default, dispid, dynamic, export, external, far, implements, index, message, name, near, nodefault, overload, override, package, pascal, private protected, public, published, read, readonly, register, reintroduce, requires, resident, safecall, stdcall, stored, virtual, write, writeonly.
Ngoài ra, lưu ý rằng chỉ thị in trong mệnh đề Uses sẽ bị bỏ qua.
Từ khóa bị bỏ qua
Các từ khóa interface, implementation, program và unit bị bỏ qua trong DelphiScript. Script có thể chứa chúng nhưng chúng không có tác dụng — tuy nhiên, các từ khóa này có thể giúp script dễ đọc hơn.
Từ khóa không được hỗ trợ
Các từ khóa sau không được hỗ trợ trong DelphiScript:
-
as, asm, class, dispinterface, exports, finalization, inherited, initialization, inline, interface, is, library, object, out, property, record, resourcestring, set, supports, type.
Các hàm Delphi RTL sau không được hỗ trợ trong DelphiScript:
-
Abort, Addr, Assert, Dec, FillChar, Finalize, Hi, High, Inc, Initialize, Lo, Low, New, Ptr, SetString, SizeOf, Str, UniqueString, VarArrayRedim, VarArrayRef, VarCast, VarClear, VarCopy.
Các hàm thuộc unit Windows của Delphi (tệp windows.pas) không được hỗ trợ (ví dụ, hàm RGB không được hỗ trợ).
Sử dụng API Altium Designer trong script
Bạn không thể tự tạo các kiểu bản ghi hoặc lớp bằng DelphiScript rồi khởi tạo chúng trong script; tuy nhiên, bạn có thể sử dụng một số lớp của API Altium Designer. Ví dụ, các lớp TStringList và TList có thể được khởi tạo và dùng làm vùng chứa để lưu trữ dữ liệu (thường có cùng kiểu) nhằm đáp ứng nhu cầu của script.
Các giao diện đối tượng của API, đại diện cho các đối tượng Altium Designer, có thể được sử dụng trong script. Ví dụ, bạn có thể cập nhật các đối tượng thiết kế trên tài liệu sơ đồ nguyên lý và PCB thông qua các giao diện đối tượng sơ đồ nguyên lý và giao diện đối tượng PCB.
Theo quy ước, tên giao diện có thêm chữ 'I' ở đầu. Ví dụ, IPCB_Board đại diện cho giao diện của một tài liệu PCB hiện có.
Ví dụ về giao diện PCB trong script:
Procedure ViaCreation;
Var
Board : IPCB_Board;
Via : IPCB_Via;
Begin
Board := PCBServer.GetCurrentPCBBoard;
If Board = Nil Then Exit;
(\* Create a Via object\* )
Via := PCBServer.PCBObjectFactory(eViaObject, eNoDimension, eCreate_Default);
Via.X := MilsToCoord(7500);
Via.Y := MilsToCoord(7500);
Via.Size := MilsToCoord(50);
Via.HoleSize := MilsToCoord(20);
Via.LowLayer := eTopLayer;
Via.HighLayer := eBottomLayer;
(* Put this via in the Board object*)
Board.AddPCBObject(Via);
End;
Có thể sử dụng các API sau trong script:
- Một số hàm và lớp của Embarcadero Delphi™, cùng các phần mở rộng của DelphiScript
- API máy khách
- API máy chủ PCB
- API máy chủ sơ đồ nguyên lý
- API máy chủ quản lý không gian làm việc
- API thư viện tích hợp
- Các hàm API Altium Designer
- Các quy trình có tham số
Thông tin thêm
Hãy xem các script trong bộ sưu tập script có thể tải xuống để biết cách sử dụng các giao diện đối tượng và hàm của Altium Designer, cũng như các đối tượng và hàm Delphi trong script.
Tham khảo tài liệu chính về Viết tập lệnh để biết thông tin về cách viết tập lệnh cho Altium Designer.
Tham khảo hướng dẫn Sử dụng API của Altium Designer để biết chi tiết về cách sử dụng các đối tượng thiết kế và giao diện của chúng trong tập lệnh của bạn.
Tham khảo Tài liệu tham chiếu API của Altium Designer để biết thông tin về các API của Altium Designer và các đối tượng giao diện của chúng dùng cho tập lệnh.