# VerifyString

Die VerifyString-Funktion wird verwendet, um die Zeichenfolge zu überprüfen und die Ausgabe „Bestanden“/“Nicht bestanden“ zu generieren.

## VerifyString – Eingaben

Parameter | Beschreibung
Zeichenfolge | Gibt eine Textzeichenfolge oder eine Referenz auf eine Tabellenzelle an, die eine Textzeichenfolge enthält.
Feldzeichenfolge | Definiert die Anzahl der in der Zeichenfolge enthaltenen Zeichen und bietet Informationen darüber, welche Zeichen an den verschiedenen Positionen in der Zeichenfolge erwartet werden.
Felddefinitionen | Die Einstellungen für die Felddefinitionen können optional verwendet werden, um benutzerdefinierte Einträge für die Feldzeichenfolge zu erstellen. Wenn diese Einträge in der Feldzeichenfolge enthalten sind, dann schränken sie die Liste mit gültigen Zeichen an den Positionen ein, an denen sie eingefügt werden.

### Feldzeichenfolge

Ein Eintrag für die Feldzeichenfolge kann ein beliebiges alphanumerisches Zeichen sein, einschließlich (A bis Z), (a bis z), (0 bis 9), Bindestriche (-), Punkte (.) und Leerzeichen ( ).

Jedes Zeichen in der Feldzeichenfolge entspricht einer indizierten Feldposition. Die Feldzeichenfolge muss mindestens die gleiche Anzahl von Positionen beinhalten, die der Anzahl der Zeichen in der Zeichenfolge entspricht, damit die Zeichenfolgenüberprüfung erfolgreich verläuft. Wenn also 10 Zeichen vorhanden sind, die Feldzeichenfolge jedoch nur 9 Zeichen vorgibt, werden die 9 mit der größten Übereinstimmung zurückgegeben. Falls jedoch 8 Zeichen vorhanden sind und die Feldzeichenfolge 9 vorgibt, gibt die Funktion #ERR aus. Standardmäßig wird jede Position in der Feldzeichenfolge als Sternchen (*) oder alphanumerischer Platzhalter dargestellt. Das bedeutet, dass jedes Zeichen an jeder Position der Zeichenfolge gültig ist.

Die vordefinierten Einträge für die Feldzeichenfolge lauten:

Feldzeichenfolge – Eintrag | Beschreibung | Gültige Zeichen
* | Platzhalter | Beliebiges trainiertes Zeichen im Zeichensatz.
N | Ziffern | 0123456789
A | Großbuchstaben | ABCDEFGHIJKLMNOPQRSTUVWXYZ
a | Kleinbuchstaben | abcdefghijklmnopqrstuvwxyz
H | Hexadezimalzeichen, Großbuchstaben und Ziffern | 0123456789ABCDEF
h | Hexadezimalzeichen, Kleinbuchstaben und Ziffern | 0123456789abcdef
O | Oktal | 01234567

Beispiele für Feldzeichenfolgen:

- Beispiel 1: Lautet die Feldzeichenfolge **********AN, ist an den ersten 10 Zeichenfolgepositionen jedes Zeichen im Zeichensatz gültig. An der 11. Position werden jedoch bei der Verifizierung nur Großbuchstaben berücksichtigt. Und an der 12. Position werden nur numerische Zeichen berücksichtigt.

- Beispiel 2: Der Zeichensatz enthält nur die numerischen Zeichen 0 — 9 und /. Lautet die Feldzeichenfolge NN/NN/NN, werden an der ersten und zweiten, vierten und fünften sowie siebten und achten Position nur numerische Zeichen berücksichtigt. An der dritten und sechsten Position wird nur der Schrägstrich (/) berücksichtigt.

  Lautet der Zeichenbereich jedoch NN/NN/AA, wird beim Überprüfen der Zeichenfolge eine Fehlermeldung ausgegeben, da der Zeichensatz keine Alphazeichen enthält.

### Felddefinitionen

Die Einstellungen für die Felddefinitionen können optional auch dazu verwendet werden, benutzerdefinierte Einträge für die Feldzeichenfolge zu erstellen. Wenn diese Einträge in der Feldzeichenfolge enthalten sind, dann schränken sie die Liste mit gültigen Zeichen an den Positionen ein, an denen sie eingefügt werden.

Sie können die vordefinierten Definitionen überschreiben, indem Sie eine neue Definition zu diesem Feld hinzufügen. Wenn beispielsweise der Wert der Felddefinition A=A ist, wird nur das Zeichen A als gültiges Zeichen berücksichtigt, da die Felddefinition A=A den vordefinierten Eintrag für die Feldzeichenfolge überschreibt.

Beispiele für Felddefinitionen:

- Beispiel 1: Lautet der Wert von Felddefinitionen #=123;$=3456;%=789 und die Feldzeichenfolge #$%*******, sind an der ersten Position nur die Zeichen 1, 2 oder 3 gültig. An der zweiten Position sind nur die Zeichen 3, 4, 5 oder 6 gültig. An der dritten Position sind nur 7, 8 oder 9 gültig. An den Positionen vier bis zehn sind alle Zeichen im Zeichensatz gültig.
- Beispiel 2: Lautet der Wert von Felddefinitionen #=123;$=3456;%=789, A=A und die Feldzeichenfolge #$%******A, sind an der ersten Position nur die Zeichen 1, 2 oder 3 gültig. An der zweiten Position sind nur die Zeichen 3, 4, 5 oder 6 gültig. An der dritten Position sind nur 7, 8 oder 9 gültig. An den Positionen vier bis neun sind alle Zeichen im Zeichensatz gültig. An der zehnten Position wird nur das Zeichen A berücksichtigt, da die Felddefinition A=A den vordefinierten Eintrag für die Feldzeichenfolge erneut zuordnet.

## VerifyString – Ausgaben

Rückgabewert | Der Status „Bestanden“/“Nicht bestanden“ der Zeichenfolge in der referenzierten Text-Datenstruktur oder #ERR, wenn einer der Eingabeparameter ungültig ist. 0 = Fehlgeschlagen 1 = Bestanden