Funzione Filter (Visual Basic)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Restituisce una matrice con indice in base zero che contiene un sottoinsieme di una matrice String definito in base ai criteri di filtro specificati.

Function Filter(
   ByVal Source() As { Object | String },
   ByVal Match As String,
   Optional ByVal Include As Boolean = True,
   Optional ByVal Compare As CompareMethod = CompareMethod.Binary
)  As String()

Parametri

Source
Obbligatorio. Matrice unidimensionale di stringhe nella quale eseguire la ricerca.
Match
Obbligatorio. Stringa da cercare.
Include
Opzionale. Valore Boolean che indica se restituire sottostringhe in cui è incluso o escluso l'argomento Match. Se Include è True, la funzione Filter restituirà come sottostringa il sottoinsieme della matrice che contiene Match. Se Include è False, la funzione Filter restituirà come sottostringa il sottoinsieme della matrice che non contiene Match.
Compare
Facoltativo. Valore numerico che indica il tipo di confronto tra stringhe da utilizzare. I possibili valori sono indicati nella sezione "Impostazioni".

Impostazioni

Di seguito sono indicati i possibili valori dell'argomento Compare.

Costante	Descrizione
CompareMethod.Binary	Verrà eseguito un confronto binario.
CompareMethod.Text	Verrà eseguito un confronto testuale.

Eccezioni

Tipo di eccezione	Numero di errore	Condizione
ArgumentException	9	Source è Nothing oppure non è una matrice unidimensionale.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

Se non viene trovata alcuna corrispondenza di Match all'interno di Source, la funzione Filter restituirà una matrice vuota. Se Source è impostato su Nothing oppure non è una matrice unidimensionale, si verificherà un errore.

Nella matrice restituita dalla funzione Filter sono inclusi solo gli elementi necessari a contenere il numero di corrispondenze trovate.

Esempio

Nell'esempio riportato di seguito viene illustrato l'utilizzo della funzione Filter.

Dim TestStrings(2) As String
TestStrings(0) = "This"
TestStrings(1) = "Is"
TestStrings(2) = "It"
Dim subStrings() As String
' Returns ["This", "Is"].
subStrings = Filter(TestStrings, "is", True, CompareMethod.Text)
' Returns ["This"].
subStrings = Filter(TestStrings, "is", True, CompareMethod.Binary)
' Returns ["Is", "It"].
subStrings = Filter(TestStrings, "is", False, CompareMethod.Binary)