Difference between revisions of "NL/Documentation/BASIC Guide/Conversion Functions (Runtime Library)"

Revision as of 16:47, 19 January 2013

Programmeursgids voor BASIC

{{{parttitle}}}

[[{{{PrevPart}}}|< Vorige deel ]]

[[{{{NextPart}}}|Volgende deel >]]

• De taal van Apache OpenOffice Basic

• Overzicht van een programma in BASIC
• Werken met variabelen
• Tekenreeksen
• Getallen
• Booleaanse waarden
• Datum en tijd
• Arrays
• Bereik en levensduur van variabelen
• Constanten
• Operatoren
• Aftakken
• Loops
• Procedures en functies
• Foutafhandeling
• Andere instructies

• Runtime-bibliotheek

• Functies voor conversie
• Strings (Tekenreeksen)
• Datum en tijd
• Bestanden en mappen
• Bericht- en invoervakken
• Andere functies

• Introductie voor de API

• Universal Network Objects (UNO)
• Eigenschappen en methoden
• Modules, services en interfaces
• Gereedschap voor werken met UNO
• Overzicht van centrale interfaces

• Werken met documenten

• De StarDesktop
• Opmaakprofielen en sjablonen

• Tekstdocumenten

• De structuur van tekstdocumenten
• Tekstdocumenten bewerken
• Meer dan alleen tekst

• Werkbladdocumenten

• De structuur van werkbladdocumenten
  • Rijen en kolommen
  • Cellen en bereiken
  • Werkbladdocumenten opmaken
• Werkbladdoucmenten bewerken

• Tekeningen en presentaties

• De structuur van tekeningen
• Tekenobjecten bewerken
• Presentaties

• Grafieken (Diagrammen)

• Diagrammen gebruiken in werkbladen
• De structuur van diagrammen
• Typen diagram

• Databases

• SQL: een Query-taal
• Typen toegang tot database
• Gegevensbronnen
• Toegang tot database

• Dialoogvensters

• Werken met dialoogvensters
• Eigenschappen
• Gebeurtenissen
• Elementen voor beheer dialoogvenster

• Formulieren

• Werken met formulieren
• Besturingselementen Formulieren
• Database-formulieren

< Vorige pagina

Volgende pagina >

In veel situaties ontstaan omstandigheden waaronder een variabele van het ene type moet worden gewijzigd naar een variabele van een ander type.

Impliciete en expliciete conversies van typen

De eenvoudigste manier om een variabele te wijzigen van het ene type naar een ander is om een toewijzing te gebruiken.

Dim A As String
Dim B As Integer
 
B = 101 
A = B

In dit voorbeeld is variabele A een string (tekenreeks) en variabele B is een integer (geheel getal). Apache OpenOffice BASIC zorgt er voor dat variabele B naar een string wordt geconverteerd gedurende de toewijzing aan variabele A. Deze conversie is veel omvattender dan het lijkt: de integer B blijft in het werkgeheugen in de vorm van een twee-byte lang getal. Aan de andere kant is A een string en de computer bewaart een één- of twee-byte lange waarde voor elk teken (elk getal). Daarom moet, vóórdat de inhoud van B naar A wordt gekopieerd, B worden geconverteerd naar de interne indeling van A.

Anders dan in de meeste programmeertalen voert BASIC conversies van typen automatisch uit. Dit kan echter fatale consequenties hebben. Bij nadere beschouwing, blijkt de volgende reeks code

Dim A As String
Dim B As Integer
Dim C As Integer
 
B = 1 
C = 1
A = B + C

die op het eerste gezicht recht toe recht aan lijkt te zijn, uiteindelijk een soort valstrik te zijn. De interpreter van BASIC berekent eerst het resultaat van het proces om op te tellen en converteert dat dan naar een string, die, als het resultaat ervan, de string 2 produceert.

Als, aan de andere kant, de interpreter van BASIC eerst de beginwaarden B en C naar een string converteert en de operator plus toepast op het resultaat, produceert het de string 11.

Hetzelfde is van toepassing bij het gebruiken van variabelen van het type Variant:

Dim A 
Dim B 
Dim C 
 
B = 1 
C = "1"
A = B + C

Omdat variabelen van het type variant zowel getallen als tekenreeksen mogen bevatten, is het niet helder of de variabele A wordt toegewezen aan het getal 2 of de tekenreeks 11.

De opgemerkte bronnen voor fouten voor impliciete conversies voor typen kunnen alleen worden vermeden door zorgvuldig te programmeren; bijvoorbeeld door niet het gegevenstype Variant te gebruiken.

Apache OpenOffice BASIC biedt een scala aan functies voor conversie, die u kunt gebruiken om te definiëren wanneer het gegevenstype van een bewerking zou moeten worden geconverteerd, om andere fouten, die het resultaat zijn van impliciete conversies van typen, te vermijden:

CStr(Var)

converteert alle gegevenstypen naar een string (tekenreeks).

CInt(Var)

converteert alle gegevenstypen naar een waarde Integer (geheel getal).

CLng(Var)

converteert alle gegevenstypen naar een waarde Long.

CSng(Var)

converteert alle gegevenstypen naar een waarde Single.

CDbl(Var)

converteert alle gegevenstypen naar een waarde Double.

