del phi function

Delphi 常用函數

F.1 數學運算(Arithmetic routines)

F.2 日期及時間函數(Date/Time routines)

F.3 檔案管理(File-management routines)

F.4 浮點數轉換函式(Floating-point conversion routines)

F.5 流程控制函式(Flow-control routines)

F.6 圖形常式(Graphics routines)

F.7 I/O 常式(I/O routines)

F.8 序列常式(Ordinal routines)

F.9 字串常式(String-handling routines)

F.10 Text-file 常式(Text-file routines)

F.11 變動型態常式(Variant support routines)

___________________________________________________________________________________ Delphi 常用函數 of 1

F.1 數學運算

Abs

用途絕對值

引用單元 System

函數宣告 function Abs(X);

範例 var

i: integer;

begin

i:=Abs(-157); {157}

end;

Frac

用途取一個實數的小數部份

引用單元 System

函數宣告 function Frac(X: Real): Real;

範例 var

r: Real;

begin

r:=Frac(123.456) {0.456}

r:=Frac(-123.456) {-0.456}

end;

Int

用途取一個實數的整數部份

引用單元 System

函數宣告 function Int(X: Real): Real;

範例 var

r: Real;

begin

r:=Int(123.456); {123.0}

r:=Int(-123.456); {-123.0}

end;

___________________________________________________________________________________ Delphi 常用函數 of 2

MaxIntValue

用途傳回陣列中最大的整數

引用單元 Math

函數宣告 function MaxIntValue(const Data: array of Integer): Integer;

MinIntValue

用途傳回陣列中最小的整數

引用單元 Math

函數宣告 function MinIntValue(const Data: array of Integer): Integer;

MaxValue

用途傳回陣列中最大的數值

引用單元 Math

函數宣告 function MaxValue(const Data: array of Double): Double;

MinValue

用途傳回陣列中最小的數值

引用單元 Math

函數宣告 function MinValue(const Data: array of Double): Double;

Random

用途亂數

引用單元 System

函數宣告 function Random[(Range: Integer)];

範例 var

i: integer;

begin

Randomize;

for i:=1 to 50 do

begin

Canvas.TextOut(Random(Width),Random(Height),’Boo’);

end;

end;

___________________________________________________________________________________ Delphi 常用函數 of 3

Randomize

用途亂數子

引用單元 System

函數宣告 procedure Randomize;

Sum、SumInt

用途計算陣列中數值的總合

引用單元 Math

函數宣告 function Sum(const Data: array of Double):

Extended register;

function SumInt(const Data:array of Integer):

Integer register;

F.2 日期與時間函數

Date

用途傳回目前日期

引用單元 SysUtils

函數宣告 function Date: TDataTime;

範例 procedure TForm1.Button1Click(Sender: TObject);

begin

Label1.Caption:= ’Today is ‘+DateToStr(Date);

end;

DateTimeToStr

用途轉換日期時間為預設格式字串


函數宣告 function DateTimeToStr(DateTime: TDateTime): string;


begin

Label1.Caption:=DateTimeToStr(Now);

end;

___________________________________________________________________________________ Delphi 常用函數 of 4

DateTimeToString

用途轉換日期時間為自定格式字串


函數宣告 Procedure DateTimeToString(var Result: string;const Format:

string; DateTime: TDateTime);


var

s: string;

begin

DateTimeToString(s, ’yyyy/mm/dd at hh:mm AM/PM’, Now);

Label1.Caption:=s;

end;

說明格式字元參考 FormatDataTime

DateTimeToSystemTime

用途轉換 Delphi 日期時間格式為 Win32 API 格式


函數宣告 function DateTimeToSystemTime(DateTime: TDateTime;

var SystemTime: TSystemTime);

DateToStr

用途轉換日期為預設格式字串(yyyy/mm/dd)


函數宣告 function DateToStr(Date: TDateTime): string;

DayOfWeek

用途取得星期


函數宣告 function DayOfWeek(Date: TDateTime): integer;

說明星期日：1、星期一：2 .....

FormatDateTime

用途轉換日期時間為指定的格式字串


___________________________________________________________________________________ Delphi 常用函數 of 5

函數宣告 function FormatDateTime(const Format: string; DateTime:

TDateTime): string;

說明格式

c 內定值(1996/11/20 09:20:15 PM)

d 日期，前面不補 0

dd 日期，前面補 0

ddd 中文星期

Dddd 中文星期

ddddd 日期(1996/11/20)

dddddd 日期(1996 年 11 月 20 日)

m 月份，前面不補 0

mm 月份，前面補 0

mmm 中文月份

mmmm 中文月份

Yy 年度(00-99)

yyyy 年度(0000-9999)

h 小時(0-23)

hh 小時(00-23)

n 分鐘(0-59)

nn 分鐘(00-59)

s 秒鐘(0-59)

ss 秒鐘(00-59)

t 時間(09:20 PM)

tt 時間(09:20:15 PM)

am/pm 顯示 am 或 pm(可大寫)

a/p 顯示 a 或 p

IncMonth

用途取得指定月數以後的日期


函數宣告 function IncMonth(const Date: TDateTime; NumberOfMonths:

Integer): TDateTime;

IsLeapYear

用途是否潤年


___________________________________________________________________________________ Delphi 常用函數 of 6

函數宣告 function IsLeapYear(Year: Word): Boolean;

Now

用途傳回目前日期時間


函數宣告 function Now: TDateTime;

StrToDate

用途轉換字串為 TDateTime 型態的日期


函數宣告 function StrToDate(const S: string): TDateTime;


var

ADate: TDateTime;

begin

ADate:=StrToDate(Edit1.Text);

end;

StrToDateTime

用途轉換字串為 TDateTime 型態的日期時間


