$firstwords

Gebruik: $firstwords(tekst,lengte)

Categorie: tekst

Geïmplementeerd: Picard 0.12

Beschrijving:

Kort tekst af tot lengte en retourneert alleen volledige woorden uit tekst (de functie kapt dus geen woorden af). Als lengte kleiner is dan 0, wordt de waarde gebruikt die overeenkomt met het aantal tekens in tekst plus lengte (bijv. $firstwords(een twee drie,-3) is hetzelfde als $firstwords(een twee drie,10)). Als lengte ontbreekt of een getal is dat groter is dan het aantal tekens in tekst, retourneert de functie een lege tekenreeks.

Voorbeeld:

De volgende instructies retourneren de aangegeven waarden:

$firstwords(Once upon a time,)     ==>  ""
$firstwords(Once upon a time,0)    ==>  ""
$firstwords(Once upon a time,3)    ==>  ""
$firstwords(Once upon a time,7)    ==>  "Once"
$firstwords(Once upon a time,-3)   ==>  "Once upon a"
$firstwords(Once upon a time,-30)  ==>  ""