Edellinen Seuraava

BirtStr-luokka

BirtStr-luokan funktioiden avulla voit käsitellä merkkijonoja esimerkiksi yhdistelemällä niitä, poistamalla niistä ylimääräisiä tyhjämerkkejä, noutamalla niiden osia tai muuttamalla ne täysin pienillä tai isoilla kirjaimilla kirjoitetuksi. Tämä luokka on staattinen. Sovellus ei voi luoda luokan ilmentymiä.

BirtStr.charLength

Tämä funktio palauttaa annetun merkkijonon pituuden.

Syntaksi

kokonaisluku BirtStr.charLength( merkkijono [lähde] )

Parametri

lähde

Merkkijono. Arvioitava merkkijono.

Palautukset

Kokonaisluku. Määritetyn merkkijonon merkkimäärä.

Esimerkkejä

Seuraava esimerkki palauttaa määritetyn merkkijonon pituuden:

BirtStr.charLength( "Anneli Virta" ) // palauttaa luvun 12

Seuraava esimerkki palauttaa kunkin CustomerName-kentän arvon pituuden:

BirtStr.charLength( row["CustomerName"] )

BirtStr.concat

Tämä funktio palauttaa määritettyjen merkkijonojen yhdistämisen seurauksena syntyvän merkkijonon.

Syntaksi

merkkijono BirtStr.concat( merkkijono [lähde1, ..., lähdeN] )

Parametri

lähde1, ..., lähdeN

Merkkijono. Yhdistettävät merkkijonot.

Palautukset

Merkkijono. Määritettyjen merkkijonojen yhdistämisen seurauksena syntyvä merkkijono.

Esimerkki

Seuraava esimerkki palauttaa kokonaisen osoitteen yhdistämällä usean eri kentän arvot:

BirtStr.concat( row["AddressLine1"], ", ", row["AddressLine2"], ", ", row["City"], " ", row["PostalCode"], "row["State"], ", ", row["Country"] )

BirtStr.indexOf

Tämä funktio palauttaa määritetyn osamerkkijonon paikan annetussa merkkijonossa.

Syntaksi

kokonaisluku BirtStr.indexOf( merkkijono [kohde], merkkijono [lähde], kokonaisluku [alku] )

Parametrit

kohde

Merkkijono. Haettava osamerkkijono. Kirjainkoko on merkitsevä haussa.

lähde

Merkkijono. Merkkijono, josta määritettyä osamerkkijonoa haetaan.

alku

Kokonaisluku. Valinnainen. Lähdemerkkijonon paikka, josta haku alkaa. Jos argumenttia ei määritetä, funktio aloittaa haun merkkijonon ensimmäisestä merkistä.

Palautukset

Kokonaisluku. Osamerkkijonon järjestysnumerona ilmaistu paikka merkkijonossa. Merkkijonon ensimmäisen merkkipaikan järjestysnumero on 0. Jos osamerkkijonoa ei löydy, funktio palauttaa arvon -1.

Esimerkkejä

Seuraava esimerkki palauttaa määritettyjen merkkien järjestysnumerona ilmaistun paikan määritetyissä merkkijonoissa:

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

Seuraavassa esimerkissä käytetään BirtStr.indexOf )-funktiota yhdessä BirtStr.left( )-funktion kanssa niiden merkkien näyttämiseen, jotka edeltävät tyhjämerkkiä asiakkaan nimessä. BirtStr.left( )-funktio poimii määritetyn pituisen osamerkkijonon ensimmäisestä merkistä alkaen. Tässä esimerkissä näytettävän osamerkkijonon pituus on sama kuin tyhjämerkin merkkipaikan järjestysnumero.

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

Jos asiakkaan nimi on "Julie Murphy", lauseke palauttaa merkkijonon "Julie".

BirtStr.left

Tämä funktio poimii merkkijonosta määritetyn pituisen osamerkkijonon alkaen vasemmanpuoleisimmasta eli ensimmäisestä merkistä.

Syntaksi

merkkijono BirtStr.left( merkkijono [lähde], kokonaisluku [n] )

Parametrit

lähde

Merkkijono. Merkkijono, josta osamerkkijono poimitaan.

n

Kokonaisluku. Poimittavien merkkien määrä ensimmäisestä merkistä alkaen.

Palautukset

Merkkijono. Määritetyn pituinen osamerkkijono.

*
*
*

Esimerkkejä

Seuraava esimerkki palauttaa eri pituisia osamerkkijonoja määrätyistä merkkijonoista:

