Funzioni stringa (Visual Basic)

Articolo
04/08/2023

Nella tabella seguente sono elencate le funzioni fornite da Visual Basic nella classe Microsoft.VisualBasic.Strings per cercare e modificare le stringhe. Possono essere considerate funzioni intrinseche di Visual Basic; ovvero non è necessario chiamarle come membri espliciti di una classe, come mostrano gli esempi. Nella classe System.String sono disponibili metodi aggiuntivi e, in alcuni casi, metodi complementari.

Metodo .NET Framework	Descrizione
Asc, AscW	Restituisce un valore `Integer` che rappresenta il codice corrispondente a un carattere.
Chr, ChrW	Restituisce il carattere associato al codice carattere specificato.
Filter	Restituisce una matrice con indice in base zero che contiene un sottoinsieme di una matrice `String` definito in base ai criteri di filtro specificati.
Format	Restituisce una stringa formattata in base alle istruzioni contenute in un'espressione `String` di formato.
FormatCurrency	Restituisce un'espressione nel formato valore di valuta utilizzando il simbolo di valuta impostato nel Pannello di controllo del sistema.
FormatDateTime	Restituisce un'espressione stringa che rappresenta un valore data/ora.
FormatNumber	Restituisce un'espressione in formato di numero.
FormatPercent	Restituisce un'espressione formattata come percentuale (ovvero moltiplicata per 100) con un carattere % finale.
InStr	Restituisce un Integer che specifica la posizione di inizio della prima occorrenza di una stringa in un'altra.
InStrRev	Restituisce la posizione della prima occorrenza di una stringa inclusa in un'altra a partire dalla destra della stringa.
Join	Restituisce una stringa creata unendo un certo numero di sottostringhe di una matrice.
LCase	Restituisce una stringa o un carattere convertito in minuscolo.
Left	Restituisce una stringa contenente un numero specificato di caratteri a partire dal lato sinistro di una stringa.
Len	Restituisce un numero intero che contiene il numero di caratteri in una stringa.
LSet	Restituisce una stringa allineata a sinistra contenente la stringa specificata adeguata alla lunghezza specificata.
LTrim	Restituisce una stringa contenente una copia di una stringa specificata senza spazi iniziali.
Mid	Restituisce una stringa contenente un numero specificato di caratteri di una stringa.
Replace	Restituisce una stringa nella quale la substring specificata è stata sostituita con un'altra sottostringa per il numero di volte indicato.
Right	Restituisce una stringa contenente un numero di caratteri specificato a partire dalla destra della stringa.
RSet	Restituisce una stringa allineata a destra contenente la stringa specificata adattata alla lunghezza specificata.
RTrim	Restituisce una stringa contenente una copia di una stringa specificata senza spazi finali.
Space	Restituisce una stringa composta dal numero di spazi specificato.
Split	Restituisce una matrice unidimensionale con indice in base zero che contiene il numero di sottostringhe specificato.
StrComp	Restituisce -1, 0 o 1 in base al risultato di un confronto tra stringhe.
StrConv	Restituisce una stringa convertita come specificato.
StrDup	Restituisce una stringa o un oggetto composto dal carattere specificato ripetuto per il numero di volte specificato.
StrReverse	Restituisce una stringa nella quale è stato invertito l'ordine dei caratteri della stringa specificata.
Trim	Restituisce una stringa contenente una copia di una stringa specificata senza spazi iniziali o finali.
UCase	Restituisce una stringa o un carattere contenente la stringa specificata convertita in lettere maiuscole.

È possibile usare l'istruzione Option Compare per impostare se le stringhe vengono confrontate usando un ordinamento di testo senza distinzione tra maiuscole e minuscole determinato dalle impostazioni locali del sistema (Text) o dalle rappresentazioni binarie interne dei caratteri (Binary). Il metodo di confronto del testo predefinito è Binary.

Esempio: UCase

Nell'esempio seguente la funzione UCase viene utilizzata per restituire una versione in lettere maiuscole di una stringa.

' String to convert.
Dim lowerCase As String = "Hello World 1234"
' Returns "HELLO WORLD 1234".
Dim upperCase As String = UCase(lowerCase)

Esempio: LTrim

In questo esempio vengono utilizzate la funzione LTrim per rimuovere gli spazi iniziali e la funzione RTrim per rimuovere gli spazi finali da una variabile String. Viene utilizzata la funzione Trim per eliminare entrambi i tipi di spazi.

' Initializes string.
Dim testString As String = "  <-Trim->  "
Dim trimString As String
' Returns "<-Trim->  ".
trimString = LTrim(testString)
' Returns "  <-Trim->".
trimString = RTrim(testString)
' Returns "<-Trim->".
trimString = LTrim(RTrim(testString))
' Using the Trim function alone achieves the same result.
' Returns "<-Trim->".
trimString = Trim(testString)

Esempio: Mid

In questo esempio viene utilizzata la funzione Mid per restituire un numero specificato di caratteri da una stringa.

' Creates text string.
Dim testString As String = "Mid Function Demo"
' Returns "Mid".
Dim firstWord As String = Mid(testString, 1, 3)
' Returns "Demo".
Dim lastWord As String = Mid(testString, 14, 4)
' Returns "Function Demo".
Dim midWords As String = Mid(testString, 5)

Esempio: Len

Nell'esempio riportato di seguito la funzione Len viene utilizzata per restituire il numero di caratteri di una stringa.

' Initializes variable.
Dim testString As String = "Hello World"
' Returns 11.
Dim testLen As Integer = Len(testString)

Esempio: InStr

Nell'esempio riportato di seguito la funzione InStr viene utilizzata per restituire la posizione della prima occorrenza di una stringa in un'altra.

' 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")

Esempio: Formato

In questo esempio sono presentati vari utilizzi della funzione Format per formattare valori mediante formati sia di tipo String che definiti dall'utente. Per quanto riguarda il separatore della data (/), dell'ora (:) e gli indicatori AM/PM (t e tt), l'output formattato visualizzato dal sistema dipende dalle impostazioni locali utilizzate per il codice. Nell'ambiente di sviluppo la data e l'ora vengono visualizzate nel formato breve delle impostazioni locali.

Nota

Per le impostazioni locali che utilizzano il formato 24 ore, gli indicatori AM/PM (t e tt) non visualizzano alcun output.

Dim testDateTime As Date = #1/27/2001 5:04:23 PM#
Dim testStr As String
' Returns current system time in the system-defined long time format.
testStr = Format(Now(), "Long Time")
' Returns current system date in the system-defined long date format.
testStr = Format(Now(), "Long Date")
' Also returns current system date in the system-defined long date 
' format, using the single letter code for the format.
testStr = Format(Now(), "D")

' Returns the value of testDateTime in user-defined date/time formats.
' Returns "5:4:23".
testStr = Format(testDateTime, "h:m:s")
' Returns "05:04:23 PM".
testStr = Format(testDateTime, "hh:mm:ss tt")
' Returns "Saturday, Jan 27 2001".
testStr = Format(testDateTime, "dddd, MMM d yyyy")
' Returns "17:04:23".
testStr = Format(testDateTime, "HH:mm:ss")
' Returns "23".
testStr = Format(23)

' User-defined numeric formats.
' Returns "5,459.40".
testStr = Format(5459.4, "##,##0.00")
' Returns "334.90".
testStr = Format(334.9, "###0.00")
' Returns "500.00%".
testStr = Format(5, "0.00%")