source/documentation/reference/module.html · PureBasic/SpiderBasicPreference

代码拉取完成,页面将自动刷新

richgiteeai

Watch

不关注关注所有动态仅关注版本发行动态关注但不提醒动态

1 Star 0 Fork 0

PureBasic/SpiderBasicPreference

代码 Issues 0 Pull Requests 0 Wiki 统计流水线

服务

加入 Gitee

与超过 1400万开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)

免费加入

已有帐号? 立即登录

文件

master

分支 (1)

管理

master

该仓库未声明开源许可证文件(LICENSE),使用请关注具体项目描述及其代码上游依赖。

项目仓库所选许可证以仓库主分支所使用许可证为准

克隆/下载

HTTPS SSH SVN SVN+SSH 下载ZIP

提示

下载代码请复制以下命令到终端执行

为确保你提交的代码身份被 Gitee 正确识别,请执行以下命令完成配置

git config --global user.name userName 
git config --global user.email userEmail

初次使用 SSH 协议进行代码克隆、推送等操作时,需按下述提示完成 SSH 配置

1 生成 RSA 密钥

2 获取 RSA 公钥内容,并配置到 SSH公钥中

在 Gitee 上使用 SVN,请访问使用指南

使用 HTTPS 协议时,命令行会出现如下账号密码验证步骤。基于安全考虑,Gitee 建议配置并使用私人令牌替代登录密码进行克隆、推送等操作

Username for 'https://gitee.com': userName

Password for 'https://userName@gitee.com': # 私人令牌

分支 1

标签 0

SpiderBasicPreference

source

documentation

reference

module.html

module.html 7.84 KB

<html><head><title>Module</title></head>
<body bgcolor="#FFFFFF" link="#207BC3" vlink="#003B83" alink="#003B83">
Module

Syntax<blockquote><pre>DeclareModule &lt;name&gt;
 ...
EndDeclareModule

Module &lt;name&gt;
 ...
EndModule

UseModule &lt;name&gt;
UnuseModule &lt;name&gt;
</pre></blockquote>
Description <blockquote>

Modules are an easy way to isolate code part from the main code, allowing code reuse and sharing 
without risk of name conflict. In some other programming languages, modules are known as 'namespaces'. 
A module must have a DeclareModule section (which is the public interface) and an associated 
Module section (which is the implementation). 
Only items declared in the DeclareModule section will be accessible from outside the module. All the 
code put in the Module section will be kept private to this module. Items from main code 
like procedures, variables etc. won't be accessible inside the module, even if they are <a href="global.html">global</a>. A module can be seen 
as a blackbox, an empty code sheet where item names can not conflict with the main code. It makes it easier 
to write specific code, as simple names can be reused within each module without risk of conflict. 
 
 
Items allowed in the DeclareModule section can be the following: procedure (only procedure declaration allowed), structure, macro, variable, 
constant, enumeration, array, list, map and label. 
 
 
To access a module item from outside the module, the module name has to be specified followed by the '::' separator. When explicitly specifying 
the module name, the module item is available everywhere in the code source, even in another module. 
All items in the DeclareModule section can be automatically imported into another module or in the main code using UseModule. 
In this case, if a module name conflict, the module items won't be imported and a compiler error will be raised. 
UnuseModule remove the module items. UseModule is not mandatory to access a module item, but the module name needs to be specified. 
 
 
To share information between modules, a common module can be created and then used in every modules which needs it. It's the common way 
have global data available for all modules. 
 
 
Default items available in modules are all SpiderBasic commands, structure and constants. Therefore module items can not be named like 
internal SpiderBasic commands, structure or constants. 
 
 
All code put inside DeclareModule and Module sections is executed like any other code when the program flow reaches the module. 
 
 
When the statements Define, EnableExplicit, EnableASM are used inside a module, they have no effect outside the respective module, and vice versa. 
 
 
Note: modules are not mandatory in SpiderBasic but are recommended when building big projects. They help to build more maintainable 
code, even if it is slightly more verbose than module-free code. Having a DeclareModule section make the module pretty much self-documented 
for use when reusing and sharing it.

</blockquote>Example<blockquote>

<pre> 
 ; Every items in this sections will be available from outside
 ;
 DeclareModule Ferrari
 #FerrariName$ = &quot;458 Italia&quot;
 
 Declare CreateFerrari()
 EndDeclareModule
 
 ; Every items in this sections will be private. Every names can be used without conflict
 ;
 Module Ferrari
 
 Global Initialized = #False
 
 Procedure Init() ; Private init procedure
 If Initialized = #False
 Initialized = #True
 Debug &quot;InitFerrari()&quot;
 EndIf
 EndProcedure 
 
 Procedure CreateFerrari()
 Init()
 Debug &quot;CreateFerrari()&quot;
 EndProcedure
 
 EndModule
 
 
 Procedure Init() ; Main init procedure, doesn't conflict with the Ferrari Init() procedure
 Debug &quot;Main init()&quot;
 EndProcedure
 
 Init()
 
 Ferrari::CreateFerrari()
 Debug Ferrari::#FerrariName$
 
 Debug &quot;------------------------------&quot;
 
 UseModule Ferrari ; Now import all public item directly in the main program scope
 
 CreateFerrari()
 Debug #FerrariName$

