Functie TOKENSUB

Deze functie wordt gebruikt om een opgemaakte waarde terug te geven die vooraf gedefinieerde onderdelen bevat.

Syntaxis

TOKENSUB("Formaat",Argumenten)

Waarbij `Format` de uitvoerinhoud definieert en waar nodig argumenten opgeeft.

Argumentspecificaties worden opgebouwd als %[argumentindex]specificatie. Het Argument Index-nummer roept het argument op uit de lijst die volgt op de opgemaakte tekenreeks. Als er geen argumentindexnummer is opgegeven, leest de functie de argumenten in volgorde. Zie voorbeeld 1 voor meer informatie hierover.

De specificatie bepaalt het type en de interpretatie van de waarde van het argument. De waarde van de specificatie kan een van de volgende zijn.

Door deze structuur toe te passen op de argumentspecificatie, zal %3d het derde item in de argumentenlijst opsporen en proberen de waarde weer te geven als een korte, op datum geformatteerde tekenreeks.

De lijst met argumenten volgt het formaat en de argumenten worden door komma’s gescheiden. Argumenten kunnen een celverwijzing zijn, een functie zoals SYSDATE(), of een gewone tekenreeks of waarde.

Voorbeeld 1

TOKENSUB("Dit is %s, gegenereerd op %d","voorbeeldtekst", SYSDATE())

Resultaten Dit is voorbeeldtekst die op 4 oktober 2008 is gegenereerd

Aangezien er geen indexnummers voor de argumenten zijn opgegeven, moeten de argumenten worden vermeld in de volgorde waarin ze in de tekenreeks moeten voorkomen.

Voorbeeld 2

TOKENSUB(C1, C2, C3) waarbij

• Cel C1 bevat de waarde "%s %d <%2D>"

• Cel C2 bevat de tekenreeks "De datum van vandaag is"

• Cel C3 bevat de Juliaanse datum "39487"

Resultaten De datum van vandaag is 10-04-2008 <10 april 2008>

De celverwijzingen worden vervangen, waardoor de uiteindelijke vergelijking als volgt luidt: TOKENSUB("%s %2d <%2D>", "De datum van vandaag is", 39487). De functie geeft het eerste argument weer als een tekenreeks, roept het tweede argument eerst op in het korte datumformaat en vervolgens in het lange datumformaat, waarbij de Juliaanse datumwaarde wordt omgezet in een leesbare datum.

• Niet-ondersteunde specificaties zullen in de uiteindelijke tekenreeks voorkomen.

  TOKENSUB("Dit is een %B","test") levert bijvoorbeeld de tekenreeks Dit is een B.op

• Achterliggende nullen worden in de uiteindelijke tekenreeks weggelaten.

  TOKENSUB("Ik heb %n dollar","65,00") levert bijvoorbeeld de tekenreeks Ik heb 65 dollarop.

• De functie TOKENSUB kan momenteel een lijst van 20 argumenten verwerken. Als de lijst langer is dan 20, worden het 21e en alle daaropvolgende argumenten genegeerd.

Gerelateerde onderwerpen

• Tekstfuncties