Funzione Len (Visual Basic)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Restituisce un valore integer corrispondente al numero di caratteri di una stringa oppure al numero nominale di byte necessari per memorizzare una variabile.

Public Shared Function Len( _
   ByVal Expression As { Boolean | Byte | SByte | Char | Double |
   Integer | UInteger | Long | ULong | Object | Short | UShort |
   Single | String | DateTime | Decimal } _
) As Integer

Parametri

Expression
Qualsiasi espressione String o nome di variabile valido. Se Expression è di tipo Object, la funzione Len restituirà la stessa dimensione scritta nel file dalla funzione FilePut.

Note

Se si utilizzano variabili Object e tipi definiti dall'utente, la funzione Len restituirà la stessa dimensione scritta nel file dalla funzione FilePut. Se una variabile Object contiene un valore String, verrà restituita la lunghezza della stringa. Se una variabile Object contiene un qualsiasi altro tipo, restituirà la dimensione dell'oggetto nel formato che verrà scritto nel file dalla funzione FilePut.

È possibile applicare l'attributo VBFixedString ai campi stringa negli oggetti per indicare le dimensioni della stringa in fase di scrittura su disco. La funzione Len utilizza l'attributo VBFixedString, se disponibile, per determinare le dimensioni delle variabili Object.

Nota:
La funzione Len potrebbe non essere in grado di determinare il numero effettivo di byte di archiviazione necessari quando viene utilizzata con stringhe di lunghezza variabile in tipi di dati definiti dall'utente.

Nota:
La funzione LenB delle versioni precedenti di Visual Basic restituisce il numero di byte in una stringa, anziché i caratteri Viene utilizzata soprattutto per la conversione di stringhe in applicazioni del set di caratteri a byte doppio (DBCS). Tutte le stringhe correnti di Visual Basic sono in Unicode e la funzione LenB non è più supportata.

Esempio

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)

Note per gli sviluppatori di applicazioni per Smart Device

La funzione Len accetta solo variabili String e Object come parametri. Se una variabile Object contiene un tipo String, verrà restituita la lunghezza di String. Se un parametro è un riferimento Object NULL, la funzione restituirà zero. Se una variabile Object contiene un qualsiasi altro tipo, verrà generata un'eccezione.