Formular&Script / Funktionen
Textfunktionen
Mit Funktionen können Sie bestimmte Werte abfragen, berechnen oder ändern.
GetTextWidth
Syntax
Ergebnis = GetTextWidth(Text)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Text | text | Text, dessen Breite ermittelt werden soll |
| Ergebnis | number | Breite des Textes (in Zehntelmillimetern) |
Beschreibung
Die GetTextWidth-Funktion ermittelt die Breite eines Textes. Dadurch lassen sich zum Beispiel Texte mehrerer DrawText-Anweisungen nebeneinander ausgeben und differenziert formatieren.
Beispiel
Asc
Syntax
Ergebnis = Asc(Text)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Beliebiger Text |
| Ergebnis | number | Der ASCII-Wert des ersten Zeichens der Quelle |
Beschreibung
Die Asc-Funktion gibt den Zeichencode des ersten Zeichens eines übergebenen Textes zurück. Der ASCII-Zeichensatz umfasst 256 Zeichen, die auf praktisch jeder Plattform identisch sind. Die -Funktion liefert immer den Zeichencode für das Encoding, das dem Text zugrunde liegt. Ist der Text also mit MacRoman codiert, so erhalten Sie den Zeichencode entsprechend der MacRoman-Codierung.
Beispiel
CountFields
Syntax
Ergebnis = CountFields(Quelle, Trennzeichen)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Der Text, der geprüft werden soll |
| Trennzeichen | text | Das Trennzeichen, das die Felder der Quelle voneinander trennt |
| Ergebnis | number | Die Anzahl der Felder in der Quelle, die durch das Trennzeichen getrennt sind |
Beschreibung
Die CountFields-Funktion gibt die Anzahl der Felder eines Textes zurück, die durch das angegebene Trennzeichen getrennt sind. Die Funktion CountFields wird üblicherweise verwendet, um spaltenweise Daten aus einer Textdatei einzulesen, die durch ein bestimmtes Zeichen voneinander getrennt sind. Wenn das Trennzeichen in der Quelle nicht gefunden wird, gibt die CountFields-Funktion eine 1 zurück, wenn die Quelle keine Daten enthält, eine 0.
Beispiel
FTextToNumber
Syntax
Ergebnis = FTextToNumber(Quelle)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Beliebiger Text, der eine Zahl enthält. |
| Ergebnis | number | Die numerische Entsprechung des übergebenen Textes |
Beschreibung
Die FTextToNumber-Funktion konvertiert einen Text in eine Zahl. Die Funktion hört auf, den Text zu untersuchen, sobald es ein Zeichen nicht mehr als Teil einer Zahl erkennt. Alle anderen Zeichen werden automatisch entfernt. Die FTextToNumber-Funktion verwendet zur Umwandlung des Textes die länderspezifischen Einstellungen des verwendeten Betriebssystems (im Gegensatz zur Funktion TextToNumber). Wenn der Text keine Zahlen enthält, dann gibt die FTextToNumber-Funktion gibt 0 zurück.
Beispiel
Left
Syntax
Ergebnis = Left(Quelle, Anzahl)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Der Text, aus dem die Zeichen entnommen werden sollen |
| Anzahl | number | Die Anzahl der Zeichen, die aus der Quelle entnommen werden sollen |
| Ergebnis | text | Von links beginnend die ersten n Zeichen der Quelle, n = Anzahl |
Beschreibung
Die Left-Funktion gibt von links beginnend die ersten n Zeichen eines Textes zurück, dabei ist n die angegebene Anzahl. Ist n grösser als die Anzahl an Zeichen im Text, so werden alle Zeichen des Textes zurückgeliefert.
Beispiel
Length
Syntax
Ergebnis = Length(Quelle)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Beliebiger Text |
| Ergebnis | text | Die Anzahl der Zeichen in der Quelle |
Beschreibung
Die Length-Funktion gibt die Anzahl der Zeichen des angegeben Textes zurück.
Beispiel
Lower
Syntax
Ergebnis = Lower(Quelle)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Beliebiger Text |
| Ergebnis | text | Die Text der Quelle in Kleinbuchstaben |
Beschreibung
Die Lower-Funktion gibt den angegebenen Text in Kleinbuchstaben zurück. Um dagegen alle Zeichen grosszuschreiben, müssen Sie die Upper-Funkton verwenden.
Beispiel
LTrim
Syntax
Ergebnis = LTrim(Quelle)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Der Text, bei dem die führenden Leerzeichen entfernt werden sollen |
| Ergebnis | text | Der Quelltext ohne führende Leerzeichen |
Beschreibung
Die LTrim-Funktion entfernt führende Leerzeichen (ausgehend von der linken Seite) des angegebenen Textes. Alle Leerzeichen auf der rechten Seite bleiben erhalten. Um die Leerzeichen auf der rechten Seite zu entfernen, müssen Sie die RTrim-Funktion verwenden.
Beispiel
Middle
Syntax
Ergebnis = Middle(Quelle, Start, Länge)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Der Text, aus dem der Ausschnitt entnommen werden soll |
| Start | number | Die Stelle, an der der Ausschnitt entnommen werden soll |
| Länge | Number | Die Anzahl an Zeichen, die aus der Quelle entnommen werden soll |
| Ergebnis | text | Der Ausschnitt aus der Quelle, der an der angegebenen Stelle (Start) beginnt und die angegebene Länge hat |
Beschreibung
Die Middle-Funktion gibt einen Ausschnitt des angegebenen Textes zurück. Ist die als Startposition angegebene Zahl grösser als die Anzahl der Zeichen im übergebenen Text, dann wird eine leerer Text zurückgegeben. Die Anzahl der Zeichen eines Textes können Sie mit der Funktion Length bestimmen.
Beispiel
NthField
Syntax
Ergebnis = NthField(Quelle, Trennzeichen, Feldnummer)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Der Text, der Datenfelder enthält, die durch ein Trennzeichen voneinander getrennt sind |
| Trennzeichen | text | Das Zeichen, das die Datenfelder voneinander trennt |
| Feldnummer | number | Die Spaltennummer des Feldes, aus dem der Text entnommen werden soll |
| Ergebnis | text | Der Ausschnitt aus der Quelle, der an der angegebenen Stelle (Start) beginnt und die angegebene Länge hat |
Beschreibung
Die NthField-Funktion gibt den Feldwert aus einem Text zurück, der vor dem n-ten Auftreten des Trennzeichens im Text steht. Wenn n ausserhalb des gültigen Bereichs liegt, wird ein leerer Text zurückgeliefert.Das erste Feld trägt die Nummer 1. Die Anzahl der Datenfelder können Sie mit der Funktion CountFields ermitteln.
Beispiel
PatternCount
Syntax
Ergebnis = PatternCount(Quelle, Anzahl)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Beliebiger Text |
| Suche | text | Der Text, dessen Vorkommen in der Quelle gezählt werden soll |
| Ergebnis | number | Die Anzahl der Vorkommen des gesuchten Textes in der Quelle |
Beschreibung
Die PatternCount-Funktion gibt die Anzahl der Vorkommen eines Springs innerhalb eines Textes zurück. Wenn der Suchtext nicht im Quelltext vorhanden ist, wird 0 zurückgegeben. Die Gross- und Kleinschreibung wird bei der Suche nicht berücksichtigt.
Beispiel
Position
Syntax
Ergebnis = Position(Quelle, Suche, Start, Vorkommen)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Beliebiger Text |
| Suche | text | Der Text, dessen Vorkommen in der Quelle gesucht werden soll |
| Start | number | Die Stellen, ab der die Suche in der Quelle beginnen soll |
| Vorkommen | number | Das n-te Vorkommens des Suchtextes, für das die Position ermittelt werden soll |
| Ergebnis | number | Die Position, an der der Suchtext zum n-ten Mal vorkommt |
Beschreibung
Die Position-Funktion gibt die Position des n-ten Vorkommens einer Zeichenkette innerhalb eines bestimmten Textes zurück. Wenn der Suchtext nicht im Quelltext vorhanden ist, wird 0 zurückgegeben. Ist die als Startposition angegebene Zahl grösser als die Anzahl der Zeichen im übergebenen Text, dann wird 0 zurückgegeben. Ebenso wird 0 zurückgegeben, wenn der Wert für das Vorkommen des Suchtextes im Quelltext grösser ist als die Gesamtanzahl der Vorkommen im Quelltext. Die Gross- und Kleinschreibung wird bei der Suche nicht berücksichtigt.
Beispiel
Proper
Syntax
Ergebnis = Proper(Quelle)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Beliebiger Text |
| Ergebnis | text | Der Text der Quelle mit grossgeschriebenen Anfangsbuchstaben |
Beschreibung
Die Proper-Funktion gibt den angegebenen Text so zurück, dass die Anfangsbuchstaben aller Wörter grossgeschrieben sind.
Beispiel
Replace
Syntax
Ergebnis = Replace(Quelle, Suche, Ersetzung)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Beliebiger Text |
| Suche | text | Die Zeichen, die ersetzt werden sollen |
| Ersetzung | text | Die Zeichen, die eingesetzt werden |
| Ergebnis | text | Text, in dem das erste Vorkommen der gesuchten Zeichenkette durch die neue Zeichenkette ersetzt wurde |
Beschreibung
Die Replace-Funktion ersetzt das erste Vorkommen eines Zeichens oder einer Zeichenkette in einem Text durch die angegebenen Zeichen. Die Groß- und Kleinschreibung wird bei der Replace-Funktion nicht berücksichtigt. Wenn der Ersetzungstext leer ("") ist, entfernt die Funktion Replace das erste Vorkommen des Suchtextes in der Quelle. Ist der Suchtext leer (""), so gibt die Replace-Funktion den Quelltext unverändert zurück.
Beispiel
ReplaceAll
Syntax
Ergebnis = ReplaceAll(Quelle, Suche, Ersetzung)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Beliebiger Text |
| Suche | text | Die Zeichen, die ersetzt werden sollen |
| Ersetzung | text | Die Zeichen, die eingesetzt werden |
| Ergebnis | text | Text, in dem alle Vorkommen der gesuchten Zeichenkette durch die neue Zeichenkette ersetzt wurden |
Beschreibung
Die ReplaceAll-Funktion ersetzt alle Vorkommen eines Zeichens oder einer Zeichenkette in einem Text durch die angegebenen Zeichen. Die Groß- und Kleinschreibung wird bei der ReplaceAll-Funktion nicht berücksichtigt. Wenn der Ersetzungstext leer ("") ist, entfernt die Funktion ReplaceAll alle Vorkommen des Suchtextes in der Quelle. Ist der Suchtext leer (""), so gibt die ReplaceAll-Funktion den Quelltext unverändert zurück.
Beispiel
Right
Syntax
Ergebnis = Right(Quelle, Anzahl)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Der Text, aus dem die Zeichen entnommen werden sollen |
| Anzahl | number | Die Anzahl der Zeichen, die aus der Quelle entnommen werden sollen |
| Ergebnis | number | Von rechts beginnend die ersten n Zeichen der Quelle, n = Anzahl |
Beschreibung
Die Right-Funktion gibt von links beginnend die ersten n Zeichen eines Textes zurück, dabei ist n die angegebene Anzahl. Ist n grösser als die Anzahl an Zeichen im Text, so werden alle Zeichen des Textes zurückgeliefert.
Beispiel
RTrim
Syntax
Ergebnis = RTrim(Quelle)
Parameter | Datentyp | Beschreibung |
|---|---|---|
| Quelle | text | Der Text, bei dem die nachfolgenden Leerzeichen entfernt werden sollen |
| Ergebnis | text | Der Quelltext ohne nachfolgende Leerzeichen |
Beschreibung
Die RTrim-Funktion entfernt die nachfolgenden Leerzeichen (ausgehend von der rechten Seite) des angegebenen Textes. Alle Leerzeichen auf der linken Seite bleiben erhalten. Um die Leerzeichen auf der linken Seite zu entfernen, müssen Sie die LTrim-Funktion verwenden.
Beispiel
StrComp
Syntax
Ergebnis = StrComp(Text1, Text2)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Text1 | text | Der erste Vergleichstext |
| Text2 | text | Der zweite Vergleichstext |
| Ergebnis | number | Wenn Text1 < Text2 gibt die Funktion -1 zurück Wenn Text1 = Text2 gibt die Funktion 0 zurück Wenn Text1 > Text2 gibt die Funktion 1 zurück |
Beschreibung
Die StrComp-Funktion vergleicht zwei Texte bezüglich des ASCII-Werts miteinander, wobei nur das erste Vorkommen unterschiedlicher Zeichen bewertet wird. Der Textvergleich arbeitet lexikografisch, d. h., dass die Gross- und Kleinschreibung nur dann bewertet wird, wenn die Texte selbst gleich sind.
Beispiel
TextToBoolean
Syntax
Ergebnis = TextToBoolean(Quelle)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Der Text, der in einen booleschen Wert umgewandelt werden soll |
| Ergebnis | boolean | Der boolesche Wert des übergebenen Textes |
Beschreibung
Die TextToBoolean-Funktion konvertiert einen Text in einen booleschen Wert. Die Funktion gibt nur dann True zurück, wenn der Text "True" lautet. Die Gross- und Kleinschreibung wird nicht berücksichtigt.
Beispiel
TextToDate
Syntax
Ergebnis = TextToDate(Quelle)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Der Text, der in ein Datumsobjekt umgewandelt werden soll |
| Ergebnis | date | Das Datum als Datumswert |
Beschreibung
Die TextToDate-Funktion konvertiert eine numerische Datumsangabe vom Typ text in ein Datumsobjekt vom Typ date. Das Datum als Text muss im Format (T)T.(MMM)M.(JJ)JJ vorliegen (z. B. 1.1.2020, 01.01.2020, 1.1.20, 01.01.20 oder 1. Januar 2020). Wenn der Text keine numerische Datumsangabe enthält, dann gibt die Funktion das aktuelle Datum zurück.
Beispiel
TextToNumber
Syntax
Ergebnis = TextToNumber(Quelle)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Beliebiger Text, der eine Zahl enthält |
| Ergebnis | number | Die numerische Entsprechung des übergebenen Textes |
Beschreibung
Die TextToNumber-Funktion konvertiert einen Text in eine Zahl. Die Funktion hört auf, den Text zu untersuchen, sobald es ein Zeichen nicht mehr als Teil einer Zahl erkennt. Alle anderen Zeichen werden automatisch entfernt. Die TextToNumber-Funktion erkennt die Präfixe "&o" (oktal), "&b" (binär) und "&h" (hexadezimal). Vor dem Und-Zeichen (&) sind jedoch keine Leerzeichen erlaubt. Das bedeutet, " &HFF" liefert keinen Wert, "&HFF" liefert jedoch 255. Wenn der Text keine Zahlen enthält, dann gibt die TextToNumber-Funktion 0 zurück.
Beispiel
Trim
Syntax
Ergebnis = Trim(Quelle)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Der Text, bei dem die führenden und nachfolgenden Leerzeichen entfernt werden sollen |
| Ergebnis | text | Der Quelltext ohne führende und nachfolgende Leerzeichen |
Beschreibung
Die Trim-Funktion entfernt die führenden und nachfolgenden Leerzeichen des angegebenen Textes. Um nur die führenden oder nur die nachfolgenden Leerzeichen zu entfernen, müssen Sie die LTrim- bzw. die RTrim-Funktion verwenden.
Beispiel
Upper
Syntax
Ergebnis = Upper(Quelle)
Parameter | Datentyp | Beschreibung |
|---|---|---|
Quelle | text | Beliebiger Text |
| Ergebnis | text | Der Text der Quelle in Grossbuchstaben |
Beschreibung
Die Upper-Funktion gibt den angegebenen Text in Grossbuchstaben zurück. Um dagegen alle Zeichen kleinzuschreiben, müssen Sie die Lower-Funktion verwenden.
Beispiel
