BlitzMax/語言/模組
外觀
模組是常量、全域性變數、函式和使用者定義型別的預編譯集合,可供應用程式或其他模組使用。
模組位於主 BlitzMax 目錄中的“mod”目錄中。要建立您自己的模組,您必須使用以下格式在“mod”中新增一個新的子目錄
/mod/modscope.mod/modname.mod
Modscope 應該是一個唯一的名稱(例如,您的組織或公司的名稱),用於將來自同一來源的模組分組在一起。Modscope 和 modname 都應該是有效的識別符號。此外,為了避免 Linux 等區分大小寫檔案系統的問題,建議 modscope 和 modname 使用小寫字母。
您還需要在模組目錄中建立一個主模組原始檔。此檔案必須與 ModuleName 同名
/mod/modscope.mod/modname.mod/modname.bmx
最後,您的原始檔必須在頂部包含 Module 語句
Module modscope.modname
設定好模組後,可以使用 BMK 來構建它
bmk makemods modscope.modname
或者,要構建同一範圍內的所有模組
bmk makemods modscope
要在另一個模組中使用模組,只需使用 Import 命令匯入它
Import modscope.modname
這將匯入指定的模組 *以及* 該模組匯入的任何模組。換句話說,Import 是遞迴的。
預設情況下,BlitzMax 在編譯應用程式時匯入它在“brl”和“pub”模組範圍中找到的 *每個* 模組。但是,這會導致生成笨重的可執行檔案。您可以使用 Framework 命令覆蓋此預設行為
- Framework modscope.modname
Framework 應出現在您的主應用程式原始檔頂部。
指定應用程式框架可以阻止 BlitzMax 匯入所有模組。只有框架模組和任何顯式匯入的模組會被匯入到您的應用程式中。
例如,要建立一個“簡化”的 BASIC 應用程式,您可以使用 BRL.Basic 框架
Framework BRL.Basic 'create a stripped down app Print "Hello World!"
在構建多檔案應用程式時,主原始檔中找到的框架(如果有)會自動傳遞到應用程式中的所有“子”檔案。但是,如果您更改此“預設”框架,則需要“全部重新構建”才能使更改影響其他檔案。