CBool(Var)

converteert alle gegevenstypen naar een waarde Boolean.

CDate(Var)

converteert alle gegevenstypen naar een waarde Date.

U kunt deze functies voor conversie gebruiken om te definiëren hoe Apache OpenOffice BASIC dit type bewerkingen voor conversie zou moeten uitvoeren:

Dim A As String
Dim B As Integer
Dim C As Integer
 
B = 1 
C = 1
A = CStr(B + C)         ' B en C worden eerst bij elkaar opgeteld en dan
                        ' geconverteerd naar de string "2"
A = CStr(B) + CStr(C)   ' B en C worden geconverteerd naar een String, en dan
                        ' gecombineerd om de string "11" te produceren

Gedurende de eerste optelling in het voorbeeld telt Apache OpenOffice BASIC eerst de integer-variabelen bij elkaar op en converteert dan het resultaat naar een reeks tekens. A wordt toegewezen aan de string 2. In tweede instantie worden de integer-variabelen eerst geconverteerd naar twee strings en dan aan elkaar gekoppeld door middel van de toewijzing. Aan A wordt daarom de string 11 toegewezen.

De numerieke functies voor conversie CSng en CDbl accepteren ook decimale getallen. Het symbool dat is gedefinieerd in de corresponderende land-specifieke instellingen moet wordne gebruikt als het teken voor de decimale punt. In tegenstelling daaraan gebruikt de methode CStr de huidige geselecteerde land-specifieke instellingen bij het opmaken van getallen en details voor datums en tijden.

De functie Val verschilt van de methoden Csng, Cdbl en Cstr. Het converteert een string naar een getal; het verwacht echter altijd dat een punt wordt gebruikt als symbool voor de decimale punt.

Dim A As String
Dim B As Double
 
A = "2.22"
B = Val(A)      ' Wordt correct geconverteerd, ongeacht de
                ' land-specifieke instellingen

Controleren van de inhoud van variabelen

In sommige gevallen kan de datum niet worden geconverteerd:

Dim A As String
Dim B As Date
 
A = "test"
B = A            ' Veroorzaakt een foutbericht

In het weergegeven voorbeeld is de toewijzing van de string test als een variabele Date niet zinvol, dus rapporteert de interpreter van BASIC een fout. Hetzelfde is van toepassing als wordt geprobeerd een tekenreeks toe te wijzen aan een variabele Boolean:

Dim A As String
Dim B As Boolean
 
A = "test"
B = A            ' Veroorzaakt een foutbericht

Opnieuw rapporteert de interpreter van BASIC een fout.

Deze foutberichten kunnen worden vermeden door het programma te controleren vóór een toewijzing, om vast te stellen of de inhoud van de variabele die moet worden toegewezen overeenkomt met het type variabele dat het doel is. Apache OpenOffice BASIC biedt de volgende functies om voor dit doel te testen:

IsNumeric(Waarde)

controleert of een waarde een getal is.

IsDate(Waarde)

controleert of een waarde een datum is.

IsArray(Waarde)

controleert of een waarde een array is.

Deze functies zijn in het bijzonder handig bij het navragen van invoer van de gebruiker. Bijvoorbeeld: u kunt controleren of een gebruiker een geldig getal of datum heeft ingevoerd.

If IsNumeric(InvoerGebruiker) Then
  GeldigeInvoer = InvoerGebruiker
Else
  GeldigeInvoer = 0
  MsgBox "Foutbericht."
End If

In het voorgaande voorbeeld wordt, als de variabele InvoerGebruiker een geldige numerieke waarde bevat, deze toegewezen aan de variabele GeldigeInvoer. Als InvoerGebruiker geen geldig getal bevat wordt aan GeldigeInvoer de waarde 0 toegewezen en wordt een foutbericht weergegeven.

Waar functies voor het testen voor het controleren van getallen, details voor datums en arrays in Apache OpenOffice BASIC wel bestaan, bestaat er geen overeenkomstige functie voor het controleren van Booleaanse waarden. De functionaliteit kan echter worden geïmiteerd door de functie IsBoolean te gebruiken:

Function IsBoolean(Waarde As Variant) As Boolean
  On Error Goto ErrorIsBoolean:
  Dim Dummy As Boolean
  Dummy = Waarde
  IsBoolean = True
  On Error Goto 0
  Exit Sub
 
  ErrorIsBoolean:
  IsBoolean = False
  On Error Goto 0
End Function

De functie IsBoolean definieert een interne hulpvariabele Dummy van het type Boolean en probeert die toe te wijzen aan de getransfereerde waarde. Als de toewijzing succesvol verloopt geeft de functie True terug. Als hij faalt wordt een runtime-fout geproduceerd, de foutafhandeling onderschept de fout en de functie geeft False terug.

VBA : Als een string in Apache OpenOffice BASIC een niet-numerieke waarde bevat en indien die wordt toegewezen aan een getal, produceert Apache OpenOffice BASIC geen foutbericht, maar stopt met het converteren van de string bij het eerste ongeldige teken. Deze procedure verschilt van VBA. Daar wordt een fout geactiveerd en wordt de implementatie van het programma beëindigd als een overeenkomstige toewijzing wordt uitgevoerd.