Funzioni stringa (Visual Basic)
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%")
