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ä.
Tämä funktio palauttaa annetun merkkijonon pituuden.
Syntaksi
Parametri
lähde
Merkkijono. Arvioitava merkkijono.
Palautukset
Kokonaisluku. Määritetyn merkkijonon merkkimäärä.
Esimerkkejä
Seuraava esimerkki palauttaa määritetyn merkkijonon pituuden:
Seuraava esimerkki palauttaa kunkin CustomerName-kentän arvon pituuden:
Tämä funktio palauttaa määritettyjen merkkijonojen yhdistämisen seurauksena syntyvän merkkijonon.
Syntaksi
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"] )
Tämä funktio palauttaa määritetyn osamerkkijonon paikan annetussa merkkijonossa.
Syntaksi
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:
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.
Jos asiakkaan nimi on "Julie Murphy", lauseke palauttaa merkkijonon "Julie".
Tämä funktio poimii merkkijonosta määritetyn pituisen osamerkkijonon alkaen vasemmanpuoleisimmasta eli ensimmäisestä merkistä.
Syntaksi
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:
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.
Jos asiakkaan nimi on "Julie Murphy", lauseke palauttaa merkkijonon "Julie".
Tämä funktio poimii merkkijonosta määritetyn pituisen osamerkkijonon alkaen oikeanpuoleisimmasta eli viimeisestä merkistä.
Syntaksi
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:
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).
Jos asiakkaan nimi on "Julie Murphy", lauseke palauttaa merkkijonon "Murphy". Jos asiakkaan nimi on "Kwai Li", lauseke palauttaa merkkijonon "Li".
Tämä funktio palauttaa määritetyn osamerkkijonon paikan annetussa merkkijonossa. Osamerkkijonossa voi olla yleismerkkejä.
Syntaksi
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:
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:
Seuraavassa esimerkissä haetaan merkkijonomallia S*A kaikista ProductCode-kentän (tuotekoodi) arvoista. Jos tuotekoodi on KBS5412A, lauseke palauttaa arvon 2.
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.
Jos tuotteen nimi on XMS-ModelA-1234, lauseke palauttaa merkkijonon XMS.
Tämä funktio muuntaa kaikki merkkijonon kirjaimet pieniksi kirjaimiksi.
Syntaksi
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:
Tämä funktio muuntaa kaikki merkkijonon kirjaimet isoiksi kirjaimiksi.
Syntaksi
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:
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
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.
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
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ä.
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
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ä.