</pre>

</blockquote>Example: With a common module<blockquote>

<pre> 
 ; The common module, which will be used by others to share data
 ;
 DeclareModule Cars
 Global NbCars = 0
 EndDeclareModule
 
 Module Cars 
 EndModule
 
 ; First car module
 ;
 DeclareModule Ferrari
 EndDeclareModule
 
 Module Ferrari
 UseModule Cars
 
 NbCars+1
 EndModule
 
 ; Second car module
 ;
 DeclareModule Porche
 EndDeclareModule
 
 Module Porche
 UseModule Cars
 
 NbCars+1
 EndModule
 
 Debug Cars::NbCars

</pre>

</body></html>

一键复制编辑原始数据按行查看历史

麦壳饼提交于 2016年07月26日 10:47 +08:00 . chuci tijiao

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149

<html><head><title>Module</title></head>
<body bgcolor="#FFFFFF" link="#207BC3" vlink="#003B83" alink="#003B83">
<font face="Arial" size="2"><p align="center"><b><font size="5">Module</font></b></p>

<br><b>Syntax</b><blockquote><pre><font face="Courier New, Courier, mono"size="2"><b><font color="#207BC3">DeclareModule</font></b> &lt;name&gt;
 ...
<b><font color="#207BC3">EndDeclareModule</font></b>

<b><font color="#207BC3">Module</font></b> &lt;name&gt;
 ...
<b><font color="#207BC3">EndModule</font></b>

<b><font color="#207BC3">UseModule</font></b> &lt;name&gt;
<b><font color="#207BC3">UnuseModule</font></b> &lt;name&gt;
</font></pre></blockquote>
<b>Description</b><br><blockquote>


Modules are an easy way to isolate code part from the main code, allowing code reuse and sharing 
without risk of name conflict. In some other programming languages, modules are known as 'namespaces'. 
A module must have a <b><font color="#207BC3">DeclareModule</font></b> section (which is the public interface) and an associated 
<b><font color="#207BC3">Module</font></b> section (which is the implementation). 
Only items declared in the <b><font color="#207BC3">DeclareModule</font></b> section will be accessible from outside the module. All the 
code put in the <b><font color="#207BC3">Module</font></b> section will be kept private to this module. Items from main code 
like procedures, variables etc. won't be accessible inside the module, even if they are <a href="global.html">global</a>. A module can be seen 
as a blackbox, an empty code sheet where item names can not conflict with the main code. It makes it easier 
to write specific code, as simple names can be reused within each module without risk of conflict. 
<br>
<br>
Items allowed in the <b><font color="#207BC3">DeclareModule</font></b> section can be the following: procedure (only procedure declaration allowed), structure, macro, variable, 
constant, enumeration, array, list, map and label. 
<br>
<br>
To access a module item from outside the module, the module name has to be specified followed by the '::' separator. When explicitly specifying 
the module name, the module item is available everywhere in the code source, even in another module. 
All items in the <b><font color="#207BC3">DeclareModule</font></b> section can be automatically imported into another module or in the main code using <b><font color="#207BC3">UseModule</font></b>. 
In this case, if a module name conflict, the module items won't be imported and a compiler error will be raised. 
<b><font color="#207BC3">UnuseModule</font></b> remove the module items. <b><font color="#207BC3">UseModule</font></b> is not mandatory to access a module item, but the module name needs to be specified. 
<br>
<br>
To share information between modules, a common module can be created and then used in every modules which needs it. It's the common way 
have global data available for all modules. 
<br>
<br>
Default items available in modules are all SpiderBasic commands, structure and constants. Therefore module items can not be named like 
internal SpiderBasic commands, structure or constants. 
<br>
<br>
All code put inside <b><font color="#207BC3">DeclareModule</font></b> and <b><font color="#207BC3">Module</font></b> sections is executed like any other code when the program flow reaches the module. 
<br>
<br>
When the statements <b><font color="#207BC3">Define</font></b>, <b><font color="#207BC3">EnableExplicit</font></b>, <b><font color="#207BC3">EnableASM</font></b> are used inside a module, they have no effect outside the respective module, and vice versa. 
<br>
<br>
Note: modules are not mandatory in SpiderBasic but are recommended when building big projects. They help to build more maintainable 
code, even if it is slightly more verbose than module-free code. Having a <b><font color="#207BC3">DeclareModule</font></b> section make the module pretty much self-documented 
for use when reusing and sharing it. 

