Vorige Volgende

Klasse BirtStr

De klasse BirtStr biedt functies voor het bewerken van tekenreeksen, zoals het samenvoegen van tekenreeksen, het verwijderen van extra spaties, het ophalen van delen van een tekenreeks en het weergeven van tekenenreeksen in hoofdletters en kleine letters. Dit is een statische klasse. De toepassing kan geen instances van de klasse maken.

BirtStr.charLength

Deze functie berekent de lengte van een bepaalde tekenreeks.

Syntaxis

BirtStr.charLength( bron )

Parameter

bron

Tekenreeks. De tekenreeks waarvan de lengte moet worden vastgesteld.

Resultaat

Geheel getal. Het aantal tekens in de opgegeven tekenreeks.

Voorbeelden

In het volgende voorbeeld wordt lengte van een bepaalde tekenreeks berekend:

BirtStr.charLength( "Pietje Puk" ) // retourneert 10

In het volgende voorbeeld is het resultaat de lengte van elke waarde in het veld CustomerName:

BirtStr.charLength( row["CustomerName"] )

BirtStr.concat

Het resultaat van deze functie is een tekenreeks die ontstaat uit het samenvoegen van opgegeven tekenreeksen.

Syntaxis

BirtStr.concat( bron1, ..., bronN )

Parameter

bron1, ..., bronN

Tekenreeks. De tekenreeksen die aaneengeschakeld moeten worden.

Resultaat

Tekenreeks. De tekenreeks die het resultaat is van het aaneenschakelen van een aantal tekenreeksen.

Voorbeeld

In het volgende voorbeeld wordt een volledig adres samengesteld door waarden uit meerdere velden aaneen te schakelen:

BirtStr.concat( row["Adresregel1"], ", ", row["Adresregel2"], ", ", row["Stad"], " ", row["Postcode"], "row["Provincie"], ", ", row["Land"] )

BirtStr.indexOf

Deze functie berekent de positie van een opgegeven subreeks in een bepaalde tekenreeks.

Syntaxis

BirtStr.indexOf( doel, bron, start )

Parameters

doel

Tekenreeks. De subreeks waarnaar moet worden gezocht. De zoekactie is hoofdlettergevoelig.

bron

Tekenreeks. De tekenreeks waarin naar de subreeks wordt gezocht.

start

Geheel getal. Optioneel. De positie in de bronreeks waar de zoekactie begint. Als u dit argument weglaat, begint de zoekactie bij het eerste teken van de tekenreeks.

Resultaat

Geheel getal. De numerieke positie van de subreeks in de tekenreeks. Het eerste teken in een tekenreeks staat op positie 0. Als de subreeks niet wordt gevonden, geeft de functie de waarde -1 als resultaat.

Voorbeelden

Het resultaat in het volgende voorbeeld is de positie van de opgegeven tekens in specifieke tekenreeksen:

BirtStr.indexOf( " ", "Julie Murphy" ) // retourneert 5
BirtStr.indexOf( "-", "ModelA-1234-567" ) // retourneert 6
BirtStr.indexOf( "-", "ModelA-1234-567", 7 ) // retourneert 11

In het volgende voorbeeld wordt BirtStr.indexOf( ) in combinatie met BirtStr.left( ) gebruikt voor weergave van de tekens die voorafgaan aan de spatie in de klantnaam. De functie BirtStr.left( ) haalt een subreeks met een opgegeven lengte op die begint bij het eerste teken. In het voorbeeld is de lengte van de weergegeven subreeks gelijk aan de numerieke positie van de spatie.

spaceCharPosition = BirtStr.indexOf( " ", row["customerName"] );
displayFirstName = BirtStr.left( row["customerName"], spaceCharPosition );

Als de naam van de klant Julie Murphy is, is het resultaat van de expressie Julie.

BirtStr.left

Deze functie haalt een subreeks met een opgegeven lengte op uit een tekenreeks. Het beginpunt is het meest linkse of eerste teken.

Syntaxis

BirtStr.left( bron, n )

Parameters

bron

Tekenreeks. De tekenreeks waaruit een subreeks moet worden opgehaald.

n

Geheel getal. Het aantal tekens dat opgehaald moet worden, te beginnen bij het eerste teken.

Resultaat

Tekenreeks. Een subreeks met een specifieke lengte.

*
*
*

Voorbeelden

In het volgende voorbeeld worden subreeksen van verschillende lengte opgehaald in specifieke tekenreeksen:

BirtStr.left( "Pietje Puk", 5 ) // retourneert Pietj
BirtStr.left( "Pietje Puk", 10 ) // retourneert Pietje Puk

In het volgende voorbeeld wordt BirtStr.indexOf( ) in combinatie met BirtStr.left( ) gebruikt voor weergave van de tekens die voorafgaan aan de spatie in de klantnaam. De functie BirtStr.left( ) haalt een subreeks met een opgegeven lengte op die begint bij het eerste teken. In het voorbeeld is de lengte van de weergegeven subreeks gelijk aan de numerieke positie van de spatie.

spaceCharPosition = BirtStr.indexOf( " ", row["customerName"] );
displayFirstName = BirtStr.left( row["customerName"], spaceCharPosition );

Als de naam van de klant Julie Murphy is, is het resultaat van de expressie Julie.

BirtStr.right

Deze functie haalt een subreeks met een opgegeven lengte op uit een tekenreeks. Het beginpunt is het meest rechtse of laatste teken.

Syntaxis

BirtStr.right( bron, n )

Parameters

bron

Tekenreeks. De tekenreeks waaruit een subreeks moet worden opgehaald.

n

Geheel getal. Het aantal tekens dat opgehaald moet worden, te beginnen bij het laatste teken.

Resultaat

Tekenreeks. Een subreeks met een specifieke lengte.

*
*
*

Voorbeelden

In het volgende voorbeeld worden subreeksen van verschillende lengte opgehaald in specifieke tekenreeksen:

BirtStr.right( "Pietje Puk", 3 ) // retourneert Puk
BirtStr.right( "Pietje Puk", 10 ) // retourneert Pietje Puk

In het volgende voorbeeld wordt BirtStr.right( ) in combinatie met BirtStr.indexOf( ) en BirtStr.charLength( ) gebruikt voor weergave van de tekens die na de spatie in de klantnaam komen. Het voorbeeld gaat ervan uit dat het aantal tekens na het streepje variabel is. De lengte van de gehele tekenreeks (opgehaald met BirtStr.charLength( )) min de lengte van de reeks tot het streepje (opgehaald met BirtStr.indexOf( )) is dus het aantal tekens dat moet worden weergegeven.

spaceCharPosition = BirtStr.indexOf( " ", row["customerName"] );
displayLastName = BirtStr.right( row["customerName"], (BirtStr.charLength( row["customerName"] - (spaceCharPosition + 1)) )

Als de naam van de klant Pietje Puk is, is het resultaat van de expressie Puk. Als de naam van de klant Machiel Vanvilvoorden is, is het resultaat van de expressie Vanvilvoorden.

BirtStr.search

Deze functie berekent de positie van een opgegeven subreeks in een bepaalde tekenreeks. De subreeks mag jokertekens bevatten.

Syntaxis

BirtStr.search( patroon, bron, index )

Parameters

patroon

Tekenreeks. Het patroon waarnaar moet worden gezocht. De zoekactie is niet hoofdlettergevoelig. In het patroon kunt u de volgende jokertekens gebruiken:

*
Een sterretje ( * ) correspondeert met nul of meer tekens, incusief spaties. Het patroon t*n komt bijvoorbeeld overeen met tn, tin, ton en teen.
*

Om overeenkomsten te vinden met een literaal sterretje of vraagteken in een reeks, zorgt u dat deze tekens voorafgegaan worden door twee schuine strepen naar links (\\). Als u bijvoorbeeld de subreeks R*10 zoekt, ziet het zoekpatroon er als volgt uit:

"R\\*10"

bron

Tekenreeks. De tekenreeks waarin naar de subreeks wordt gezocht.

index

Geheel getal. Optioneel. De positie in de bronreeks waar de zoekactie begint. Als u dit argument weglaat, begint de zoekactie bij het eerste teken van de tekenreeks.

Resultaat

Geheel getal. De numerieke positie van de subreeks in de tekenreeks. Het eerste teken in een tekenreeks staat op positie 0. Als de subreeks niet wordt gevonden, geeft de functie de waarde -1 als resultaat.

Voorbeelden

Het resultaat in het volgende voorbeeld is de positie van de opgegeven reekspatronen in specifieke tekenreeksen:

BirtStr.search( "XM?", "XMS-ModelA-1234-567" ) // returns 0
BirtStr.search( "ModelA*", "XMS-ModelA-1234-567" ) // returns 4
BirtStr.search( "-", "XMS-ModelA-1234-567", 4 ) // returns 10

In het volgende voorbeeld wordt het patroon S*A gezocht in elke waarde van het veld ProductCode. Als de productcode KBS5412A is, retourneert de expressie 2.

BirtStr.search( "S*A", row["ProductCode"] )

In het volgende voorbeeld wordt BirtStr.search( ) in combinatie met BirtStr.left( ) gebruikt voor weergave van de tekens die voorafgaan aan het zoekpatroon -Model* in de productnaam. De functie BirtStr.left( ) haalt een subreeks met een opgegeven lengte op die begint bij het eerste teken. In het voorbeeld is de lengte van de weergegeven subreeks gelijk aan de numerieke positie van het zoekpatroon.

stringPatternPosition = BirtStr.search( "-Model*", row["productName"] );
displayString = BirtStr.left( row["productName"], stringPatternPosition );

Als de productnaam XMS-ModelA-1234 is, retourneert de expressie XMS.

BirtStr.toLower

Deze functie converteert alle letters in een tekenreeks naar kleine letters.

Syntaxis

BirtStr.toLower( bron )

Parameter

bron

Tekenreeks. De tekenreeks die moet worden omgezet in kleine letters.

Resultaat

Tekenreeks. De opgegeven tekenreeks, maar dan helemaal in kleine letters.

Voorbeeld

Het volgende voorbeeld geeft alle waarden in het veld productLine weer in kleine letters:

BirtStr.toLower( row["productLine"] )

BirtStr.toUpper

Deze functie converteert alle letters in een tekenreeks naar hoofdletters.

Syntaxis

BirtStr.toUpper( bron )

Parameter

bron

Tekenreeks. De tekenreeks die moet worden omgezet in hoofdletters.

Resultaat

Tekenreeks. De opgegeven tekenreeks, maar dan helemaal in hoofdletters.

Voorbeeld

Het volgende voorbeeld geeft alle waarden in het veld customerName weer in hoofdletters:

BirtStr.toUpper( row["customerName"] )

BirtStr.trim

Het resultaat van deze functie is een tekenreeks waaruit alle voorloop- en volgspaties zijn verwijderd. Spaties tussen woorden worden niet verwijderd.

Syntaxis

BirtStr.trim( bron )

Parameter

bron

Tekenreeks. De tekenreeks waaruit de voorloop- en volgspaties worden verwijderd.

Resultaat

Tekenreeks. Een tekenreeks waaruit alle voorloop- en volgspaties zijn verwijderd.

Voorbeeld

In het volgende voorbeeld wordt BirtStr.trim( ) gebruikt om alle voorloop- en volgspaties te verwijderen uit de waarden in de velden FirstName en LastName.

BirtStr.trim( row["FirstName"]) + " " + BirtStr.trim(row["LastName"] )

BirtStr.trimLeft

Het resultaat van deze functie is een tekenreeks waaruit alle voorloopspaties zijn verwijderd. Spaties tussen woorden worden niet verwijderd.

Syntaxis

BirtStr.trimLeft( bron )

Parameter

bron

Tekenreeks. De tekenreeks waaruit de voorloopspaties worden verwijderd.

Resultaat

Tekenreeks. Een tekenreeks waaruit alle voorloopspaties zijn verwijderd.

Voorbeeld

In het volgende voorbeeld wordt een literale tekenreeks samengevoegs met elke waarde in het veld customerName. BirtStr.trimLeft( ) verwijdert alle spaties die voorafgaan aan de waarden in customerName, zodat er geen extra spaties tussen de literale tekenreeks en de waarde in customerName staan.

"Customer name: " + BirtStr.trimLeft( row["customerName"] )

BirtStr.trimRight

Het resultaat van deze functie is een tekenreeks waaruit alle volgspaties zijn verwijderd. Spaties tussen woorden worden niet verwijderd.

Syntaxis

BirtStr.trimRight( bron )

Parameter

bron

Tekenreeks. De tekenreeks waaruit de volgspaties worden verwijderd.

Resultaat

Tekenreeks. Een tekenreeks waaruit alle volgspaties zijn verwijderd.

Voorbeeld

In het volgende voorbeeld wordt elke waarde in het veld Comment voorzien van een puntkomma en vervolgens samengevoegd met een waarde in het veld Action. BirtStr.trimRight( ) verwijdert alle spaties achter de waarden in Comment, zodat er geen extra spaties tussen de tekenreeks in Comment en de puntkomma staan.

BirtStr.trimRight( row["Comment"]) + "; " + row["Action"] )

(c) Copyright Actuate Corporation 2013