Các chức năng

Sơ lược

Khám phá các hàm DelphiScript được hỗ trợ trong Altium Designer, từ đánh giá biểu thức và xử lý tệp văn bản đến sử dụng các hàm toán học, chuỗi và mở rộng. Tài liệu tham khảo này cũng đề cập đến việc truyền tham số, thao tác với tập hợp và xử lý ngoại lệ, kèm theo ví dụ và lưu ý về các tính năng Delphi không được hỗ trợ. Hãy đọc tiếp để tìm các hàm và cú pháp bạn cần cho tập lệnh DelphiScript của mình.

- Xác định các hàm vào/ra tệp, toán học, chuỗi và mở rộng có sẵn, cùng với các hàm chuỗi không được hỗ trợ.
- Tìm hiểu cách đánh giá biểu thức, truyền tham số và thay thế các toán tử tập hợp của Delphi bằng các hàm DelphiScript.
- Nắm được cách sử dụng Try-Finally, Try-Except và Raise để giải phóng tài nguyên và xử lý ngoại lệ.
Tìm hiểu sâu hơn với AI:

Các câu lệnh hàm thường dùng trong ngôn ngữ DelphiScript được trình bày dưới đây. Các hàm DelphiScript được chia thành các nhóm: thủ tục vào/ra tệp, thủ tục toán học, thủ tục xử lý chuỗi và thủ tục mở rộng.

Tính toán biểu thức bằng hàm Evaluate

Hàm tích hợp Evaluate diễn giải một chuỗi chứa biểu thức toán học hợp lệ trong thời gian chạy và trả về kết quả. Ví dụ, bạn có thể viết một tập lệnh như Evaluate(ProcNames[ProcIndex]); và thủ tục được chỉ định trong ProcNames[ProcIndex] sẽ được gọi.

Để tính toán biểu thức như vậy, bạn có thể sử dụng phương thức Evaluate, trong đó biểu thức được chỉ định bằng tham số Expr. Ví dụ, bạn có thể tính toán các biểu thức như sau:

Evaluate('2+5');
Evaluate('((10+15)-5)/2*5');
Evaluate('sin(3.1415926/2)*10');
Evaluate('2.5*log(3)');

Truyền tham số cho hàm và thủ tục

Cả hàm và thủ tục được định nghĩa trong tập lệnh đều có thể được khai báo để nhận tham số. Ngoài ra, hàm được định nghĩa để trả về một giá trị. Kiểu tham số trong khai báo thủ tục/hàm sẽ bị bỏ qua và có thể không cần ghi. Ví dụ, đoạn mã sau là hợp lệ:

Function sum(a, b) : integer;
Begin
  Result := a + b;
End;

Thoát khỏi thủ tục

DelphiScript cung cấp các câu lệnh Exit và Break để buộc một thủ tục thoát trước khi kết thúc theo luồng thực thi thông thường. Ví dụ, nếu giá trị của một tham số không phù hợp, bạn có thể muốn đưa ra cảnh báo cho người dùng rồi thoát, như ví dụ dưới đây.

Procedure DisplayName (s);
Begin
  If s = '' Then
  Begin
    ShowMessage('Please enter a name');
    Exit;
  End;
  ShowMessage(S + ' is shown');
End;

Các thủ tục vào/ra tệp

DelphiScript có các thủ tục vào/ra sau:

Append

AssignFile

ChDir

CloseFIle

Eof

Eoln

Erase

GetDir

MkDir

Read

Readln

Reset

Rewrite

RmDir

Write

Writeln

 

 

DelphiScript cho phép bạn ghi thông tin vào tệp văn bản. Vì DelphiScript là ngôn ngữ không định kiểu, trước tiên mọi giá trị đều phải được chuyển đổi thành chuỗi.

Ở đây, các thủ tục Read và ReadLn tương đương nhau — chúng đọc một dòng cho đến dòng tiếp theo nhưng không bao gồm dòng đó. Thủ tục Writeln(String) tương đương với một thủ tục Write(S) kết hợp với một thủ tục Write(LineFeed + CarriageReturn).

Để ghi tệp văn bản, hãy sử dụng các thủ tục AssignFile, ReWrite, Writeln và CloseFile. Để đọc tệp văn bản, hãy sử dụng các thủ tục AssignFile, Reset, Readln và CloseFile. Ví dụ dưới đây ghi vào tệp văn bản và thêm ký tự đánh dấu kết thúc dòng. Bạn nên sử dụng khối Try / Finally / End để đảm bảo tập lệnh hoạt động an toàn khi xảy ra lỗi vào/ra.

Example:

Var
  InputFile : TextFile;
  OutputFile : TextFile;
  I          : Integer;
  Line       : String;
Begin
  AssignFile(OutputFile,eConvertedFile.Text);
  Rewrite(OutputFile);
  AssignFile(InputFIle,eOriginalFIle.Text);
  Reset(InputFile);
 
  Try
  While not EOF(InputFile) do
  Begin
    Readln(InputFile,Line);
    For I := 1 to Length(Line) Do
      Line[I] := UpperCase(Line[I]);
      Writeln(Outputfile, Line);
    End;
  Finally
    CloseFile(InputFile);
    CloseFile(OutputFile);
  End;
End;

Các thủ tục toán học

DelphiScript có các thủ tục toán học sau:

Abs

ArcTan

Cos

Exp

Frac

Int

Random

Randomize

Round

Sin

Sqr

Sqrt

Trunc

 

 

Các thủ tục xử lý chuỗi

DelphiScript có các thủ tục xử lý chuỗi sau, dùng để thao tác với chuỗi hoặc ký tự. Bảng dưới đây chỉ trình bày một phần các thủ tục xử lý chuỗi (phần lớn các thủ tục xử lý chuỗi mà DelphiScript sử dụng được nhập từ unit SysUtils của Embarcadero Delphi):

AnsiCompareStr

AnsiCompareText

AnsiDequotedStr

AnsiExtractQuotedStr

AnsiLowerCase

AnsiPos

AnsiQuotedStr

AnsiSameStr

AnsiSameText

AnsiUpperCase

CompareStr

CompareText

Copy

Delete

FloatToStr

FloatToStrF

Format

Frac

Insert

Int

IsDelimiter

LastDelimiter

Length

LowerCase

Ord

Pos

Pred

QuotedStr

Round

SameText

SetLength

StringOfChar

StringToGUID

Succ

Trim

TrimLeft

TrimRight

UpCase

UpperCase

WideUpperCase

WideLowerCase

WideSameStr

WideSameText

 

 

Các thủ tục xử lý chuỗi not được DelphiScript hỗ trợ được liệt kê trong bảng dưới đây:

AnsiContainsStr

AnsiContainsText

AnsiEndsStr

AnsiEndsText

AnsiIndexText

AnsiMatchStr

AnsiMatchText

AnsiReplaceStr

AnsiReplaceText

AnsiResemblesProc

AnsiResemblesText

AnsiStartsStr

AnsiStartsText

Concat

DecodeSoundExInt

DecodeSoundExWord

DupeString

LeftStr

MidStr

NullStr

ReverseString

RightStr

SetString

SoundEx

SoundExCompare

SoundExInt

SoundExProc

SoundExSimilar

SoundExWord

Str

StuffString

Val

 

Các thủ tục mở rộng

Các thủ tục mở rộng được dùng khi làm việc với các tiến trình máy chủ trong tập lệnh (một lệnh là một tiến trình máy chủ được đóng gói kèm tham số, nếu có), đặc biệt khi bạn cần trích xuất hoặc thiết lập chuỗi cho các tham số của tiến trình. Một số thủ tục được liệt kê dưới đây.

Để thực thi các tham số của tiến trình trong tập lệnh, bạn có thể cần các hàm sau:

AddColorParameter

AddIntegerParameter

AddLongIntParameter

AddSingleParameter

AddWordParameter

GetIntegerParameter

GetStringParameter

ResetParameters

RunProcess

Useful functions:

SetCursorBusy

ResetCursor

CheckActiveServer

GetActiveServerName

GetCurrentDocumentFileName

RunApplication

SaveCurrentDocument

 

 

Useful dialogs:

ConfirmNoYes

ConfirmNoYesCancel

ShowError

ShowInfo

ShowWarning

 

Sử dụng tập hợp trong DelphiScript

DelphiScript không hỗ trợ các từ khóa Set và In cũng như các toán tử tập hợp +, -, *, <= và >= của Embarcadero Delphi. Các từ khóa toán tử tập hợp tương đương được liệt kê trong bảng dưới đây.

DelphiScript không có kiểu tập hợp. Để sử dụng tập hợp trong tập lệnh DelphiScript, hãy dùng các hàm tích hợp MkSet, MkSetRange, InSet, SetUnion, SetDifference, SetIntersection và SubSet, cho phép thao tác với tập hợp trong tập lệnh DelphiScript. Các hàm này được mô tả chi tiết hơn dưới đây.

Các toán tử tập hợp

Embarcadero Delphi Set Operator keyword

Equivalent DelphiScript Set Operator keyword

+

SetUnion

-