函數宣告 function StrToDateTime(const S: string): TDateTime;

StrToTime

用途轉換字串為 TDateTime 型態的時間


函數宣告 function StrToTime(const S: string): TDateTime;

Time

用途傳回目前時間


函數宣告 function Time: TDateTime;

___________________________________________________________________________________ Delphi 常用函數 of 7

TimeToStr

用途轉換時間為預設格式字串


函數宣告 function TimeToStr(Time: TDateTime): string;

F.3 檔案管理

ChangeFileExt

用途變更檔案的副檔名


函數宣告 function ChangeFileExt(const FileName, Extension: string):

string;


var

s, p1, p2: string;

begin

p1:= ’abc.txt’;

p2:= ’.ini’;

s:=ChangeFileExt(p1, p2); {’abc.ini’}

end;

CreateDir

用途建立新的目錄


函數宣告 function CreateDir(const Dir: String): Boolean;

說明建立成功傳回 True

DateTimeToFileDate

用途將 TDateTime 型態的日期時間轉換為 DOS 型態


函數宣告 function DateTimeToFileDate(DateTime: TDateTime): Integer;

DeleteFile

___________________________________________________________________________________ Delphi 常用函數 of 8

用途刪除檔案


函數宣告 function DeleteFile(const: FileName: String): Boolean;

說明刪除成功傳回 True

DirectoryExists

用途檢查目錄是否存在


函數宣告 function DirectoryExists(Name: String): Boolean;

DIskFree

用途磁碟剩餘空間(Bytes)


函數宣告 function DiskFree(Drive: Byte): Integer;

說明 0=目前磁碟機，1=A 磁碟機，2=B 磁碟機，以下類推。

傳回值若為-1，表示磁碟機偵測錯誤

DIskSize

用途磁碟空間大小(Bytes)


函數宣告 function DiskSize(Drive: Byte): Integer;

說明 0=目前磁碟機，1=A 磁碟機，2=B 磁碟機，以下類推。

傳回值若為-1，表示磁碟機偵測錯誤

ExpandFileName

用途取得目前所在路徑加上檔案名稱


函數宣告 function ExpandFileName(const FileName: String): String;

說明目前路徑為 c:\windows\

ExpandFileName(’123.txt’);

傳回’ c:\windows\123.txt’

ExpandUNCFileName

___________________________________________________________________________________ Delphi 常用函數 of 9

用途同上(取得網路路徑)


函數宣告 function ExpandUNCFileName(const FileName: String): String;

ExtractFileDir

用途取得字串中的路徑


函數宣告 function ExtractFileDir(const FileName: String): String;


var

s, p1: string;

begin

p1:= ’c:\windows\abc.txt’;

s:=ExtractFileDIr(p1); {’c:\windows’}

end;

ExtractFileDrive

用途取得字串中的磁碟機名稱


函數宣告 function ExtractFileDrive(const FileName: String): String;


var

s, p1: string;

begin


s:=ExtractFileDIr(p1); {’c: ’}

end;

ExtractFileExt

用途取得字串中檔案名稱的副檔名


函數宣告 function ExtractFileExt(const FileName: String): String;


var

s, p1: string;

begin ___________________________________________________________________________________ Delphi 常用函數 of 10


s:=ExtractFileDIr(p1); {’.txt’}

end;

ExtractFileName

用途取得字串中的檔案名稱


函數宣告 function ExtractFileName(const FileName: String): String;


var

s, p1: string;

begin


s:=ExtractFileName(p1); {’abc.txt’}

end;

ExtractFilePath

用途取得字串中的路徑


函數宣告 function ExtractFilePath(const FileName: String): String;


var

s, p1: string;

begin


s:=ExtractFileName(p1); {’ c:\windows\’}

end;

ExtractRelativePath

用途取得對應於 BaseName 的路徑


函數宣告 function ExtractRelativePath(const BaseName, DesName:

String): String;


var

___________________________________________________________________________________ Delphi 常用函數 of 11

s, p1: string;

begin


s:=ExtractFileName(p1); {’c:\windows\’}

end;

FileSearch

用途尋找檔案在磁碟機中的路徑


函數宣告 function FileSearch(const Name, DirList: String): String;


var

s: string;

begin

s:=ExtractFileName(’abc.txt, c:\windows\’);

{’c:\windows\abc.txt’}

end;

說明找不到傳回空字串。

FileAge

用途傳回檔案的日期及時間(DOS 型態)


函數宣告 function FileAge(const FileName: String): Integer;


var

s: string;

FileDate: TDateTime;

DateTime: TDateTime;

begin

FileDate:=FileAge(’c:\windows\abc.txt’);

DateTime:=FileDateToDateTime(FileDate);

s:=DateTimeToStr(DateTim1);

end;

FileDateToDateTime

用途轉換 DOS 型態的日期時間為 TDateTime 型態

___________________________________________________________________________________ Delphi 常用函數 of 12


函數宣告 function FileDateToDateTime(FileDate: Integer): TDateTime;

範例請參考 FileAge

FileGetDate

用途傳回檔案的日期與時間(DOS 型態)


函數宣告 function FileGetDate(Handle: Integer): Integer;


var

FileHandle: Integer;

s: string;

FileDate: TDateTime;

DateTime: TDateTime;

begin

FileHandle:=FileOpen(’c:\windows\abc.txt’,

fmOpenReadWrite);

if FileHandle>0 then

begin

FileDate:=FileGetDate(FileHandle);

DateTime:=FileDateToDateTime(FileDate);

s:=DateTImeToStr(DateTime);

FileClose(FileHandle);

end

else

s:= ’Open File Error! ’;

end;

FileSetDate

用途設定檔案的日期時間(DOS 型態)


