# Zeichenfolge-Funktionen

Diese Funktionen bearbeiten Zeichenfolgen.

Hinweis:

- Indexwerte basieren auf Null. Mit anderen Worten hat das erste Zeichen der Zeichenfolge den Index 0, das zweite Zeichen Index 1, und so weiter.
- Textzeichenfolgen, die ein Zeichen breiter sind als die Zeichenbreite, werden manchmal abgeschnitten. Das Erhöhen der Spaltenbreite oder wenn man der Zeichenfolge ein Leerzeichen zufügt, wird die Zeichenfolge in ihrer Ganzheit angezeigt.

- Zeichenfolge-Funktionen können bei Zeichenfolgen aus Unicode-Zeichen verwendet werden.

Funktion | Beschreibung
Code (Text, [Index]) | Gibt den Ganzzahlwert zurück, der dem Unicode-Codepunkt für das Zeichen am angegebenen Index entspricht. Wenn kein Index angegeben ist, wird der Code des ersten Zeichens zurückgegeben. Gibt Null zurück, wenn die Zeichenfolge leer ist oder der Index jenseits des Endes der Zeichenfolge liegt. Unicode-Codepunkte sind für die ersten 127 Zeichen mit ASCII identisch, es wird jedoch der gesamte Unicode-Bereich von dieser Funktion unterstützt. Code-Beispiel Wenn Zelle A2 eine alphanumerische Zeichenfolge „ABC123“ enthält, würde die Funktion Code(A2) den Wert 65.000 zurückgeben, da dies der ASCII-Code von „A“ ist.
Concatenate (Arg1, [Arg2, Arg3, ...]) | Gibt die Verkettung mehrerer alphanumerischen Textzeichenfolgen zurück. Zahlenwerte werden automatisch zu Text konvertiert. Concatenate – Beispiel Wenn Zelle A2 die alphanumerische Zeichenfolge „A1B1“, Zelle A3 die alphanumerische Zeichenfolge „C1D2“ und Zelle A4 die Fließpunktzahl 4.556 enthalten, würde die Funktion Concatenate(A2,A3,A4) „A1B1C1D24.556“ zurückgeben.
Exact (Text1, Text2) | Liefert 1, wenn Text1 und Text2 identisch sind, sonst 0. Hinweis: „Exact“ berücksichtigt Groß-/Kleinschreibung. Exact – Beispiel Wenn Zelle A2 die Zeichenfolge „ABC123“ und Zelle die Zeichenfolge „ABC1234“ beinhaltet, würde Exact(A2,A3) 0.000 liefern. Wenn Zelle A2 die Zeichenfolge „VISION“ und Zelle A3 die Zeichenfolge „VISION“ beinhaltet, würde Exact(A2,A3) 1.000 liefern.
Find (FindText, SrcText, [StartChar]) | Gibt die indizierte Position der Zeichenfolge FindText in der Zeichenfolge SrcText an. Hinweis: Find berücksichtigt Groß-/Kleinschreibung. Find Beispiele „FindText“ und „SrcText“ können Zellreferenzen oder eine Zeichenfolge sein, die direkt zu den Funktionsargumenten hinzugefügt wird. Zelle A2 enthält die Zeichenfolge „123“ und Zelle A3 die Zeichenfolge „ABC123“. Find(A2, A3) oder Find(&quot;123&quot;, A3) würde 3.000 die Indexposition „123“ in „ABC 123“ zurückgeben. StartChar ist ein optionales (ganzzahliges) Argument, das eine Indexposition innerhalb von „SrcText“ darstellt, an der die Suche beginnen soll. Find(A2,A3,2) würde an Indexposition 2 in „SrcText“ beginnen und den Indexwert zurückgeben 3.000. Wenn „FindText“ nicht gefunden wird, wird -1.00 zurückgegeben. Find(„XYZ“,A3) würde dann -1.000 zurückgeben.
FormatString (Format-Zeichenfolge, [Text oder Wert, ...]) | Liefert eine Textzeichenfolge, die anhand einer Formatzeichenkette gemäß „C“-Bibliothekstandard erstellt wird. FormatString unterstützt die meisten Formatzeichenkette-Parameter. Verwenden Sie das Dialogfeld „Zeichenfolge formatieren“ aus, um diese Funktion automatisch zu konfigurieren. Hinweis: Die manuelle Bearbeitung der FormatString-Funktion wird nicht empfohlen.
Left (Text, NumChars) | Liefert die in Anzahl angegebene Anzahl von am meisten links gelegenen Zeichen (NumChars) aus einer Textzeichenfolge. Left – Beispiel Wenn Zelle A2 eine alphanumerische Zeichenfolge „ABC123“ enthält, würde die Funktion Left(A2,2) den Wert „AB“ zurückgeben.
Len (Text) | Gibt die Anzahl der Zeichen (Bytes) einer Textzeichenfolge zurück. Len – Beispiel Wenn Zelle A2 eine alphanumerische Zeichenfolge „ABC123“ enthält, würde die Funktion Len(A2) den Ganzzahlwert 6.000 zurückgeben.
Lower (Text) | Liefert einen Text, in Kleinbuchstaben konvertiert. Lower Beispiel Wenn Zelle A2 die alphanumerische Zeichenfolge „ABC123“ enthält, würde die Funktion Left(A2) den Wert „abc123“ zurückgeben.
Mid (Text, StartChar, NumChars) | Gibt den Text beginnend bei der indizierten StartChar-Position in der alphanumerischen Zeichenfolge für die unter NumChars angegebenen Zeichenanzahl zurück. Mid Beispiele Wenn Zelle A2 eine alphanumerische Zeichenfolge „ABC123“ enthält, würde die Funktion Mid(A2,2,2) den Wert „C1“ zurückgeben.
Replace (SrcText, StartChar, NumChars, NewText) | Gibt SrcText, geändert durch NewText, zurück. „Ersetzen“ entfernt eine Reihe von Zeichen NumChars beginnend an der indizierten Position StartChar und fügt den Ersetzungstext ein NewText. Replace Beispiel Wenn Zelle A2 die Zeichenfolge „ABC123“ und Zelle A3 die Zeichenfolge „123“ beinhaltet, würde Replace(A2,0,3,A3) den Wert 0.000 liefern.
Right (Text, NumChars) | Gibt die in NumChars angegebene Anzahl von am meisten rechts gelegenen Zeichen aus einer Textzeichenfolge. Right Beispiele Wenn Zelle A2 die Zeichenfolge „ABC123“ enthält würde Right(A2,2) die Zeichenfolge „23“ zurückgeben.
Stringf (Format-string, [Text oder Wert, ...]) | Liefert eine Textzeichenfolge, die anhand einer Formatzeichenkette gemäß „C“-Bibliothekstandard erstellt wird. Tipp: Die FormatString-Funktion unterstützt die meisten Formatzeichenketten-Parameter. Verwenden Sie das Dialogfeld Dialogfeld „Zeichenfolge formatieren“, um die Parameter automatisch zu konfigurieren. Hinweis: Die Formatzeichenkette muss in Anführungszeichen („...“) eingeschlossen werden. Beispiel: „Dies ist eine Zeichenfolge.“ Die Formatzeichenfolgen-Parameter berücksichtigen Groß-/Kleinschreibung. Beim Verwenden der Stringf-Funktion, wird Backslash (\) als Hinweis gebraucht, dass Formatierungszeichen folgt. Wenn auf einen Rückschräger kein Steuerungszeichen (wie „n“, „r“ oder „t“) folgt, wird das Zeichen nach dem Rückschräger eingefügt. Im einen einzelnen Rückschräger anzuzeigen, müssen zwei Rückschräger eingegeben werden. Beispiel: Stringf("C:\\InSight2\\") = „C:\InSight2\“ Nicht druckbare/Steuercode-Zeichen werden entweder als Symbol oder als „unbrauchbarer“ Text angezeigt. Verfügbare Format-String-Parameter:
%c | Gibt das Unicode-Zeichen zurück, das einem Ganzzahlwert entspricht. Stringf %c Beispiel Wenn Zelle A2 den Ganzzahlwert 65.000 enthält würde Stringf(„%c“,A2) das Zeichen „A“ zurückgeben, da dieses Zeichen dem ASCII-Code 65 entspricht. Die Funktion Stringf(„Wert = %c“,A2) würde die Zeichenfolge „Wert = A“ liefern.
%d | Gibt eine Zeichenfolge zurück, die einen Ganzzahlwert enthält. Stringf %d – Beispiele Wenn Zelle A2 den Fließpunktwert 123.456 enthält, würde Stringf(„%d“,A2) die numerische Zeichenfolge „123“ zurückgeben. Die Funktion Stringf(„Wert = %d“,A2) würde die alphanumerische Zeichenfolge „Wert = 123“ zurückgeben.
%e | Gibt eine Zeichenfolge zurück, die einen Wert in Exponentialschreibweise enthält. Die Anzahl der Dezimalstellen kann durch Einfügen eines Dezimalpunkts (.) und einer Nummer zwischen den Parametern „%“ und „e“ eingefügt werden. Stringf %e – Beispiele Wenn Zelle A2 den Fließpunktwert 123.456 enthält, würde Stringf(„%e“,A2) die numerische Zeichenfolge „1.234560e+02“ zurückgeben. Die Funktion Stringf(„%.1e“,A2) würde die numerische Zeichenfolge „1.2e+02“ zurückgeben, da nur eine Nummer nach dem Dezimalpunkt angegeben wurde.
%f | Gibt eine Zeichenfolge zurück, die einen Fließkommawert enthält. Die Anzahl der Dezimalstellen kann durch Einfügen eines Dezimalpunkts (.) und einer Zahl zwischen den Parametern „%“ und „f“ angegeben werden. Stringf %f – Beispiele Wenn Zelle A2 den Fließpunktwert 123.456 enthält, würde Stringf(„%e“,A2) die numerische Zeichenfolge „123.456001“ zurückgeben. Die Funktion Stringf(„%.1f“,A2) würde die numerische Zeichenfolge „123.5“ zurückgeben, da nur eine Nummer nach dem Dezimalpunkt angegeben wurde.
%o | Gibt eine Zeichenfolge zurück, die den Oktalwert einer Ganzzahl enthält. Stringf %o Beispiel Wenn Zelle A2 den Ganzzahlwert 123.000 enthält, würde Stringf(„%o“,A2) die numerische Zeichenfolge „173“ zurückgeben, was dem Oktalwert der Ganzzahl 123 entspricht.
%s | Gibt eine Zeichenfolge mit alphanumerischen Zeichen angehängt zurück. Stringf %s Beispiel Wenn Zelle A2 die Zeichenfolge „123ABC“ enthält, würde Stringf("%s123",A2) die alphanumerische Zeichenfolge „ABC123“ liefern. Wenn Zelle A2 die numerische Zeichenfolge „123“ enthält, würde Stringf("%s.450",A2) die numerische Zeichenfolge „123.450“ zurückgeben.
%u | Gibt eine Zeichenfolge zurück, die einen Ganzzahlwert ohne Vorzeichen enthält. Stringf %u – Beispiele Wenn Zelle A2 den Fließpunktwert 123.456 enthält, würde Stringf(„%u“,A2) die numerische Zeichenfolge „123“ zurückgeben. Die Funktion Stringf(„Wert = %u“,A2) würde die alphanumerische Zeichenfolge „Wert = 123“ zurückgeben.
%x or %X | Gibt eine Zeichenfolge zurück, die den Hexadezimalwert einer Ganzzahl enthält. Stringf %x Beispiel Wenn Zelle A2 den Ganzzahlwert 123.000 enthält, würde Stringf(„%x“,A2) die Zeichenfolge „7b“, den Hexadezimalwert für die Ganzzahl 123 zurückgeben.
%% | Gibt eine Zeichenfolge zurück, die ein einzelnes Prozentzeichen (%) enthält.
Die folgenden Format-String-Parameter werden vornehmlich für das Formatieren von Text (zum Beispiel, das Formatieren vom Text einer Email-Nachricht in der Funktion WriteSMTP verwendet):
\r | Fügt einen Wagenrücklauf in den Text ein. Dieser Parameter wird meist in Verbindung mit \n (Zeilenvorschub) verwendet.
\n | Fügt eine neue Zeile in den Text ein. Dieser Parameter wird meist in Verbindung mit \r (Wagenrücklauf) verwendet.
\\ | Fügt einen Backslash „\“ in den Text ein.
\t | Fügt einen Tabulator in den Text ein.
\v | Fügt einen vertikalen Tabulator in den Text ein.
\f | Fügt einen ASCII-Vorschub in den Text ein.
\x## | Fügt das durch die hexadezimale Zahl ## angegebene ASCII- oder Unicode-Zeichen in den Text ein. Stringf \x## – Beispiel Wenn Zelle A2 Stringf(„\x02123\x1bABC\x03456“) enthält, zeigt die Zelle Folgendes an: („<STX>123<ESC>ABC<ETX>456“).
\u#### | Fügt ein durch eine 16-Bit-Hexadezimalzahl #### angegebenes ASCII- oder Unicode-Zeichen in den Text ein.
Strtol (IntegerText) | Konvertiert die numerische Zeichen (dezimal, hexadezimal und oktal) am Anfang einer alphanumerischen Zeichenkette in eine Ganzzahl. Hexadezimalzeichen müssen mit „0x“ und Oktalzeichen müssen mit „0“ beginnen. Strtol Beispiele Dezimal: Wenn Zelle A2 die Textzeichenfolge „123ABC“ enthält, würde die Funktion Strtol(A2) den Ganzzahlwert 123.000 zurückgeben. Hexadezimal: Wenn Zelle A2 die Textzeichenfolge „0x123“ enthält, würde die Funktion Strtol(A2) den Ganzzahlwert 291.000 zurückgeben. „0x12AB“ = 4,779.000, da „A“ und „B“ hexadezimale Zeichen sind. „0x12GB“ = 18.000, da „G“ kein hexadezimales Zeichen ist. Oktal: Wenn Zelle A2 die Textzeichenfolge „0123ABC“ enthält, würde die Funktion Strtol(A2) den Ganzzahlwert 83.000 zurückgeben.
Substitute (SrcText, OldText, NewText, [Instanz]) | Gibt eine Zeichenfolge zurück, die durch das Ersetzen von NewText für jedes Auftreten von OldText durch SrcText. Optional kann eine Instanz angegeben werden, sodass nur diese im Text ersetzt wird. Substitute – Beispiel Wenn Zelle A2 die Textzeichenfolge „ABC123123“, Zelle A3 die Zeichenfolge „123“ und Zelle A4 die Zeichenfolge „abc“ enthält, ersetzt Substitute(A2,A3,A4,1) die zweite Instanz von „123“ in QuellText und gibt die Zeichenfolge „ABC123abc“ zurück.
Token (Text, Trennzeichen, Instanz) | Gibt den Text zurück, der sich an der angegebenen Instanz (Vorkommnis) einer Zeichenfolge mit Trennzeichen befindet. Das Trennzeichen muss in den Funktionsargumenten in doppelte Anführungszeichen („...“) gesetzt werden. Token – Beispiel Wenn Zelle A2 die Zeichenfolge mit Trennzeichen „A,B,C,1,2,3“ enthält, würde Token(A2,“,“,2) „C“ zurückgeben, da C sich im Text auf Index 2 befindet.
Trim (Text) | Entfernt führende und nachfolgende Leerzeichen aus Text, sodass zwischen den Wörtern jeweils nur ein einzelnes Leerzeichen steht (sofern vorhanden). Alle Steuerzeichen (Wagenrücklauf, Zeilenvorschub usw.) werden ebenfalls entfernt. Trim – Beispiel Wenn Zelle A2 die Zeichenfolge „ ABC 123 “ enthält, würde Trim(A2) die Zeichenfolge „ABC 123“ zurückgeben.
Upper (Text) | Liefert Text, bei dem alle Buchstaben in Großbuchstaben konvertiert sind. Upper Beispiel Wenn Zelle A2 die alphanumerische Zeichenfolge „ABC123“ enthält, würde die Funktion Upper(A2) den Wert „ABC123“ zurückgeben.
Value (NumericText) | Liefert den Fließpunktwert von Zahlentext. Ignoriert die nachfolgenden nichtnumerischen Zeichen. Value – Beispiel Wenn Zelle A2 die numerische Zeichenfolge „123.4“ enthält, würde die Funktion Value(A2) den Fließpunktwert 123.400 zurückgeben.