SetDifference

*

SetIntersection

<=

SubSet

=

=

<>

<>

In

InSet

Hàm MkSet

Hàm MkSet tạo tập hợp với số lượng đối số thay đổi. Ví dụ:

Font.Style = MkSet(fsBold,fsItalic);

Ở đây, MkSet(fsBold,fsItalic)  chỉ biểu thị hai phần tử của tập hợp là fsBold và fsItalic.

Hàm MkSetRange

Hàm MkSetRange tạo tập hợp từ một dải đối số. Ví dụ:

LayerSet := MkSetRange(eTopLayer,eBottomLayer);

Hàm MkSetRange(eTopLayer,eBottomLayer) biểu thị một dải lớp từ eTopLayer đến eBottomLayer.

Hàm InSet

Hàm InSet này được dùng để thay thế toán tử In của Delphi. A in B tương đương với InSet(A, B).

If InSet(A,B) then
  ShowMessage('A is in B set')
Else
  ShowMessage('A not in B set');

Hàm SetUnion

Hàm SetUnion được dùng để thay thế toán tử + của Delphi. A + B tương đương với SetUnion(A, B).

ASet := BSet + CSet;
// should be changed to:
ASet := SetUnion(BSet,CSet);
// in order to achieve the desired script result.

Hàm SetDifference

Hàm SetDifference được dùng để thay thế toán tử - của Delphi. A - B tương đương với SetDifference(A, B).

Hàm SetIntersection

Hàm SetIntersection được dùng để thay thế toán tử * của Delphi. A * B tương đương với SetIntersection(A, B).

Hàm SubSet

Hàm SubSet được dùng để thay thế toán tử <= của Object Pascal. A <= B tương đương với SubSet(A, B).

Sử dụng trình xử lý ngoại lệ

Từ khóa Try mở đầu một câu lệnh Try-Except hoặc Try-Finally. Hai câu lệnh này có liên quan với nhau nhưng phục vụ các mục đích khác nhau:

Try-Finally

Với Try-Finally, các câu lệnh trong khối Finally luôn được thực thi bất kể có ngoại lệ phát sinh từ khối Try hay có lệnh Exit hoặc Break. Hãy sử dụng khối Try-Finally để giải phóng các đối tượng tạm thời và tài nguyên khác cũng như thực hiện các thao tác dọn dẹp.

Thông thường, mỗi chương trình con chỉ cần một câu lệnh Try-Finally.

Example:

Reset(F);
Try
  // process file F
Finally
  CloseFile(F);
End;

Try-Except

Sử dụng Try-Except để xử lý các trường hợp ngoại lệ. Ví dụ, bắt các ngoại lệ cụ thể và thực hiện thao tác hữu ích với chúng, chẳng hạn như ghi vào nhật ký lỗi hoặc tạo hộp thoại thân thiện với người dùng. Vì DelphiScript không hỗ trợ từ khóa On, câu lệnh Raise được sử dụng bên trong khối Except.

Example:

Try
  X := Y/Z;
Except
  Raise('A divide by zero error!');
End;

Raise

Từ khóa Raise có liên quan đến từ khóa Try. Có thể sử dụng từ khóa Raise mà không có tham số để phát sinh lại ngoại lệ gần nhất. Cũng có thể sử dụng từ khóa này với một tham số chuỗi để phát sinh ngoại lệ kèm thông báo cụ thể.

Example:

Raise(Format('Invalid Value Entered : %d', [Height]));

Lưu ý rằng do từ khóa On không được hỗ trợ nên không thể sử dụng các đối tượng Exception (có trong Embarcadero Delphi).

AI-LocalizedBản địa hóa bằng AI
Nếu bạn phát hiện vấn đề, hãy chọn văn bản/hình ảnh và nhấnCtrl + Enterđể gửi phản hồi cho chúng tôi.
Nav
Contents
Tính khả dụng của tính năng

Các tính năng bạn có thể sử dụng phụ thuộc vào giải pháp Altium mà bạn đang có – Altium Develop, Altium Agile Teams, Altium Agile Enterprise, hoặc Altium Designer (đang trong thời hạn hiệu lực).

Nếu bạn không thấy một tính năng được nêu trong tài liệu có trong phần mềm thực tế của mình, liên hệ Bộ phận Kinh doanh của Altium để tìm hiểu thêm.

Tài liệu cũ

Tài liệu Altium Designer không còn được phân phiên bản. Nếu bạn cần truy cập tài liệu cho các phiên bản cũ hơn của Altium Designer, hãy truy cập mục Tài liệu cũ trên trang Trình cài đặt khác.

Contents