函數宣告 function FileSetDate(Handle: Integer; Age: Integer):

Integer;

說明傳回 0 表示設定成功

___________________________________________________________________________________ Delphi 常用函數 of 13

RenameFile

用途更改檔名


函數宣告 function RenameFile(const OldName, NewName: String):

Boolean;

說明傳回 True 表示更改成功

FileExists

用途判斷檔案是否存在


函數宣告 function FileExists(const FileName: String): Boolean;

說明傳回 True 表示檔案存在

FileOpen

用途開檔


函數宣告 function FileOpen(const FileName: String; Mode: Integer):

Integer;

說明開檔失敗傳回-1

開檔模式：

fmOpenRead 只允許讀取

fmOpenWrite 只允許寫入

fmOpenReadWrite 允許讀取與寫入

fmShareCompat

fmShareExclusive 不允許其它操作

fmShareDenyWrite 允許其它操作，但不能寫入

fmShareDenyRead 允許其它操作，但不能讀取

fmShareDenyNone 允許其它操作

範例請參考 FileSeek

FileCreate

用途建檔


函數宣告 function FileCreate(const FileName: String): Integer;


___________________________________________________________________________________ Delphi 常用函數 of 14

FileClose

用途關檔


函數宣告 function FileClose(Handle: Integer);


FileRead

用途讀取檔案


函數宣告 function FileRead(Handle: Integer; var Buffer;

Count: Integer): Integer;


FileWrite

用途寫入檔案


函數宣告 function FileWrite(Handle: Integer; const Buffer;

Count: Integer): Integer;


FileSeek

用途移動檔案指標


函數宣告 function FileSeek(Handle, Offset, Origin: Integer):Integer;

說明 Origin=0：讀/寫指標由檔案開頭算起

Origin=1：讀/寫指標由目前位置算起

Origin=2：讀/寫指標移度到檔案結束處


var

FileHandle: Integer;

FileName: String;

Buffer: PChar;

s: String;

ReadBytes: Integer;


FileName:= ’c:\windows\abc.txt’;

s:= ’1234567890’;

if FileExists(FileName) then

FileHandle:=FileOpen(FileName, fmOpenReadWrite)

else

FileHandle:=FileCreate(FileName);

if FileHandle<0 then

begin

ShowMessage(’開檔失敗’);

Exit;

end;

GetMem(Buffer, 100);

try

StrPCopy(Buffer, s);

FileWrite(FileHandle, Buffer^, 10);

FileSeek(FileHandle, 4, 0);

ReadBytes:=FileRead(FileHandle, Buffer^, 100);

Buffer[ReadBytes]:=#0;

finally

FreeMem(Buffer);

end;

FileClose(FileHandle);

end;

FileGetAttr

用途取得檔案屬性


函數宣告 function FileGetAttr(const FileName: String): Integer;


var

s: String;

begin

