Module

DeclareModule <Name>
  ...
EndDeclareModule

Module <Name>
  ...
EndModule

UseModule <Name>
UnuseModule <name>

Module sind eine einfache Möglichkeit, um Teile des Programmcodes vom Haupt-Code zu isolieren, was die Wiederverwendung und den Austausch von Code ohne das Risiko von Namens-Konflikten erlaubt. In einigen anderen Programmiersprachen sind die Module auch als 'Namespaces' ("Namensräume") bekannt.

Ein Modul (englisch "module") muss einen DeclareModule Abschnitt (das ist die öffentliche Schnittstelle) und einen zugehörigen Module Abschnitt (das ist die Implementierung) besitzen.

Nur auf die im DeclareModule Abschnitt deklarierten Elemente kann von außerhalb des Moduls zugegriffen werden. Der gesamte Code im Module Abschnitt wird "privat" für dieses Modul gehalten. Auf Elemente aus dem Hauptcode wie Prozeduren, Variablen, etc. kann innerhalb des Moduls nicht zugegriffen werden, auch wenn sie als global deklariert wurden. Ein Modul kann als eine "Blackbox", eine leere Code-Seite, angesehen werden, wobei die Namen der Elemente nicht in Konflikt mit dem Haupt-Code kommen können. Dies macht es leichter, spezifischen Code zu schreiben, da einfache Namen in jedem Modul - ohne das Risiko eines Namenskonflikts - wiederverwendet werden können.

Die in einem DeclareModule Abschnitt erlaubten Elemente können folgende sein: Prozeduren (nur die Prozedur-Deklaration ist erlaubt), Strukturen, Makros, Variablen, Konstanten, Enumeration, Array, Listen, Map und Sprungmarken (Labels) sein.

Um auf ein Modul-Element von außerhalb des Moduls zuzugreifen, muss der Modul-Name gefolgt vom '::' Trennzeichen angegeben werden. Wenn der Modul-Name explizit angegeben wird, dann ist das Modul-Element überall im Quellcode verfügbar, auch in einem anderen Modul. Alle Elemente in einem DeclareModule Abschnitt können mit Hilfe von UseModule automatisch in ein anderes Modul oder in den Hauptcode importiert werden. Wenn in diesem Fall ein Namenskonflikt im Modul auftritt, werden die Modul-Elemente nicht importiert und ein Compiler-Fehler ausgelöst. UnuseModule entfernt die Modul-Elemente. UseModule ist nicht zwingend erforderlich, um auf ein Modul-Element zuzugreifen, aber der Modul-Name muss angegeben werden.

Um Informationen zwischen den Modulen gemeinsam zu nutzen, kann ein gemeinsames Modul ("common module") erstellt und dann in allen Modulen (die es benötigen) verwendet werden. Dies ist der gebräuchlichste Weg, um globale Daten für alle Module zu haben.

Die in den Modulen verfügbaren Standard-Elemente sind alle PureBasic Befehle, Strukturen und Konstanten. Daher können Modul-Elemente nicht wie interne PureBasic Befehle, Strukturen oder Konstanten benannt werden.

Der gesamte in DeclareModule bzw. Module Abschnitte gesetzte Code wird wie jeder andere Code ausgeführt, wenn der Programmablauf das Modul erreicht.

Wenn die Anweisungen Define, EnableExplicit, EnableASM in einem Modul verwendet werden, haben sie keine Wirkung außerhalb des jeweiligen Moduls, und umgekehrt.

Hinweis: Module sind in PureBasic nicht obligatorisch, sind aber beim Erstellen großer Projekte zu empfehlen. Sie helfen dabei, einen besser/leichter zu verwaltenden Code zu erstellen, auch wenn dieser etwas ausführlicher als Modul-freier Code ausfällt. Die Verwendung eines DeclareModule Abschnitts macht das Modul ziemlich selbsterklärend dokumentiert, für einfache Wiederverwendung und dessen Austausch.

Beispiel

  
  ; Alle Elemente in diesem Abschnitt sind für den Zugriff von außerhalb verfügbar
  ;
  DeclareModule Ferrari
    #FerrariName$ = "458 Italia"
    
    Declare CreateFerrari()
  EndDeclareModule
  
  ; Alle Elemente in diesem Abschnitt sind privat. Alle Namen können ohne
  ; Namenskonflikt auch woanders verwendet werden.
  ;
  Module Ferrari
    
    Global Initialized = #False
    
    Procedure Init() ; Private Initialisierungs-Prozedur
      If Initialized = #False
        Initialized = #True
        Debug "InitFerrari()"
      EndIf
    EndProcedure  
      
    Procedure CreateFerrari()
      Init()
      Debug "CreateFerrari()"
    EndProcedure
    
  EndModule
  
  
  Procedure Init() ; Initialisierungs-Prozedur des Hauptcodes, kommt nicht in Konflikt mit der Ferrari Init() Prozedur
    Debug "Main init()"
  EndProcedure
  
  Init()
  
  Ferrari::CreateFerrari()
  Debug Ferrari::#FerrariName$
  
  Debug "------------------------------"
  
  UseModule Ferrari ; Jetzt alle öffentlichen (public) Elemente in den Geltungsbereich des Hauptprogramms importieren
  
  CreateFerrari()
  Debug #FerrariName$

Beispiel: mit einem gemeinsamen Modul

  
  ; Das gemeinsame ("Common") Modul, was von den anderen zum Austausch von Daten verwendet wird
  ;
  DeclareModule Cars
    Global NbCars = 0
  EndDeclareModule
  
  Module Cars 
  EndModule
  
  ; Erstes Auto-Modul
  ;
  DeclareModule Ferrari
  EndDeclareModule
  
  Module Ferrari
    UseModule Cars
    
    NbCars+1
  EndModule
  
  ; Zweites Auto-Modul
  ;
  DeclareModule Porsche
  EndDeclareModule
  
  Module Porsche
    UseModule Cars
    
    NbCars+1
  EndModule
  
  Debug Cars::NbCars