Een overzicht van een programma in Apache OpenOffice BASIC

From Apache OpenOffice Wiki
Jump to: navigation, search
Book.png

Apache OpenOffice BASIC is een interpreter-taal. Anders dan C++ of Delphi, maakt de Apache OpenOffice BASIC-compiler geen uitvoerbare of zichzelf uitpakkende bestanden die in staat zijn om automatisch te worden uitgevoerd. In plaats daarvan voert u een programma in Apache OpenOffice BASIC uit binnen Apache OpenOffice. De code wordt eerst gecontroleerd op duidelijke fouten en dan regel voor regel uitgevoerd.

Programmaregels

De BASIC-interpreter's regel-georiënteerde uitvoering produceert één van de belangrijkste verschillen tussen BASIC en andere programmeertalen. Waar de positie van harde regeleinden in de broncode van programma's in Java, C++ of Delphi niet relevant is, vormt elke regel in een programma van BASIC zichzelf bevattende eenheid. Functie-aanroepen, rekenkundige uitdrukkingen en andere taalkundige elementen, zoals koppen voor functies en loops, moeten op dezelfde regel worden voltooid als die waarop zij beginnen.

Indien er niet voldoende ruimte is of indien dit resulteert in lange regels, dan kunnen verschillende regels worden gekoppeld door underscores _ toe te voegen. Het volgende voorbeeld geeft weer hoe vier regels van een rekenkundige bewerking kunnen worden gekoppeld:

LongExpression = (Expression1 * Expression2) + _
(Expression3 * Expression4) + _ 
(Expression5 * Expression6) + _
(Expression7 * Expression8)
Documentation note.png De underscore moet altijd het laatste teken in een gekoppelde regel zijn en mag niet worden gevolgd door een spatie of een tab of een opmerking, anders genereert de code een fout.

In aanvulling op het koppelen van individuele regels kunt u in Apache OpenOffice BASIC dubbele punten gebruiken om een regel in verschillende gedeelten op te delen, zodat er voldoende ruimte is voor verscheidene uitdrukkingen. De toewijzingen

a = 1 
a = a + 1 
a = a + 1 

kunnen als volgt worden geschreven:

a = 1  :  a = a + 1  :  a = a + 1

Opmerkingen

In aanvulling op de programmacode die moet worden uitgevoerd, kan een Apache OpenOffice BASIC-programma ook opmerkingen bevatten die de individuele delen van het programma uitleggen en belangrijke informatie verschaffen die in een later stadium behulpzaam kan zijn.

Apache OpenOffice BASIC verschaft twee methoden voor het invoegen van opmerkingen in de programmacode:

  • Alle tekens die volgen op een apostrof worden behandeld als opmerkingen:
    Dim A    ' Dit is een opmerking voor variabele A
  • Het sleutelwoord Rem, gevolgd door de opmerking:
    Rem Deze opmerking wordt voorafgegaan door het sleutelwoord Rem.

Een opmerking omvat normaal gesproken alle tekens tot aan het einde van de regel. Apache OpenOffice BASIC interpreteert dan de volgende regel weer opnieuw als een reguliere instructie. Indien opmerkingen meerdere regels omvatten moet elke regel worden geïdentificeerd als een opmerking:

Dim B     ' Deze opmerking voor variabele B is relatief lang
          ' en strekt zich uit over meerdere regels. Het
          ' teken voor een opmerking moet daarom worden herhaald 
          ' in elke regel.

Aanduidingen

Een programma in Apache OpenOffice BASIC kan dozijnen, honderden of zelfs duizenden aanduidingen bevatten, wat namen zijn voor variabelen, constanten, functies, enzovoort. Als u een naam selecteert voor een aanduiding zijn de volgende regels van toepassing:

  • Aanduidingen mogen alleen Latijnse letters, getallen en underscores (_) bevatten.
  • Het eerste teken van een aanduiding moet een letter of een underscore zijn.
  • Aanduidingen mogen geen speciale tekens bevatten, zoals ä â î ß.
  • De maximale lengte van een aanduiding is 255 tekens.
  • Er wordt geen onderscheid gemaakt tussen hoofd- en kleine letters. De aanduiding EenTestVariabele, bijvoorbeeld, definieert dezelfde variabele als eentestVariabele en EENTESTVARIABELE.
    Er is echter één uitzondering op deze regel: onderscheid tussen hoofd- en kleine letters wordt gemaakt voor constanten van de UNO-API. Meer informatie over UNO wordt gepresenteerd in Introductie voor de API van Apache OpenOffice.


Documentation caution.png De namen van de modules in BASIC (standaard Module1, Module2, etc) zijn bij BASIC bekend onder een public bereik. U moet vermijden om een aanduiding te hebben in het bereik public met dezelfde naam als één van de modules van de bibliotheek.

Voorbeeld : Veronderstel dat u in uw bibliotheek van BASIC een module hebt die is genaamd PrintDoc. U moet dus niet, in enige module van uw bibliotheek, een Public-variabele of een Public-constante, of een Sub, of een Function declareren die PrintDoc wordt genoemd.

Indien u een dergelijke botsing heeft kan BASIC vreemde foutberichten in runtime produceren, of uw Sub zou misschien niet werken.

Documentation note.png VBA : De regels voor de constructie van aanduidingen zijn anders in Apache OpenOffice BASIC dan in VBA. Bijvoorbeeld; Apache OpenOffice BASIC staat alleen speciale tekens toe in aanduidingen bij het gebruik van Option Compatible, omdat zij problemen kunnen veroorzaken in internationale projecten.


Hier zijn een aantal voorbeelden van juiste en onjuiste aanduidingen:

Surname      ' Juist 
Surname5     ' Juist   (getal 5 is niet het eerste cijfer)
First Name   ' Onjuist (spaties zijn niet toegestaan)
DéjàVu       ' Onjuist (letters zoals é, à zijn niet toegestaan)
5Surnames    ' Onjuist (het eerst teken mag geen cijfer zijn)
First,Name   ' Onjuist (komma's en punten zijn niet toegestaan)

Omsluiten van de naam van een variabele door vierkante haken staat namen toe die anders niet zouden zijn toegestaan; bijvoorbeeld: spaties.

  Dim [First Name] As String  'Spatie geaccepteerd tussen vierkante haken
  Dim [DéjàVu] As Integer     'Speciale tekens tussen vierkante haken
  [First Name] = "Andrew"
  [DéjàVu] = 2


Content on this page is licensed under the Public Documentation License (PDL).
Personal tools