BirtStr.left( "Julie Murphy", 5 ) // palauttaa merkkijonon Julie
BirtStr.left( "Julie Murphy", 12 ) // palauttaa merkkijonon Julie Murphy

Seuraavassa esimerkissä käytetään BirtStr.indexOf )-funktiota yhdessä BirtStr.left( )-funktion kanssa niiden merkkien näyttämiseen, jotka edeltävät tyhjämerkkiä asiakkaan nimessä. BirtStr.left( )-funktio poimii määritetyn pituisen osamerkkijonon ensimmäisestä merkistä alkaen. Tässä esimerkissä näytettävän osamerkkijonon pituus on sama kuin tyhjämerkin merkkipaikan järjestysnumero.

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

Jos asiakkaan nimi on "Julie Murphy", lauseke palauttaa merkkijonon "Julie".

BirtStr.right

Tämä funktio poimii merkkijonosta määritetyn pituisen osamerkkijonon alkaen oikeanpuoleisimmasta eli viimeisestä merkistä.

Syntaksi

merkkijono BirtStr.right( merkkijono [lähde], kokonaisluku [n] )

Parametrit

lähde

Merkkijono. Merkkijono, josta osamerkkijono poimitaan.

n

Kokonaisluku. Poimittavien merkkien määrä viimeisestä merkistä alkaen.

Palautukset

Merkkijono. Määritetyn pituinen osamerkkijono.

*
*
*

Esimerkkejä

Seuraava esimerkki palauttaa eri pituisia osamerkkijonoja määrätyistä merkkijonoista:

BirtStr.right( "Julie Murphy", 6 ) // palauttaa merkkijonon Murphy
BirtStr.right( "Julie Murphy", 12 ) // palauttaa merkkijonon Julie Murphy

Seuraavassa esimerkissä on käytetty BirtStr.right( )-funktiota yhdessä BirtStr.indexOf( )- ja BirtStr.charLength( )-funktioiden kanssa niiden merkkien näyttämiseen, jotka esiintyvät asiakkaan nimessä tyhjämerkin jälkeen. Tässä esimerkissä oletetaan, että tavuviivan jälkeinen merkkimäärä vaihtelee. Tällöin näytettävä merkkien määrä on koko merkkijonon pituus (jonka BirtStr.charLength( )-funktio palauttaa) vähennettynä tavuviivan pituudella (jonka BirtStr.indexOf( )-funktio palauttaa).

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

Jos asiakkaan nimi on "Julie Murphy", lauseke palauttaa merkkijonon "Murphy". Jos asiakkaan nimi on "Kwai Li", lauseke palauttaa merkkijonon "Li".

BirtStr.search

Tämä funktio palauttaa määritetyn osamerkkijonon paikan annetussa merkkijonossa. Osamerkkijonossa voi olla yleismerkkejä.

Syntaksi

kokonaisluku BirtStr.search( merkkijono [malli], merkkijono [lähde], kokonaisluku [indeksi] )

Parametrit

malli

Merkkijono. Merkkijonomalli, jota haetaan. Kirjainkoko ei ole merkitsevä haussa. Voit käyttää mallissa seuraavia yleismerkkejä:

*
*

Jos haluat käyttää vertailumallissa tähti- tai kysymysmerkkiä, kirjoita niiden eteen kaksi kenoviivaa (\\). Jos esimerkiksi haluat hakea osamerkkijonoa "R*10", käytä seuraavaa merkkijonomallia:

"R\\*10"

lähde

Merkkijono. Merkkijono, josta määritettyä osamerkkijonoa haetaan.

index

Kokonaisluku. Valinnainen. Lähdemerkkijonon paikka, josta haku alkaa. Jos argumenttia ei määritetä, funktio aloittaa haun merkkijonon ensimmäisestä merkistä.

Palautukset

Kokonaisluku. Osamerkkijonon järjestysnumerona ilmaistu paikka merkkijonossa. Merkkijonon ensimmäisen merkkipaikan järjestysnumero on 0. Jos osamerkkijonoa ei löydy, funktio palauttaa arvon -1.

Esimerkkejä

Seuraava esimerkki palauttaa määritettyjen merkkijonomallien järjestysnumerona ilmaistun paikan määritetyissä merkkijonoissa:

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

Seuraavassa esimerkissä haetaan merkkijonomallia S*A kaikista ProductCode-kentän (tuotekoodi) arvoista. Jos tuotekoodi on KBS5412A, lauseke palauttaa arvon 2.

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

