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.
Deze functie berekent de lengte van een bepaalde tekenreeks.
Syntaxis
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:
In het volgende voorbeeld is het resultaat de lengte van elke waarde in het veld CustomerName:
Het resultaat van deze functie is een tekenreeks die ontstaat uit het samenvoegen van opgegeven tekenreeksen.
Syntaxis
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"] )
Deze functie berekent de positie van een opgegeven subreeks in een bepaalde tekenreeks.
Syntaxis
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:
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.
Als de naam van de klant Julie Murphy is, is het resultaat van de expressie Julie.
Deze functie haalt een subreeks met een opgegeven lengte op uit een tekenreeks. Het beginpunt is het meest linkse of eerste teken.
Syntaxis
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:
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.
Als de naam van de klant Julie Murphy is, is het resultaat van de expressie Julie.
Deze functie haalt een subreeks met een opgegeven lengte op uit een tekenreeks. Het beginpunt is het meest rechtse of laatste teken.
Syntaxis
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:
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.
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.
Deze functie berekent de positie van een opgegeven subreeks in een bepaalde tekenreeks. De subreeks mag jokertekens bevatten.
Syntaxis
Parameters
patroon
Tekenreeks. Het patroon waarnaar moet worden gezocht. De zoekactie is niet hoofdlettergevoelig. In het patroon kunt u de volgende jokertekens gebruiken:
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:
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:
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.
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.
Als de productnaam XMS-ModelA-1234 is, retourneert de expressie XMS.
Deze functie converteert alle letters in een tekenreeks naar kleine letters.
Syntaxis
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:
Deze functie converteert alle letters in een tekenreeks naar hoofdletters.
Syntaxis
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:
Het resultaat van deze functie is een tekenreeks waaruit alle voorloop- en volgspaties zijn verwijderd. Spaties tussen woorden worden niet verwijderd.
Syntaxis
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.
Het resultaat van deze functie is een tekenreeks waaruit alle voorloopspaties zijn verwijderd. Spaties tussen woorden worden niet verwijderd.
Syntaxis
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.
Het resultaat van deze functie is een tekenreeks waaruit alle volgspaties zijn verwijderd. Spaties tussen woorden worden niet verwijderd.
Syntaxis
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.