Functie CInt

Converteert een tekenreeks of numerieke expressie naar een Integer.

Syntaxis:


CInt (Expression As Variant) As Integer

Geretourneerde waarde:

Integer

Parameters:

Expression: Elke tekenreeks of numerieke expressie die u wilt converteren. Om een tekenreeksexpressie te converteren, moet het getal worden ingevoerd als normale tekst met behulp van de standaard getalopmaak van uw LibreOffice taalinstellingen. Het getal moet bijvoorbeeld worden ingevoerd met een punt "." als decimaalteken en een komma "," als scheidingsteken voor duizendtallen (bijvoorbeeld 123.456,78) voor de Engelse taalinstelling.

Als het argument tekenreeks is, trimt de functie de leidende witruimte; dan probeert het een nummer te herkennen in de volgende tekens. De onderstaande syntaxis wordt herkend:

Decimale getallen (met optioneel voorteken) met decimale en groepsscheidingstekens van de landinstelling geconfigureerd in LibreOffice (groepsscheidingstekens worden in elke positie geaccepteerd), met optionele exponentiële notatie zoals "-12e+1" (waar een optioneel ondertekend geheel decimaal getal na e of E of d of D definieert de macht van 10);
Octale getallen zoals "&Onnn...", waarbij "nnn..." na "&O" of "&o" niet langer is dan 11 cijfers, van 0 tot 7, tot het volgende niet-alfanumerieke teken;
Hexadecimale getallen zoals "&Hnnn...", waarbij "nnn..." na "&H" of "&h" een reeks tekens is tot aan het volgende niet-alfanumerieke teken, en mag niet langer zijn dan 8 cijfers, van 0 tot 9, A tot F of a tot f.

De rest van de tekenreeks wordt genegeerd. Als de tekenreeks niet wordt herkend, b.v. als het na het bijsnijden van de voorloopspatie niet begint met plus, min, een decimaal cijfer of "&", of als de reeks na "&O" langer is dan 11 tekens of een alfabetisch teken bevat, is de numerieke waarde van uitdrukking 0 .

Als het argument een fout is, wordt het foutnummer gebruikt als numerieke waarde van de uitdrukking.

Als het argument een datum is, wordt het aantal dagen sinds 1899-12-30 (seriële datum) gebruikt als numerieke waarde van de uitdrukking. Tijd wordt weergegeven als een fractie van een dag.

Nadat de numerieke waarde van de uitdrukking is berekend, wordt deze afgerond op het dichtstbijzijnde gehele getal (indien nodig), en als het resultaat niet tussen -32768 en 32767 ligt, rapporteert LibreOffice Basic een overloopfout. Anders wordt het resultaat geretourneerd.

Foutcodes:

5 Ongeldige aanroep van procedure

Voorbeeld:

Numerieke expressies worden weergegeven volgens LibreOffice taalinstellingen:


Sub ExampleCountryConvert
    MsgBox CDbl(1234,5678) ' 1234,5678
    MsgBox CInt(1234.5678) ' 1235
    MsgBox CLng(1234+5678) ' 6912
    MsgBox CSng(1234,5678) ' 1234,567749023

    MsgBox CDbl(expression := 5678,1234) ' 5678,1234
    MsgBox CInt(expression := 5678.1234) ' 5678
    MsgBox CLng(expression := 5678+1234) ' 6912
    MsgBox CSng(expression := 5678,1234) ' 5678,123535156
End Sub