Seuraavassa esimerkissä käytetään BirtStr.search( )-funktiota yhdessä BirtStr.left( )-funktion kanssa niiden merkkien näyttämiseen, jotka edeltävät merkkijonomallia "-Model*" tuotteen nimessä. BirtStr.left( )-funktio poimii määritetyn pituisen osamerkkijonon ensimmäisestä merkistä alkaen. Tässä esimerkissä näytettävän osamerkkijonon pituus on sama kuin merkkijonomallin merkkipaikan järjestysnumero.

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

Jos tuotteen nimi on XMS-ModelA-1234, lauseke palauttaa merkkijonon XMS.

BirtStr.toLower

Tämä funktio muuntaa kaikki merkkijonon kirjaimet pieniksi kirjaimiksi.

Syntaksi

merkkijono BirtStr.toLower( merkkijono [lähde] )

Parametri

lähde

Merkkijono. Pienillä kirjaimilla kirjoitetuksi muunnettava merkkijono.

Palautukset

Merkkijono. Määritetty merkkijono kokonaan pienillä kirjaimilla kirjoitettuna

Esimerkki

Seuraava esimerkki näyttää kaikki productLine-kentän arvot pienillä kirjaimilla kirjoitettuina:

BirtStr.toLower( row["productLine"] )

BirtStr.toUpper

Tämä funktio muuntaa kaikki merkkijonon kirjaimet isoiksi kirjaimiksi.

Syntaksi

merkkijono BirtStr.toUpper( merkkijono [lähde] )

Parametri

lähde

Merkkijono. Isoilla kirjaimilla kirjoitetuksi muunnettava merkkijono.

Palautukset

Merkkijono. Määritetty merkkijono kokonaan isoilla kirjaimilla kirjoitettuna

Esimerkki

Seuraava esimerkki näyttää kaikki customerName-kentän arvot isoilla kirjaimilla kirjoitettuina:

BirtStr.toUpper( row["customerName"] )

BirtStr.trim

Tämä funktio palauttaa merkkijonon, josta on poistettu kaikki alkuperäisen merkkijonon jälkeiset ja sitä edeltävät tyhjämerkit. Se ei poista sanojen välisiä tyhjämerkkejä.

Syntaksi

merkkijono BirtStr.trim( merkkijono [lähde] )

Parametri

lähde

Merkkijono. Merkkijono, josta merkkijonoa edeltävät ja sen jälkeiset tyhjämerkit poistetaan.

Palautukset

Merkkijono. Merkkijono, josta on poistettu sitä edeltävät ja sen jälkeiset tyhjämerkit.

Esimerkki

Seuraavassa esimerkissä funktion BirtStr.trim( ) avulla poistetaan kaikki FirstName- ja LastName-tietokenttien arvoja edeltävät sekä niiden jälkeiset tyhjämerkit.

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

BirtStr.trimLeft

Tämä funktio palauttaa merkkijonon, josta on poistettu kaikki alkuperäisen merkkijonon jälkeiset ja sitä edeltävät tyhjämerkit. Se ei poista sanojen välisiä tyhjämerkkejä.

Syntaksi

merkkijono BirtStr.trimLeft( merkkijono [lähde] )

Parametri

lähde

Merkkijono. Merkkijono, josta edeltävät tyhjämerkit poistetaan.

Palautukset

Merkkijono. Merkkijono, josta on poistettu kaikki edeltävät tyhjämerkit.

Esimerkki

Seuraavassa esimerkissä literaalimerkkijono yhdistetään kaikkiin customerName-kentän (asiakkaan nimi) arvoihin. BirtStr.trimLeft( )-funktio poistaa kaikki customerName-arvoa edeltävät tyhjämerkit niin, että literaalimerkkijonon customerName-arvon välille ei jää tyhjämerkkejä.

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

BirtStr.trimRight

Tämä funktio palauttaa merkkijonon, josta on poistettu kaikki alkuperäisen merkkijonon jälkeiset tyhjämerkit. Se ei poista sanojen välisiä tyhjämerkkejä.

Syntaksi

merkkijono BirtStr.trimRight( merkkijono [lähde] )

Parametri

lähde

Merkkijono. Merkkijono, josta merkkijonon jälkeiset tyhjämerkit poistetaan.

Palautukset

Merkkijono. Merkkijono, josta on poistettu sen jälkeiset tyhjämerkit.

Esimerkki

Seuraavassa esimerkissä kuhunkin Comment-kentän (kommentti) arvoon liitetään puolipiste ja Action-kentän (toiminto) arvo. BirtStr.trimRight( )-funktio poistaa kaikki Comment-arvon jälkeisen tyhjämerkit niin, ettei kommenttimerkkijonon ja puolipisteen välille ei jää tyhjämerkkejä.

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

(c) Copyright Actuate Corporation 2013