A BirtStr osztály karaktersorozatok kezeléséhez biztosít függvényeket, például karaktersorozatok összefűzéséhez, felesleges üres helyek levágásához, egy karaktersorozat részeinek lekérdezéséhez és karaktersorozatok kis- és nagybetűs megjelenítéséhez. Ez az osztály statikus. Az alkalmazás nem hozhat létre példányokat az osztályból.
Ez a függvény egy adott karaktersorozat hosszát adja vissza.
Szintaxis
Paraméter
source
Karaktersorozat. A kiértékelendő karaktersorozat.
Visszatérési érték
Egész szám. A megadott karaktersorozatban lévő karakterek száma.
Példák
A következő példa egy adott karaktersorozat hosszát adja vissza:
A következő példa a CustomerName (vásárlónév) mező egyes értékeinek hosszát adja vissza:
Ez a függvény a megadott karaktersorozatok összefűzésével létrejött karaktersorozatot adja vissza.
Szintaxis
Paraméter
source1, ..., sourceN
Karaktersorozat. Az összefűzendő karaktersorozatok.
Visszatérési érték
Karaktersorozat. A karaktersorozatok összefűzésének eredményeként létrejött karaktersorozat.
Példa
A következő példa egy teljes címet ad vissza több mező értékének összefűzésével:
BirtStr.concat( row["AddressLine1"], ", ", row["AddressLine2"], ", ", row["City"], " ", row["PostalCode"], "row["State"], ", ", row["Country"] )
Ez a függvény egy megadott rész-karaktersorozat pozícióját adja vissza egy adott karaktersorozatban.
Szintaxis
Paraméterek
cél
Karaktersorozat. A keresendő rész-karaktersorozat. A keresésben a kis- és nagybetűk különbözőnek számítanak.
source
Karaktersorozat. A karaktersorozat, amelyben a megadott rész-karaktersorozatot keresni kell.
start
Egész szám. Elhagyható. A forrás karaktersorozat azon helye, ahol a keresést kezdeni kell. Ha kihagyja ezt az argumentumot, akkor a függvény a karaktersorozat első karakterétől kezdi a keresést.
Visszatérési érték
Egész szám. A rész-karaktersorozat numerikus pozíciója a karaktersorozatban. Egy karaktersorozat első karakterének pozíciója 0. Ha a rész-karaktersorozat nem található, akkor a függvény a -1 értéket adja vissza.
Példák
A következő példa a megadott karakterek numerikus pozícióját adja vissza a megadott karaktersorozatokban:
A következő példa a BirtStr.indexOf( ) függvényt a BirtStr.left( ) függvénnyel együtt használja a vásárlónévben (customerName) a szóköz karaktert megelőző karakterek megjelenítéséhez. A BirtStr.left( ) függvény kinyer egy megadott hosszúságú rész-karaktersorozatot az első karaktertől kezdve. A példában a megjelenítendő rész-karaktersorozat hossza megegyezik a szóköz karakter numerikus pozíciójával.
Ha a vásárló neve Julie Murphy, akkor a kifejezés a Julie értéket adja vissza.
Ez a függvény kinyer egy megadott hosszúságú rész-karaktersorozatot egy karaktersorozatból, a bal oldali, vagy első karaktertől kezdve.
Szintaxis
Paraméterek
source
Karaktersorozat. A karaktersorozat, amelyből ki kell nyerni a rész-karaktersorozatot.
n
Egész szám. A kinyerni kívánt karakterek száma, az első karaktertől kezdve.
Visszatérési érték
Karaktersorozat. Egy megadott hosszúságú rész-karaktersorozat.
Példák
A következő példa különböző hosszúságú rész-karaktersorozatokat ad vissza a megadott karaktersorozatokból:
A következő példa a BirtStr.indexOf( ) függvényt a BirtStr.left( ) függvénnyel együtt használja a vásárlónévben (customerName) a szóköz karaktert megelőző karakterek megjelenítéséhez. A BirtStr.left( ) függvény kinyer egy megadott hosszúságú rész-karaktersorozatot az első karaktertől kezdve. A példában a megjelenítendő rész-karaktersorozat hossza megegyezik a szóköz karakter numerikus pozíciójával.
Ha a vásárló neve Julie Murphy, akkor a kifejezés a Julie értéket adja vissza.
Ez a függvény kinyer egy megadott hosszúságú rész-karaktersorozatot egy karaktersorozatból, a jobb oldali, vagy utolsó karaktertől kezdve.
Szintaxis
Paraméterek
source
Karaktersorozat. A karaktersorozat, amelyből ki kell nyerni a rész-karaktersorozatot.
n
Egész szám. A kinyerni kívánt karakterek száma, az utolsó karaktertől kezdve.
Visszatérési érték
Karaktersorozat. Egy megadott hosszúságú rész-karaktersorozat.
Példák
A következő példa különböző hosszúságú rész-karaktersorozatokat ad vissza a megadott karaktersorozatokból:
A következő példa a BirtStr.right( ) függvényt a BirtStr.indexOf( ) és BirtStr.charLength( ) függvényekkel együtt használja egy vásárlónévben a szóköz karakter után megjelenő karakterek megjelenítéséhez. Ez a példa feltételezi, hogy a kötőjel utáni karakterek száma változó. Ezért a megjelenítendő karakterek száma a teljes karaktersorozat hossza (amelyet a BirtStr.charLength( ) adott vissza) mínusz a kötőjelig terjedő hossz (amelyet a BirtStr.indexOf( ) függvény adott vissza).
Ha a vásárló neve Julie Murphy, akkor a kifejezés a Murphy értéket adja vissza. Ha a vásárló neve Kwai Li, akkor a kifejezés a Li értéket adja vissza.
Ez a függvény egy megadott rész-karaktersorozat pozícióját adja vissza egy adott karaktersorozatban. A rész-karaktersorozat tartalmazhat helyettesítő karaktereket.
Szintaxis
Paraméterek
minta
Karaktersorozat. A keresni kívánt karaktersorozat minta. A keresésben a kis- és nagybetűk nincsenek megkülönböztetve. A mintában a következő helyettesítő karaktereket használhatja:
Egy karaktersorozatban literálként szereplő csillag vagy kérdőjel kereséséhez szúrjon be a karakterek elé két fordított törtvonalat (\\). Például az R*10 rész-karaktersorozat kereséséhez használja a következő karaktersorozat mintát:
source
Karaktersorozat. A karaktersorozat, amelyben a megadott rész-karaktersorozatot keresni kell.
index
Egész szám. Elhagyható. A forrás karaktersorozat azon helye, ahol a keresést kezdeni kell. Ha kihagyja ezt az argumentumot, akkor a függvény a karaktersorozat első karakterétől kezdi a keresést.
Visszatérési érték
Egész szám. A rész-karaktersorozat numerikus pozíciója a karaktersorozatban. Egy karaktersorozat első karakterének pozíciója 0. Ha a rész-karaktersorozat nem található, akkor a függvény a -1 értéket adja vissza.
Példák
A következő példa a megadott karaktersorozat minták numerikus pozícióját adja vissza a megadott karaktersorozatokban:
A következő példa az S*A karaktersorozat mintát keresi meg a ProductCode (termékkód) mező minden egyes értékében. Ha a termékkód KBS5412A, akkor a kifejezés a 2 értéket adja vissza.
A következő példa a BirtStr.search( ) függvényt a BirtStr.left( ) függvénnyel együtt használja a -Model* karaktersorozat mintát megelőző karakterek megkereséséhez egy terméknévben. A BirtStr.left( ) függvény kinyer egy megadott hosszúságú rész-karaktersorozatot az első karaktertől kezdve. A példában a megjelenítendő rész-karaktersorozat hossza megegyezik a karaktersorozat minta numerikus pozíciójával.
Ha a termék neve XMS-ModelA-1234, akkor a kifejezés az XMS értéket adja vissza.
Ez a függvény kisbetűssé alakítja át egy karaktersorozat összes betűjét.
Szintaxis
Paraméter
source
Karaktersorozat. A kisbetűssé alakítandó karaktersorozat.
Visszatérési érték
Karaktersorozat. A megadott karaktersorozat csupa kisbetűvel.
Példa
A következő példa a productLine (termékcsalád) mezőben lévő összes értéket kisbetűsen jeleníti meg:
Ez a függvény nagybetűssé alakítja át egy karaktersorozat összes betűjét.
Szintaxis
Paraméter
source
Karaktersorozat. A nagybetűssé alakítandó karaktersorozat.
Visszatérési érték
Karaktersorozat. A megadott karaktersorozat csupa nagybetűvel.
Példa
A következő példa a customerName (vásárlónév) mezőben lévő összes értéket nagybetűsen jeleníti meg:
Ez a függvény egy olyan karaktersorozatot ad vissza, amelyből el van távolítva az összes bevezető és lezáró szóközszerű karakter. A szavak közti üres karaktereket nem távolítja el.
Szintaxis
Paraméter
source
Karaktersorozat. A karaktersorozat, amelyből el kell távolítani a bevezető és befejező üres karaktereket.
Visszatérési érték
Karaktersorozat. Egy karaktersorozat, amelyből el van távolítva az összes bevezető és befejező üres karakter.
Példa
A következő példa a BirtStr.trim( ) függvényt használja az összes bevezető és befejező üres karakter eltávolításához a FirstName (keresztnév) és LastName (vezetéknév) mezők értékeiből.
Ez a függvény egy olyan karaktersorozatot ad vissza, amelyből el van távolítva az összes bevezető és lezáró szóközszerű karakter. A szavak közti üres karaktereket nem távolítja el.
Szintaxis
Paraméter
source
Karaktersorozat. A karaktersorozat, amelyből el kell távolítani a bevezető üres karaktereket.
Visszatérési érték
Karaktersorozat. Egy karaktersorozat, amelyből el van távolítva az összes bevezető üres karakter.
Példa
A következő példa összefűz egy literál karaktersorozatot a customerName (vásárlónév) mező minden egyes értékével. A BirtStr.trimLeft( ) függvény eltávolítja a customerName értéket megelőző összes üres karaktert, hogy a literál karaktersorozat és a customerName értéke között ne legyenek üres karakterek.
Ez a függvény egy olyan karaktersorozatot ad vissza, amelyből az összes befejező üres karakter el van távolítva. A szavak közti üres karaktereket nem távolítja el.
Szintaxis
Paraméter
source
Karaktersorozat. A karaktersorozat, amelyből el kell távolítani a befejező üres karaktereket.
Visszatérési érték
Karaktersorozat. Egy karaktersorozat, amelyből el van távolítva az összes befejező üres karakter.
Példa
A következő példa a Comment (megjegyzés) mezőben lévő minden egyes értéket összefűzi egy pontosvesszővel, majd az Action (művelet) mező egy elemével. A BirtStr.trimRight( ) függvény eltávolítja a Comment értéke utáni összes befejező üres karaktert, hogy a Comment karaktersorozat és a pontosvessző között ne legyenek üres karakterek.