模組:Complex Number/Example/doc
这是Module:Complex Number/Example的文档页面
此頁面是Module:Complex Number/Example的模块文档。 此頁面可能包含了模板的使用說明、分類和其他内容。 |
本說明文件主要目的是說明如何定義一個新的與Module:Complex Number系列函數庫的兼容函數庫。
說明
若要定義一個新的Module:Complex Number系列函數庫需要實作一個新的物件,並實作其Metatables中的運算子。
定義數學資料結構
數學資料結構需要定義成一個table,並以table來定義或表達所需要的數字。即使數字只有單一物件,也許使用table因為這樣才能透過實作Metatables來完成Module:Complex Number系列函數庫所需的相關功能。
- numberType:本數學資料結構的類型名稱(字串),用於Module:Complex Number系列函數庫的識別(參閱第92行)
- update():更新結構數值的成員函數(參閱第89行)
- clean():去除過小值或誤差值的成員函數,並返回結果。若無此需求,直接返回自身即可。(參閱第90行)
實作metatable
需定義Metatables的 __add(加法)、 __sub(減法)、 __mul(乘法)、 __div(除法)、 __mod(取餘數)、 __unm(相反數)、 __eq(相等判斷)、 __tostring(以字串表達本物件)
定義數學資料結構的建構子
由於數學資料結構需要定義為table因此需要有建構子來賦予該結構初值。建構子需要完成以下步驟:
定義數學庫的初始化函數
數學庫必須是一個獨立物件,所有的函數皆需定義在數學函數庫物件下(包括數學資料結構的建構子)。初始化數學庫的函數名稱必為init,當中需要定義以下內容:
- 各項常數的定義(參閱第102行)
- numberType成員函數定義為Module:Complex Number中的_numberType(參閱第106行)
- constructor成員函數設定為數學結構的建構子(參閱第107行)
- elements成員變數設定為單位元素的清單(參閱第108行)
完成數學庫的定義
視情況定義列於Module:Complex_Number/doc#比較中的各項函數(如需支援Module:Complex_Number/Functions的情況)。