</blockquote><p><b>Example</b></p><blockquote>


<pre><font face="Courier New, Courier, mono"size="2"> 
 <font color="#207BC3">; Every items in this sections will be available from outside</font>
 <font color="#207BC3">;</font>
 <b><font color="#207BC3">DeclareModule</font></b> Ferrari
 <font color="#924B72">#FerrariName$</font> = &quot;458 Italia&quot;
 
 <b><font color="#207BC3">Declare</font></b> <font color="#207BC3">CreateFerrari</font>()
 <b><font color="#207BC3">EndDeclareModule</font></b>
 
 <font color="#207BC3">; Every items in this sections will be private. Every names can be used without conflict</font>
 <font color="#207BC3">;</font>
 <b><font color="#207BC3">Module</font></b> Ferrari
 
 <b><font color="#207BC3">Global</font></b> Initialized = <font color="#924B72">#False</font>
 
 <b><font color="#207BC3">Procedure</font></b> <font color="#207BC3">Init</font>() <font color="#207BC3">; Private init procedure</font>
 <b><font color="#207BC3">If</font></b> Initialized = <font color="#924B72">#False</font>
 Initialized = <font color="#924B72">#True</font>
 <b><font color="#207BC3">Debug</font></b> &quot;InitFerrari()&quot;
 <b><font color="#207BC3">EndIf</font></b>
 <b><font color="#207BC3">EndProcedure</font></b> 
 
 <b><font color="#207BC3">Procedure</font></b> <font color="#207BC3">CreateFerrari</font>()
<font color="#207BC3"> Init</font>()
 <b><font color="#207BC3">Debug</font></b> &quot;CreateFerrari()&quot;
 <b><font color="#207BC3">EndProcedure</font></b>
 
 <b><font color="#207BC3">EndModule</font></b>
 
 
 <b><font color="#207BC3">Procedure</font></b> <font color="#207BC3">Init</font>() <font color="#207BC3">; Main init procedure, doesn't conflict with the Ferrari Init() procedure</font>
 <b><font color="#207BC3">Debug</font></b> &quot;Main init()&quot;
 <b><font color="#207BC3">EndProcedure</font></b>
 
<font color="#207BC3"> Init</font>()
 
 Ferrari::<font color="#207BC3">CreateFerrari</font>()
 <b><font color="#207BC3">Debug</font></b> Ferrari::<font color="#924B72">#FerrariName$</font>
 
 <b><font color="#207BC3">Debug</font></b> &quot;------------------------------&quot;
 
 <b><font color="#207BC3">UseModule</font></b> Ferrari <font color="#207BC3">; Now import all public item directly in the main program scope</font>
 
<font color="#207BC3"> CreateFerrari</font>()
 <b><font color="#207BC3">Debug</font></b> <font color="#924B72">#FerrariName$</font>

</font></pre>

</blockquote><p><b>Example:</b> With a common module</p><blockquote>


<pre><font face="Courier New, Courier, mono"size="2"> 
 <font color="#207BC3">; The common module, which will be used by others to share data</font>
 <font color="#207BC3">;</font>
 <b><font color="#207BC3">DeclareModule</font></b> Cars
 <b><font color="#207BC3">Global</font></b> NbCars = 0
 <b><font color="#207BC3">EndDeclareModule</font></b>
 
 <b><font color="#207BC3">Module</font></b> Cars 
 <b><font color="#207BC3">EndModule</font></b>
 
 <font color="#207BC3">; First car module</font>
 <font color="#207BC3">;</font>
 <b><font color="#207BC3">DeclareModule</font></b> Ferrari
 <b><font color="#207BC3">EndDeclareModule</font></b>
 
 <b><font color="#207BC3">Module</font></b> Ferrari
 <b><font color="#207BC3">UseModule</font></b> Cars
 
 NbCars+1
 <b><font color="#207BC3">EndModule</font></b>
 
 <font color="#207BC3">; Second car module</font>
 <font color="#207BC3">;</font>
 <b><font color="#207BC3">DeclareModule</font></b> Porche
 <b><font color="#207BC3">EndDeclareModule</font></b>
 
 <b><font color="#207BC3">Module</font></b> Porche
 <b><font color="#207BC3">UseModule</font></b> Cars
 
 NbCars+1
 <b><font color="#207BC3">EndModule</font></b>
 
 <b><font color="#207BC3">Debug</font></b> Cars::NbCars

</font></pre>

</body></html>