Num#() interpreteert een tekstreeks als een numerieke waarde, dat betekent dat de ingevoerde tekenreeks wordt omgezet naar een getal met behulp van de opmaak die in de tweede parameter is opgegeven. Als de tweede parameter is weggelaten, wordt de verzameling voor het scheidingsteken van tientallen en duizendtallen in het load-script voor gegevens gebruikt. Aangepaste symbolen voor decimaalteken en scheidingstal voor duizendtallen zijn optionele parameters.
Syntaxis:
Num#(text[, format[, dec_sep [, thou_sep ] ] ])
Retourgegevenstypen: dubbele waarde
De functie Num#() retourneert een dubbele waarde met zowel de tekenreeks als de numerieke waarde. De functie neemt de tekstuele representatie van de invoeruitdrukking en genereert een getal. De notatie van het getal wordt niet gewijzigd: de uitvoer wordt in dezelfde notatie weergegeven als de invoer.
Argumenten:
| Argument | Beschrijving |
|---|---|
| text |
De teksttekenreeks die moet worden geëvalueerd. |
| format |
Tekenreeks die specificeert welke getalopmaak wordt gebruikt in de eerste parameter. Bij weglating worden de scheidingstekens voor decimalen en duizendtallen gebruikt die zijn ingesteld in het load-script voor gegevens. |
| dec_sep |
Tekenreeks die het scheidingsteken voor decimalen opgeeft. Bij weglating wordt gebruikgemaakt van de waarde voor de variabele DecimalSep die is ingesteld in het load-script voor gegevens. |
| thou_sep |
Tekenreeks die het scheidingsteken voor duizendtallen opgeeft. Bij weglating wordt gebruikgemaakt van de waarde voor de variabele ThousandSep die is ingesteld in het load-script voor gegevens. |
Voorbeeld:
De volgende tabel toont het resultaat van Num#( A, '#', '.' , ',') voor verschillende waarden van A.
| A | Representatie van tekenreeks | Numerieke waarde (hier weergegeven met decimale punt) |
|---|---|---|
| 35,648.31 | 35,648.31 | 35648.31 |
| 35 648.312 | 35 648.312 | 35648.312 |
| 35.648,3123 | 35.648,3123 | - |
| 35 648,31234 | 35 648,31234 | - |
