LitDev 1.2.24.0 DE
http://litdev.uk/LitDev.De.html Extension API
LDText
Methoden zur String-/Textmanipulation.
example other-samples\LDxml.sb
Compare
|
FastStringAppend
|
FastStringClear
|
|
FastStringGet
|
FastStringNew
|
FindAll
|
|
GetHeight
|
GetWidth
|
Replace
|
|
Split
|
Trim
|
Compare(text1,text2)
Lexikalischer Vergleich zweier Textstrings (rel. Position in deren Sortierreihenfolge) oder SB Arrays. Der Vergleich ist unabhängig von GROß-/kleinschr. und Kultur.
text1 Der erste Vergleichsstring.
text2 Der zweite Vergleichsstring.
returns Eine Ganzzahl, wobei:
<0 text1 ist kleiner als text2
=0 beide Strings sind gleichwertig
>0 text1 ist größer als text2
example LDText.Compare("ABCD", "abd") '-1
LDText.Compare("ABCD", " abd") '1
LDText.Compare("Aß", "ass") '0
LDText.Compare(arr1, arr2)
FastStringAppend(fastString,text)
Fügt einen Textstring an ein FastString Objekt an.
fastString Der Name des FastString Objekts.
text Der anzufügende Textstring.
FastStringClear(fastString)
Bereinigt ein FastString Objekt, Zurücksetzen auf "".
fastString Der Name des FastString Objekts.
FastStringGet(fastString)
Ermittelt den aktuellen Textinhalt in einem FastString Objekt.
fastString Der Name des FastString Objekts.
returns Der aktuelle FastString Text oder "".
FastStringNew()
Erstellt ein neues FastString Objekt zum schnellen Anfügen von Textstrings (Intern: FastString#, StringBuilder).
returns Der Name für das neue FastString Objekt.
FindAll(text,find)
Ermittelt alle Vorkommen eines Untertextes im Basistext.
text Der zu durchsuchende Basistext.
find Der zu suchende Teiltext (buchstabengetreu).
returns Ein Array mit den Startpositionen für jeden gefundenen Subtext (0 bei keinem Treffer).
GetHeight(text)
Ermittelt die Höhe [Pxl] in der ein Text im GraphicsWindow bei aktuell gesetzter Schrift angezeigt wird. Gesamthöhe aller Zeilen bei mehrzeiligem Text (incl. endendem CrLf).
Das GraphicsWindow muß für diese Methode geöffnet sein.
text Der Text dessen Höhe zu ermitteln ist.
returns Die Texthöhe [Pxl].
GetWidth(text)
Ermittelt die Breite [Pxl] in der ein Text im GraphicsWindow bei aktuell gesetzter Schrift angezeigt wird. Breite der längsten Zeile bei mehrzeiligem Text.
Das GraphicsWindow muß für diese Methode geöffnet sein.
text Der Text dessen Breite zu ermitteln ist.
returns Die Textbreite [Pxl].
Replace(text,find,replace)
Sucht und ersetzt alle Vorkommen einer Zeichenfolge in einem Text durch einen Ersatzstring.
text Der zu durchsuchende Text (bleibt unverändert).
find Die zu suchende und ersetzende Zeichenfolge (buchstabengetreu).
replace Der Ersatzstring, wodurch alle Vorkommen der Zeichenfolge ersetzt werden oder "".
returns Die geänderte Kopie des Textes.
example 'Zeilenumbruch entfernen
crlf = Text.GetCharacter(13) + Text.GetCharacter(10)
out = LDText.Replace(in, crlf,"")
Split(text,separator)
Zerteilt einen Text an einem/mehreren angegebenen Trennzeichen zu Teilstrings als Array.
Mehrere aufeinanderfolgende Trennzeichen im Text werden als einzelnes behandelt (zB. " " entspricht " ").
text Der aufzuteilende String.
separator Das Trennzeichen als String (zB. " " oder ";") oder mehrere Trennzeichen als Array ("" für Gesamttext als Arrayindex 1).
GROß/klein Unterscheidung.
returns Die einzelnen aufgetrennten Textteile als Array (ab 1).
example A. Split an ":
'qu = Text.GetCharacter(34)
Split(text, """") 'oder qu
B. Split zu Zeilen:
Split(text, crlf)
C. Array splitten:
arr = "name=wert;..;"
Split(arr, ";")
D. Split an (mehreren) " ":
Split("a b c", " ")
Trim(text)
Ermittelt einen String in dem alle führenden und endenden 'White Space' (Leerzeichen) entfernt sind.
text Die zu beschneidende Zeichenfolge (bleibt unverändert).
returns Eine beschnittene Kopie des Eingabestrings.