s:=IntToStr(FileGetAttr(’c:\windows\abc.txt’);

end;

FileSetAttr

___________________________________________________________________________________ Delphi 常用函數 of 16

用途設定檔案屬性


函數宣告 function FileSetAttr(const FileName: String; Attr Integer):

Integer;

FindClose

FindFirst

FindNext

用途結束 FindFirst/FindNext

尋找第一個符合的檔案

尋找下一個符合的檔案


函數宣告 procedure FileClose(var F: TSearchRec);

function FindFirst(const Path: String; Attr: Integer;

var F: TSearchRec): Integer;

function FindNext(var F: TSearchRec): Integer;

說明搜尋成功傳回 0

範例 var

sRec: TSearchRec;

procedure TForm1.SearchClick(Sender: TObject);

begin

FindFirst(’c:\windows\abc.txt’, faAnyFile, SRec);

end;

procedure TForm1.SearchAgainClick(Sender: TObject);

begin

FindNext(SRec);

end;

procedure TForm1.FormClose(Sender: TObject);

begin

FindClose;

end;

F.4 浮點數轉換函式

FloatToDecimal

用途轉換浮點數為十進位數

___________________________________________________________________________________ Delphi 常用函數 of 17


函數宣告 function FloatToDecimal(var Result: TFloatRec; const Value;

ValueType: TFloatValue; Precision, Decimals:

Integer);

FloatToStrF

用途轉換浮點數為格式化字串


函數宣告 function FloatToStr(Value: Extended; Format: TFloatFormat;

Precision, Digits: Integer): String;

FloatToStr

用途轉換浮點數為字串


函數宣告 function FloatToStr(Value: Extended);

FloatToText

用途轉換浮點數為格式化十進位數


函數宣告 function FloatToText(Buffer: PChar; const Value;

ValueType: TFloadValue; Format: TFloadFormat;

Precision, Digits: Integer) Integer;

FloatToTextFmt

用途轉換浮點數為格式化十進位數


函數宣告 function FloatToText(Buffer: PChar; const Value;

ValueType: TFloadValue; Format: PChar) Integer;

FormatFloat

用途轉換浮點數為格式化字串


函數宣告 function FormatFloat(const Format: String;

___________________________________________________________________________________ Delphi 常用函數 of 18

Value: Extended):String;

StrToFloat

用途轉換字串為浮點數


函數宣告 function StrToFloat(const S: String): Extended;

說明如果字串 S 內有非數字字元，會產生錯誤訊息

TextToFloat

用途轉換 null-terminated 字串為浮點數


函數宣告 function TextToFloat(Buffer: PChar; var Value;

ValueType: TFloatValue): Boolean;

F.5 流程控制常式

AddTerminateProc

用途加入程式終結程序


函數宣告 procedure AddTerminateProc(TermProc: TTerminateProc);

說明所有程序都傳回 True 程式才會正常結束

範例請參考 CallTerminateProcs

Break

用途從 for, while, repeat 迴圈中跳出


函數宣告 procedure Break;

範例 var

s: String;

begin

while True do

begin

ReadLn(s);

___________________________________________________________________________________ Delphi 常用函數 of 19

try

if s=’ ’ then Break;

WriteLn(s);

finally

{do something}

end;

end;

end;

CallTerminateProcs

用途呼叫終結程序


函數宣告 function CallTerminateProcs: Boolean;

說明 Delphi 會自動執行

Continue

用途在 for, while, repeat 迴圈中繼續執行


函數宣告 procedure Continue;

範例 var

i: Integer;

begin

For i:=0 to 100 do

begin

if i<>7 then Continue;

ShowMessage(’My Luck Number: ’+IntToStr(i));

end;

end;

Exit

用途離開一個程序或函式


函數宣告 procedure Exit;

___________________________________________________________________________________ Delphi 常用函數 of 20

Halt

用途結束程式返回作業系統


函數宣告 procedure Halt[(Exitcode: Integer)];

F.6 圖形常式

ColorToIdent

用途取得 TColor 值的名稱

引用單元 Graphics

函數宣告 function ColorToIdent(Color: LongInt; var Ident: String)

: Boolean;

說明 clWhite, clSilver 就是 Ident

ColorToRGB

用途轉換 TColor 值為 RGB 表示式


函數宣告 function ColorToRGB(Color: TColor): LongInt;

ColorToString

用途轉換 TColor 值為字串


函數宣告 function ColorToString(Color: TColor): String;

CopyPalette

用途依照現有調色盤建立新的調色盤物件


函數宣告 function CopyPalette(Category: HPALETTE): HPALETTE;

GraphicExtension

用途傳回圖形檔副檔名


函數宣告 function GraphicExtension(GraphicClass: TGraphicClass)

___________________________________________________________________________________ Delphi 常用函數 of 21

: String;

說明傳回值

TBitmap bmp

TIcon ico

TMetafile emf

TJPEGImage jpg

GraphicFileMask

用途傳回圖形檔副檔名選項


函數宣告 function GraphicFileMask(GraphicClass: TGraphicClass)

: String;

說明傳回值

TBitmap *.bmp

TIcon *.ico

TMetafile *.emf; *.wmf

TJPEGImage *.jpg; *.jpeg

TGraphic *.jpg; *.jpeg; *.bmp; *.ico; *.emf; *.wmf

GraphicFilter

用途傳回圖形檔副檔名 Filter


函數宣告 function GraphicFilter(GraphicClass: TGraphicClass)

: String;

Point

用途產生 TPoint 物件


函數宣告 function Point(AX, AY: Integer): TPoint;

Rect

用途產生 TRect 物件


函數宣告 function Rect(ALeft, ATop, ARight, ABottom: Integer): TRect;

___________________________________________________________________________________ Delphi 常用函數 of 22

F.7 I/O 常式

AssignFile

用途指定檔案給一個檔案變數

引用單元 System

函數宣告 procedure AssignFile(var F; FileName: String);

說明一個檔案不可重複執行 AssignFile

CloseFile

用途關閉檔案

引用單元 System

函數宣告 procedure CloseFile(var F);

IOResult

用途傳回最進一次執行 I/O 函數的錯誤代碼

引用單元 System

函數宣告 function IOResult: Integer;

說明傳回 0 表示沒有錯誤

Reset

用途開啟一個可供讀取的檔案

引用單元 System

函數宣告 procedure Reset(var F [: File; Resize: Word]);

Rewrite

用途建立一個可供寫入的新檔案

引用單元 System

函數宣告 procedure ReWrite(var F [: File; Resize: Word]);

Seek

___________________________________________________________________________________ Delphi 常用函數 of 23

用途移動檔案指標

引用單元 System

函數宣告 procedure Seek(var F; N: LongInt);

說明從檔案起始位置開始

Truncate

用途刪除將目前檔案指標位置之後的檔案內容

引用單元 System

函數宣告 procedure Truncate(var F);

FilePos

用途傳回目前檔案指標位置

引用單元 System

函數宣告 function FilePos(var F): LongInt;

FileSize

用途取得檔案長度

引用單元 System

函數宣告 procedure FileSize(var F): Integer;

說明不可為文字檔

Eof

用途傳回檔案指標是否已到檔尾

引用單元 System

函數宣告 function Eof(var F): Boolean;

function Eof[(var F: Text)]: Boolean;

Erase

用途刪除檔案

引用單元 System

函數宣告 procedure Erase(var F);

Rename

___________________________________________________________________________________ Delphi 常用函數 of 24

用途更改檔名

引用單元 System

函數宣告 procedure Rename(var F; NewName: String);

GetCurrentDir

SetCurrentDir

用途傳回目前目錄

設定目前目錄

引用單元 System

函數宣告 function GetCurrentDir: String;

function SetCurrentDir(const Dir: String): Boolean;

GetDir

用途取得指定磁碟機的目錄

引用單元 System

函數宣告 procedure GetDir(D: Byte; var S: String);

說明 D=0：目前磁碟機；1=A；2=B....

此函式不檢查磁碟機錯誤

MkDir

用途建立子目錄

引用單元 System

函數宣告 procedure mkDir(S: String);

RmDir

RemoveDir

用途刪除一個空的子目錄

引用單元 System

函數宣告 procedure RmDir(S: String);

function RemoveDir(const Dir: String): Boolean;

說明 RmDir 不成功會引發 I/O Error，RemoveDir 不成功則傳回 False

___________________________________________________________________________________ Delphi 常用函數 of 25

ChDir

用途改變目前目錄

引用單元 System

函數宣告 procedure ChDir(S: String);

F.8 序列常式

Dec

用途遞減

引用單元 System

函數宣告 procedure Dec(var X[; N: LongInt]);

說明 Dec(X) X:=X-1;

Dex(X, N) X:=X-N;

Inc

用途遞增

引用單元 System

函數宣告 procedure inc(var X[; N: LongInt]);

說明 Dec(X) X:=X+1;

Dex(X, N) X:=X+N;

Odd

用途檢查是否為奇數

引用單元 System

函數宣告 procedure Odd(X: LongInt): Boolean;

說明 Odd(1) True

Odd(2) False

F.9 字串常式

AdjustLineBreaks

用途將字串的換行符號全部改為 #13#10


___________________________________________________________________________________ Delphi 常用函數 of 26

函數宣告 function AdjustLineBreaks(const S: string): string;

AnsiLowerCase

用途將所有字元轉換為小寫字元


函數宣告 function AnsiLowerCase(const S: string): string;

範例 var

s: String;

begin

s:= ’KYLIX’;

s:=AnsiLowerCase(s); {’ kylix’}

end;

AnsiUpperCase

用途將所有字元轉換為大寫字元


函數宣告 function AnsiUpperCase(const S: string): string;

範例 var

s: String;

begin

s:= ’kylix’;

s:=AnsiUpperCase(s); {’KYLIX’}

end;

Concat

用途字串相加

引用單元 System

函數宣告 function Concat(s1[, s2,...,sn]: string): string;

範例 var

s: String;

begin

s:=Concat(’ABC’, ’DEF’); {’ABCDEF’}

end;

___________________________________________________________________________________ Delphi 常用函數 of 27

Copy

用途截取字串

引用單元 System

函數宣告 function Copy(s: string; Index, Count: Integer): string;

範例 var

s: String;

begin

s:= ’ABCDEF’;

s:=Copy(s, 2, 3); {’BCD’}

end;

Delete

用途刪除字串中的字元

引用單元 System

函數宣告 function Delete(var s: string; Index, Count: Integer);

範例 var

s: String;

begin

s:= ’ABCDEF’;

Delete(s, 2, 3); {’AEF’}

end;

Insert

用途將子字串插入另一字串中

引用單元 System

函數宣告 function Insert(Source: String; var s: String;

Index: Integer);

範例 var

s: String;

begin

s:= ’ABCDEF’;

Insert(’-XYZ-’, s, 3); {’AB-XYZ-CDEF’}

end;

Str

用途轉換數值為格式化字串

___________________________________________________________________________________ Delphi 常用函數 of 28

引用單元 System

函數宣告 function Str(X[: Width[:Decimals ]]; var S);

範例 var

s: String[11];

i: Integer;

begin

i:=12345;

Str(i, s); {’12345’}

end;

StringOfChar

用途傳回指定次數的字元

引用單元 System

函數宣告 function StringOfChar(Ch: Char; Count: Integer): String;

範例 var

s: String;

begin

s:=StringOfChar(’A’, 6); {’AAAAAA’}

end;

Val

用途轉換字串為數字

引用單元 System

函數宣告 function Val(S; var V; var Code: Integer);

說明 Code=0 轉換成功

範例 var

i: Integer;

begin

i:=Val(’12345’); {12345}

end;

Length

用途取得字串長度

引用單元 System

函數宣告 function Length(S: String): Integer;

___________________________________________________________________________________ Delphi 常用函數 of 29

SetLength

用途設定字串長度

引用單元 System

函數宣告 function SetLength(var S: String; NewLength: Integer);

SetString

用途設定字串內容與長度

引用單元 System

函數宣告 function SetString(var S: String; buffer: PChar;

Len: Integer);

Pos

用途取得子字串在母字串中的位置

引用單元 System

函數宣告 function Pos(Substr: String; S: String): Integer;

範例 var

s: String;

i: Integer;

begin

s:= ’1234567890’;

i:=pos(s, ’7’); {7}

end;

LowerCase

用途將字串轉換為小寫字元


函數宣告 function LowerCase(const S: string): string;

範例 var

s: String;

begin

s:= ’KYLIX’;

s:=LowerCase(s); {’kylix’}

end;

UpperCase

用途將字串轉換為大寫字元


___________________________________________________________________________________ Delphi 常用函數 of 30

函數宣告 function UpperCase(const S: string): string;

範例 var

s: String;

begin

s:= ’kylix’;

s:=UpperCase(s); {’KYLIX’}

end;

Trim

TrimLeft

TrimRight

用途清除字串前後空白與控制字元

清除字串左邊空白與控制字元

清除字串右邊空白與控制字元


函數宣告 function Trim(const S: string): string;

function TrimLeft(const S: string): string;

function TrimRight(const S: string): string;

StrAlloc

用途配置字串空間


函數宣告 function StrAlloc(Size: Cardinal): PChar;

說明 Size=字串最大空間+1

StrBufSize

用途傳回由 StrAlloc 配置空間的大小


函數宣告 function StrBufSize(Str: PChar): Cardinal;

StrCat

用途字串相加


函數宣告 function StrCat(Dest, Source: PChar): PChar;

範例 const

___________________________________________________________________________________ Delphi 常用函數 of 31

Obj: PChar=’Object’;

Pascal: PChar=’Pascal’;

var

s: array[0..15] of Char;

begin

StrCopy(s, Obj);

StrCat(s, ’ ’);

StrCat(s, Pascal);

Canvas.TextOut(10, 10, StrPas(s));

end;

StrComp

用途比較兩字串大小


函數宣告 function StrComp(Str1, Str2: PChar): Integer;

範例 const

s1: PChar=’Wacky’;

s2: PChar=’Code’;

var

c: Integer;

Result: String;

begin

c:=StrComp(s1, s2);

if c<0 then Result:= ’is less than’ else

if c>0 then Result:= ’is greater than’ else

Result:= ’is equal to’;

Canvas.TextOut(10, 10, StrPas(s1)+Result+StrPas(s2));

end;

StrCopy

用途拷貝字串


函數宣告 function StrCopy(Dest, Source: PChar): Integer;

範例 var


begin

StrCopy(s, ’ObjectPascal’);

___________________________________________________________________________________ Delphi 常用函數 of 32


end;

StrDispose

用途釋放 StrAlloc 或 StrNew 所配置的空間


函數宣告 procedure StrDispose(Str: PChar);

範例 const

s: PChar=’Nevermore’;

var

p: PChar;

begin

p:=StrNew(s);

Canvas.TextOut(10, 10, StrPas(p));

StrDispost(p);

end;

StrECopy

用途拷貝字串並傳回字串結束位址


函數宣告 function StrECopy(Dest, Source: PChar): PChar;

範例 const

Turbo: PChar=’Object’;

Pascal: PChar=’Pascal’;

var


begin

StrECopy(StrECopy(StrECopy(s, Turbo), ’ ’), Pascal);


end;

StrEnd

用途傳回字串結束位址


函數宣告 function StrEnd(Str: PChar): PChar;

範例 const

s: PChar=’Yankee Doodle’; ___________________________________________________________________________________ Delphi 常用函數 of 33

begin

Canvas.TextOut(5, 10, ’The string length of

’ ’’+StrPas(s)+ ’ ’ ’ ’is’+IntToStr(StrEnd(s)-s));;

end;

StrFmt

StrLFmt

用途格式化字串


函數宣告 function StrFmt(Buffer, Format: PChar;

const Args: array of const): PChar;

function StrLFmt(Buffer: PChar, MaxLen: Cardinal;

Format: PChar; const Args: array of const): PChar;

StrIComp

用途比較字串大小(不分大小寫)


函數宣告 function StrIComp(Str1, Str2: PChar): Integer;

範例 const

s1: PChar=’Wacky’;

s2: PChar=’Code’;

var

c: Integer;

Result: String;

begin

c:=StrIComp(s1, s2);

if c<0 then Result:= ’is less than ’ else




end;

StrLCat

用途字串相加(定長字串)


函數宣告 function StrLCat(Dest, Source: PChar; MaxLen: Cardinal):

___________________________________________________________________________________ Delphi 常用函數 of 34

Integer;

範例 var


begin

StrLCat(s, ’Object’, +Size);

if c<0 then Result:= ’is less than ’ else




end;

StrLComp

用途比較字串大小(定長字串)


函數宣告 function StrLComp(Str1, Str2: PChar; MaxLen: Cardinal):

Integer;

範例 const

s1: PChar=’Enterprise’;

s2: PChar=’Enter’;

var

Result: String;

begin

c:=StrLComp(s1, s2, 5)=0 then

Result:= ’equal’

else

Result:= ’different’;

Canvas.TextOut(10, 10, ’The first five characters are’

+Result);

end;

StrLCopy

用途拷貝字串(定長字串)


函數宣告 function StrLCopy(Str1, Str2: PChar; MaxLen: Cardinal):

Integer;

範例 var

s: array[0.11] of Char;

___________________________________________________________________________________ Delphi 常用函數 of 35

begin

StrLCopy(s, ‘ObjectPascal’, SizeOf(s)-1);


end;

StrLen

用途傳回字串長度(不含終止位元)


函數宣告 function StrLen(Str: PChar): Cardinal;

範例 const

s: PChar=’E Pluribus Unum’;

begin

Canvas.TextOut(5, 10, ‘The string length of ‘’’+StrPas(s)+

‘’’is’+IntToStr(StrLen(s)));

end;

StrLIComp

用途比較字串大小


函數宣告 function StrLIComp(Str1, Str2: PChar;

MaxLen: Cardinals): Cardinal;

範例 const

s1: PChar=’Enterprise’;

s2: PChar=’Enter’;

var

Result: String;

begin

if StrLIComp(s1, s2, 5)=0 then

Result:=’equal’

else

Result:=’different’;

Canvas.TextOut(10, 10, ‘The first five characters are ‘ +

Result);

end;

StrLower

用途將所有字元轉換為小寫字元

___________________________________________________________________________________ Delphi 常用函數 of 36


函數宣告 function StrLower(Str: PChar): PChar;

範例 const

s: PChar=’KYLIX’;

begin

Canvas.TextOut(10, 10, StrPas(StrLower(s))+

’ ’+StrPas(StrUpper(s)));

end;

StrMove

用途從來源字串拷貝 n 個 Bytes 到目的字串(不含終止位元)


函數宣告 function StrMove(Dest, Source: PChar; Count Cardinal): PChar;

範例 function AHeapaString(S: PChar): PChar;

var

L: Cardinal;

P: PChar;

begin

StrNew := nil;

if (S <> nil) and (S[0] <> #0) then

begin

L := StrLen(S) + 1;

GetMem(P, L);

StrNew := StrMove(P, S, L);

end;

end;

procedure DisposeDaString(S: PChar);

begin

if S <> nil then FreeMem(S, StrLen(S) + 1);

end;

var

S: PChar;

begin

AHeapaString(S);

DisposeDaString(S);

end; ___________________________________________________________________________________ Delphi 常用函數 of 37

StrNew

用途配置字串空間


函數宣告 function StrNew(Str: PChar): PChar;

StrPas

用途轉換 null-terminated 字串為 Pascal-style 字串


函數宣告 function StrPas(Str: PChar): String;

StrPCopy

用途拷貝 Pascal –style 字串到 null-terminated 字串


函數宣告 function StrPCopy(Dest: PChar; Source: String): PChar;

範例 const

a: array[0..79] of Char;

s: String;

begin

s:=’Kylix’;

StrPCopy(a, s);

Canvas.TextOut(10, 10, StrPas(a);

end;

StrPLCopy

用途拷貝 Pascal –style 字串到 null-terminated 字串(定長字串)


函數宣告 function StrLPCopy(Dest: PChar; Source: String;

MaxLen: Cardinal): PChar;

範例 const

a: array[0..79] of Char;

s: String;

begin

s:=’Kylix’;

StrPCopy(a, s);

Canvas.TextOut(10, 10, StrPas(a);

___________________________________________________________________________________ Delphi 常用函數 of 38

end;

StrPos



函數宣告 function StrPos(Str1, Str2: PChar): PChar;

StrRScan

用途取得子字串在母字串中的下一個位址


函數宣告 function StrRScan(Str: PChae; Chr: Char): PChar;

範例 function NamePart(FileName: PChar): PChar;

var

p: PChar;

begin

p := StrRScan(FileName, '\');

if p = nil then

begin

p := StrRScan(FileName, ':');

if p = nil then p := FileName;

end;

NamePart := p;

end;

var

s : string;

begin

s := string(NamePart('C:\Test.fil'));

Canvas.TextOut(10, 10, s);

end;

StrScan



函數宣告 function StrScan(Str: PChae; Chr: Char): PChar;

範例 function HasWildcards(FileName: PChar): Boolean;


HasWildcards := (StrScan(FileName, '*') <> nil) or

(StrScan(FileName, '?') <> nil);

end;

const

P: PChar = 'C:\Test.* ';

begin

if HasWildcards(P) then

ShowMessage('The string has wildcards')

else

ShowMessage('The string doesn't have wildcards');

end;

end;

StrUpper

用途將所有字元轉換為大寫字元


函數宣告 function StrUpper(Str: PChar): PChar;

範例 const

s: PChar=’kylix’;

begin

Canvas.TextOut(10, 10, StrPas(StrLower(s))+

’ ’+StrPas(StrUpper(s)));

end;

F.10 Text-file 常式

Append

用途開啟一個可供 Append 的檔案

引用單元 System

函數宣告 procedure Append(var f: Text);

範例 var

f: TextFile;

begin

if OpenDialog1.Execute then

begin

AssignFile(f, OpenDialog1.FileName); ___________________________________________________________________________________ Delphi 常用函數 of 40

Append(f);

Writeln(f, 'I am appending some stuff to the end of the file.');

Flush(f);

CloseFile(f);

end;

end;

AssignPrn

用途指定檔案到印表機

引用單元 System

函數宣告 procedure AssignPrn(var f: Text);

Eoln

用途測試檔案是否結束

引用單元 System

函數宣告 function Eoln[(var F: Text)]:Boolean;

Flush

用途將緩衝區內的資料存入磁碟

引用單元 System

函數宣告 procedure Flush(var F: Text);

範例 var

f: TextFile;

begin


begin

AssignFile(f, OpenDialog1.FileName);

Append(f);

Writeln(f, 'I am appending some stuff to the end of the file.');

Flush(f);

CloseFile(f);

end;

end;

Read

用途讀檔

___________________________________________________________________________________ Delphi 常用函數 of 41

引用單元 System

函數宣告 procedure Read(F, V1[, V2,...,Vn]);

procedure Read([var F: Text;] V1 [, V2,...,Vn]);

範例 var

f1, f2: TextFile;

ch: Char;

begin


begin

AssignFile(f1, OpenDialog1.FileName);

Reset(f1);

if SaveDialog1.Execute then

begin

AssignFile(f2, OpenDialog1.FileName);

Rewrite(f2);

While not Eof(f1) do

begin

Read(f1, ch);

Write(f2, ch);

end;

CloseFile(f2);

end;

CloseFile(f1);

end;

end;

ReadLn

用途讀檔(一行)

引用單元 System

函數宣告 procedure ReadLn([var F: Text;] V1 [, V2, ..., Vn]);

範例 var

s: String;

begin

Write(‘Enter a line of text:’);

ReadLn(s);

WriteLn(‘You typed:’, s);

WriteLn(‘Hit Enter to exit’);

ReadLn; ___________________________________________________________________________________ Delphi 常用函數 of 42

end;

SeekEof


引用單元 System

函數宣告 function SeekEof[(var F: Text)]: Boolean;

範例 var

f : System.TextFile;

i, j, y : Integer;

begin

AssignFile(f, 'TEST.TXT');

Rewrite(f);

Writeln(f, '1 2 3 4 ');

Writeln(f, '5 6 7 8 ');

Reset(f);

y := 5;

while not SeekEof(f) do

begin

if SeekEoln(f) then Readln;

Read(f, j);

Canvas.TextOut(5, y, IntToStr(j));

y := y + Canvas.TextHeight(IntToStr(j)) + 5;

end;

end;

SeekEoln


引用單元 System

函數宣告 function SeekEoln[(var F: Text)]: Boolean;

SetTextBuf

用途指定 I/O 緩衝區給 text file

引用單元 System

函數宣告 procedure SetTextBuf(var F: Text; var Buf[; Size: Integer]);

範例 var

f, FTwo: System.TextFile;

ch: Char; ___________________________________________________________________________________ Delphi 常用函數 of 43

Buf: array[1..4096] of Char; { 4K buffer }

begin

if OpenDialog1.Execute then begin

AssignFile(f, OpenDialog1.FileName);

System.SetTextBuf(f, Buf);

Reset(f);

AssignFile(FTwo, 'WOOF.DOG');

Rewrite(FTwo);

while not Eof(f) do

begin

Read(f, ch);

Write(FTwo, ch);

end;

System.CloseFile(f);

System.CloseFile(FTwo);

end;

end;

Write

用途寫入檔案

引用單元 System

函數宣告 procedure Write(F, V1, ..., Vn);

procedure Write([var F: Text;] P1 [, P2, ..., Pn]);

WriteLn

用途寫入檔案

引用單元 System

函數宣告 procedure WriteLn([var F: Text;] P1 [, P2, ..., Pn]);

範例 var

s : string;

begin

Write('Enter a line of text: ');

Readln(s);

Writeln('You typed: ',s);

Writeln('Hit <Enter> to exit');

Readln;

___________________________________________________________________________________ Delphi 常用函數 of 44

end;

F.11 變動型態常式

VarArrayCreate

用途建立一個 variant 陣列

引用單元 System

函數宣告 function VarArrayCreate(const Bounds: array of Integer;

VarType: Integer): Variant;

說明 varType (部份)

varEmpty 未定義

varNull variant 為 NULL

varSmallint 16-bit 有號整數

varInteger 32-bit 有號整數

varSingle 單精確度浮點數

varDouble 雙精確度浮點數

varCurrency 金額浮點數

varDate TDateTime

varError 系統錯誤碼

varBoolean 16-bit 布林值

varVariant variant

varUnknown 未知型態

varByte 8-bit 無號整數

varString AnsiString

VarArrayOf

用途建立一個一維 variant 陣列

引用單元 System

函數宣告 function VarArrayOf(const Values: array of Variant): Variant;

說明 var

a: Variant;

begin

a:=VarArrayOf([1, 10, ‘Hello Kylix’, 10000]);

Label1.Caption:=a[2]+’ ‘+IntToStr(a[1]);

end;

___________________________________________________________________________________ Delphi 常用函數 of 45

VarArrayRedim

用途重新定義 variant 陣列中高維註腳

引用單元 System

函數宣告 procedure VarArrayRedim(var A: Variant; HighBound: Integer);

VarArrayRef

用途傳回 variant 陣列的參考

引用單元 System

函數宣告 function VarArrayRef(const A: Variant): Variant;

VarArrayDimCount

用途傳回 variant 陣列的維數

引用單元 System

函數宣告 function VarArrayDimCount(const A: Variant): Integer;

VarArrayHighBound

用途傳回 variant 陣列中一維的高註腳

引用單元 System

函數宣告 function VarArrayHighBound(const A: Variant; Dim: nteger):

Integer;

VarArrayLowBound

用途傳回 variant 陣列中一維的低註腳

引用單元 System

函數宣告 function VarArrayLowBound(const A: Variant; Dim: nteger):

Integer;

範例 var

a: variant;

count, HighBound, LowBound, i: Integer;

s: String;

begin

a:=VarArrayCreate([0, 5, 1, 3], varVariant);

count:=VarArrayDimCount(a);

s:=#13+’維數:’+IntToStr(Count)+#13;

for i:=1 to Count do

begin

HighBound:=VarArrayHighBound(a, i);

___________________________________________________________________________________ Delphi 常用函數 of 46

LowBound:=VarArrayLowBound(a, i);

s:=s+’HighBound:’+IntToStr(highBound)+#13;

s:=s+’LowBound:’+IntToStr(LowBound)+#13;

end;

ShowMessage(s);

end;

VarArrayLock

VarArrayUnLock

用途將 variant 陣列指定給一陣列變數

解除指定

引用單元 System

函數宣告 function VarArrayLock(var A: Variant; Dim: nteger): Point;

procedure VarArrayUnlock(var A: Variant);

範例 type

PArrayData = ^TArrayData;

TArrayData = array[0..9, 1..3] of Integer;

var

a: Variant;

p: PArrayData;

i, j: Integer;

begin

a := VarArrayCreate([1, 3, 0, 9], varInteger);

p := VarArrayLock(A);

try

for i := 0 to 9 do

for j := 1 to 3 do

P^[i, j] := j * 10 + i;

finally

VarArrayUnlock(a);

end;

WriteLn(a[1, 9]); { 19 }

WriteLn(a[3, 4]); { 34 }

end;

VarIsArray

用途測試 variant 是否為陣列

___________________________________________________________________________________ Delphi 常用函數 of 47

引用單元 System

函數宣告 function VarIsArray(const V: Variant): Boolean;

VarIsEmpty

用途測試 variant 是否尚未註冊(空的)

引用單元 System

函數宣告 function VarIsEmpty(const V: Variant): Boolean;

VarIsNull

用途測試 variant 是否為 NULL

引用單元 System

函數宣告 function VarIsNull(const V: Variant): Boolean;

VarAsType

VarCast

用途轉換 Variant 型態

引用單元 System

函數宣告 function VarAsType(const V: Variant; VatType: Integer):

Boolean;

procedure VarCase(var Dest: Variant; const Source: Variant;

VarType: Integer);

說明 VarType 不可為 varArray or varByRef

VarType

用途取得 Variant 型態

引用單元 System

函數宣告 function VarType(const V: Variant): Integer;

VarClear

用途清除 Variant，成為 Unassigned 狀態

引用單元 System

函數宣告 procedure VarClear(var V: Variant);

VarCopy

用途拷貝 Variant

___________________________________________________________________________________ Delphi 常用函數 of 48

引用單元 System

函數宣告 procedure VarCopy(var Dest: Variant; const Source: Variant);

說明與 Dest:=Source; 效果相同

VarFromDataTime

VarToDataTime

用途轉換 DateTime 為 Variant

轉換 Variant 為 DateTime

引用單元 System

函數宣告 function VarFormDateTime(DateTime: TDateTime): Variant;

function VarToDateTime(const V: Variant): TDateTime;

___________________________________________________________________________________ Delphi 常用函數 of 49

del phi function

Documents