InStr-Funktion (Visual Basic)
Aktualisiert: November 2007
Gibt einen Integer-Wert zurück, der die Anfangsposition des ersten Auftretens einer Zeichenfolge innerhalb einer anderen Zeichenfolge angibt.
Public Shared Function InStr(_
ByVal String1 As String, _
ByVal String2 As String, _
Optional ByVal Compare As CompareMethod _
) As Integer
' -or-
Public Shared Function InStr(_
ByVal Start As Integer, _
ByVal String1 As String, _
ByVal String2 As String, _
Optional ByVal Compare As Microsoft.VisualBasic.CompareMethod _
) As Integer
Parameter
Start
Optional. Numerischer Ausdruck, der die Anfangsposition für jede Suche festlegt. Wird hierfür kein Wert angegeben, beginnt die Suche mit dem ersten Zeichen. Der Startindex beginnt mit dem Wert 1.String1
Erforderlich. String-Ausdruck, der durchsucht wird.String2
Erforderlich. String-Ausdruck, nach dem gesucht wird.Compare
Optional. Gibt den Typ des Zeichenfolgenvergleichs an. Wenn kein Wert für Compare angegeben wird, wird der Vergleichstyp durch die Option Compare-Einstellung festgelegt.
Einstellungen
Die Einstellungen für das Compare-Argument sind:
Konstante |
Wert |
Beschreibung |
|---|---|---|
Binary |
0 |
Führt einen binären Vergleich durch |
Text |
1 |
Führt einen Textvergleich durch. |
Rückgabewert
Voraussetzung |
Rückgabewert von InStr |
|---|---|
String1 ist eine Zeichenfolge mit der Länge 0 (null) oder Nothing |
0 |
String2 ist eine Zeichenfolge mit der Länge 0 (null) oder Nothing |
start |
String2 wird nicht gefunden |
0 |
String2 wird gefunden innerhalb von String1 |
Position, an der die gefundene Zeichenfolge beginnt |
Start > String2 |
0 |
Ausnahmen
Ausnahmetyp |
Fehlernummer |
Bedingung |
|---|---|---|
Start < 1. |
Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.
Hinweise
I. d. R. wird die InStr-Funktion beim Analysieren von Zeichenfolgen verwendet.
.gif "Hinweis") Hinweis: |
|---|
Die InStrB-Funktion aus früheren Versionen von Visual Basic gibt eine Reihe von Bytes zurück und keine Zeichenposition. Sie wird primär zum Konvertieren von Zeichenfolgen in DBCS (Double-Byte Character Set)-Anwendungen verwendet. Alle Visual Basic 2005-Zeichenfolgen haben das Unicode-Format, und InStrB wird nicht mehr unterstützt. |
Beispiel
In diesem Beispiel wird die InStr-Funktion verwendet, um die Position des ersten Auftretens einer Zeichenfolge innerhalb einer anderen Zeichenfolge zurückzugeben.
' String to search in.
Dim SearchString As String = "XXpXXpXXPXXP"
' Search for "P".
Dim SearchChar As String = "P"
Dim TestPos As Integer
' A textual comparison starting at position 4. Returns 6.
TestPos = InStr(4, SearchString, SearchChar, CompareMethod.Text)
' A binary comparison starting at position 1. Returns 9.
TestPos = InStr(1, SearchString, SearchChar, CompareMethod.Binary)
' If Option Compare is not set, or set to Binary, return 9.
' If Option Compare is set to Text, returns 3.
TestPos = InStr(SearchString, SearchChar)
' Returns 0.
TestPos = InStr(1, SearchString, "W")
Anforderungen
Namespace:Microsoft.VisualBasic
**Modul:**Strings
**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)
Siehe auch
Konzepte
Änderungen an der Unterstützung von Programmierelementen (Zusammenfassung)
Referenz
InStrRev-Funktion (Visual Basic)
StrComp-Funktion (Visual Basic)