Len, fonction (Visual Basic)

Article
09/12/2008

Mise à jour : novembre 2007

Retourne un entier contenant le nombre de caractères contenus dans une chaîne ou le nombre nominal d'octets requis pour stocker une variable.

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

Paramètres

Expression
Toute expression String ou nom de variable valide. Si Expression est de type Object, la fonction Len retourne la taille telle qu'elle sera écrite dans le fichier par la fonction FilePut.

Notes

Avec les types définis par l'utilisateur et les variables Object, la fonction Len retourne la taille telle qu'elle sera écrite dans le fichier par la fonction FilePut. Si Object contient une String, il retourne la longueur de la chaîne. Si Object contient un autre type, il retournera la taille de l'objet lors de son écriture dans le fichier par la fonction FilePut.

L'attribut VBFixedString peut être appliqué aux champs de type chaîne dans les objets pour indiquer la taille de la chaîne, en octets, lors de l'écriture sur le disque. La fonction Len utilise l'attribut VBFixedString, s'il est disponible, pour déterminer la taille des variables Object.

Remarque :
La fonction Len ne peut peut-être pas déterminer le nombre réel d'octets de stockage requis si elle est utilisée avec des chaînes de longueur variable dans des types de données définis par l'utilisateur.

Remarque :
Dans les précédentes versions de Visual Basic, la fonction LenB retourne le nombre d'octets dans une chaîne plutôt que des caractères. Son rôle est d'abord de convertir des chaînes en applications à jeu de caractères codés sur deux octets (DBCS, Double-Byte Character Set). Toutes les chaînes Visual Basic en cours sont en Unicode et la fonction LenB n'est plus prise en charge.

Exemple

L'exemple suivant utilise la fonction Len pour retourner le nombre de caractères d'une chaîne.

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

Notes du développeur sur Smart Device

La fonction Len n'accepte que des variables String et Object comme paramètres. Si un Object contient une variable String, il retournera la longueur de la chaîne. Si un paramètre est une référence Object NULL, la fonction retourne zéro. Si un Object contient un autre type, une exception est levée.