Liste des fonctions VBA

Il existe un peu plus de 150 fonctions en Visual Basic. Même s'il vous est impossible de toutes les mémoriser, il est important de connaître leur existence ou tout du moins les grandes catégories de fonctions de manière à pouvoir orienter votre recherche.
En effet, il est particulièrement inutile de réinventer la roue et avant de vous lancer dans l'écriture d'un programme, vous devez vous demander si Visual Basic ne possède pas une fonction qui répond à votre besoin.
Pour prendre un exemple, si vous souhaitez extraire la racine carrée d'un nombre, ne tentez pas de rédiger une macro qui accomplisse cette tâche ; la fonction Sqr fera très bien l'affaire. Nous allons donc vous présenter différentes catégories de fonctions et quand vous aurez un besoin particulier, il vous faudra consulter ces listes afin de vérifier si une fonction convient à vos exigences.
Les tableaux listent les fonctions par catégorie et par ordre alphabétique, chaque nom de fonction étant accompagné d'une courte description. Si vous repérez une fonction qui est susceptible de vous intéresser, il faudra aller voir sa description complète dans l'aide en ligne.

Comme leur nom l'indique, les fonctions de chaîne travaillent sur des chaînes de caractères ; la plupart de ces fonctions s'emploient très souvent dans les programmes et il est par conséquent important de connaître les principales et notamment les fonctions suivantes :

Si vous fouillez dans l'aide en ligne, vous serez sans doute surpris de voir que certaines fonctions de chaîne sont doublées, comme Left et Left$ ou bien encore Mid et Mid$ ; apparemment, quand on examine les explications sur ces fonctions jumelles, on ne note aucune différence.
Et pourtant, elles existent et nous allons à cette occasion reparler des variables de type Variant. Vous vous souvenez peut-être que je vous avais dit que le type de données Variant était très souple et qu'il accomplissait une partie du travail à votre place.
Ce travail a bien évidemment un coût et ce que vous n'avez pas à faire, vous le payez en termes de performance. En fait, la différence entre Mid et Mid$ a trait au type de variable avec lequel la fonction va travailler : Mid travaille avec des données Variant et Mid$ travaille avec des données String. La belle affaire me direz-vous puisque cette distinction est totalement transparente pour vous. En réalité, elle ne l'est pas puisque la fonction Mid$ est dans certains cas presque deux fois plus rapide que son équivalent qui marche avec des variables Variant. Même si la programmation n'est pas votre activité principale et que vous n'avez aucun souci d'optimisation de votre code, il est important de comprendre ces différences et de pouvoir les évaluer. Nous allons voir dans l'exemple suivant qu'il est très facile de mettre en place une procédure de test de performance et vous verrez qu'un petit programme peut fournir des résultats significatifs :

Sub testperf1()
Dim boucle As Double
chaine = "  La femme des uns fait le bonheur des autres  "
depart = Timer 'déclenche le chrono
For boucle = 1 To 1000000
Dim x
x = Mid(chaine, 26, 7)
Next boucle
fin = Timer ' arrête le chrono
MsgBox (fin - depart)
' affiche le résultat en secondes
End Sub

Ce premier programme initialise une chaîne de caractères puis déclenche un compteur à l'aide de la fonction Timer qui renvoie une valeur représentant le nombre de secondes écoulées depuis minuit.
Une boucle est exécutée ensuite un million de fois. À l'intérieur de cette boucle, on initialise une variable qui est de type Variant étant donné qu'aucun type n'est déclaré et on réalise une opération sur une chaîne de caractères. À la fin de la boucle, on déclenche un deuxième chrono et on affiche la différence entre les deux chronos, c'est-à-dire le temps écoulé pendant le déroulement de la boucle.
Le deuxième programme de test est similaire sauf qu'on prend la peine de déclarer les variables chaîne en tant que String et qu'on utilise la fonction Mid$ :

Sub testperf2()
Dim chaine As String
Dim boucle As Double
chaine = "  La femme des uns fait le bonheur des autres  "
depart = Timer
For boucle = 1 To 1000000
Dim x As String
x = Mid$(chaine, 26, 7)
Next boucle
fin = Timer
MsgBox (fin - depart)
End Sub

Le tableau ci-dessous vous montre les résultats des tests effectués sur huit fonctions. La deuxième colonne indique le temps avec la fonction renvoyant une variable Variant et la troisième colonne indique le temps avec la fonction renvoyant une variable String. Les valeurs de temps sont exprimées en secondes.

Même s'il faut prendre ces mesures avec des pincettes, elles sont suffisamment significatives sur certaines fonctions pour que cela puisse avoir un impact dans certains programmes qui font un usage intensif du traitement des chaînes de caractères.
Ces deux petits programmes ont surtout un but pédagogique : ils vous montrent qu'il est aisé d'écrire une macro pour tester deux versions différentes d'un même programme. De plus, ils vous enseignent que la facilité fait finalement perdre du temps et qu'on a toujours intérêt à être le plus explicite possible dans un programme, car on gagne en temps et en lisibilité.

Les fonctions de date sont nombreuses en Visual Basic et de nombreux exemples sont disponibles dans la FAQ. Si vous avez à traiter des dates dans votre programme, il serait bien rare que vous ne trouviez pas dans cette liste une fonction qui réponde à vos besoins.

Certaines de ces fonctions sont très spécialisées (comme les fonctions trigonométriques) et ne vous serviront sans doute que très rarement. En revanche vous utiliserez souvent les fonctions Abs, Int, Round et Val.

D'autres fonctions plus complexes peuvent être dérivées des fonctions mathématiques de base. Vous en retrouverez la liste dans les pages sources Access.

Ces fonctions sont l'équivalent des fonctions financières que l'on trouve dans Excel (la troisième colonne du tableau indique d'ailleurs le nom correspondant Excel).
Si vous développez une macro avec Excel, il est sans doute préférable d'utiliser les fonctions internes d'Excel mais si vous devez faire du calcul financier dans un programme Word ou Access, il sera plus facile d'utiliser les fonctions de Visual Basic.

Ces fonctions permettent de manipuler des fichiers au sens large du terme et vous pouvez aussi bien obtenir le nom d'un fichier, connaître ses attributs, calculer sa longueur que le parcourir octet par octet. Cela étant, on préférera souvent une autre méthode pour manipuler des fichiers et notamment par le biais de l'objet FileSystemObject que nous étudierons plus tard.

Parmi toutes ces fonctions, vous utiliserez surtout la fonction Iif qui permet de faire un test conditionnel If Then sur une seule ligne et les fonctions IsEmpty et IsNull.

Exemple :

Dim sexe as string
sexe=IIF(civilite="Mr","Masculin","Féminin")

Les fonctions de conversion sont extrêmement importantes et elles seront bien souvent le seul remède pour ne pas commettre des erreurs de type.
Vous devez vous rappeler qu'il est en effet impossible de mélanger les types de données au sein d'une même expression ; si je souhaite, par exemple, afficher dans une boîte de dialogue le nom d'un étudiant suivi de sa moyenne générale aux examens, il faut que je fasse une conversion de la note puisque je n'ai pas le droit de mettre bout à bout une variable caractère et une variable numérique. Je vais donc employer une fonction de conversion qui va changer le type de la variable numérique en caractère.
Le programme suivant illustre cette technique :

Dim nometudiant As String
Dim moyenne As Double
nometudiant = "MARTIN"
moyenne = 12
' Erreur de type
' MsgBox (nometudiant + " : " + moyenne)
' Conversion donc pas d'erreur
MsgBox (nometudiant + " : " + CStr(moyenne))

Les fonctions de conversion convertissent une expression en un type de données spécifique. Leur syntaxe est la suivante :

Nom_de_fonction(expression)

L'argument expression peut être n'importe quelle expression de chaîne ou expression numérique et le nom de la fonction détermine le type renvoyé, comme le montre le tableau suivant

Si l'argument expression passé à la fonction excède la plage de valeurs du type de données cible, une erreur se produit. Il est donc préférable avant de réaliser une conversion de s'assurer qu'elle soit valide. Vous utiliserez pour ce faire des fonctions logiques comme par exemple la fonction IsDate pour déterminer si la valeur de l'argument date peut être convertie en date ou en heure.

La fonction CDate reconnaît les littéraux date et heure ainsi que certains nombres appartenant à la plage de dates autorisées. Lors de la conversion d'un nombre en date, la partie entière du nombre est convertie en date. Si le nombre comprend une partie décimale, celle-ci est convertie en heures exprimées en partant de minuit.
La fonction CDate reconnaît les formats de date définis dans les paramètres régionaux de votre système. L'ordre des jours, mois et années risque de ne pouvoir être défini si les données sont fournies dans un format différent des paramètres de date reconnus. De plus, les formats de date complets précisant le jour de la semaine ne sont pas reconnus. Il existe d'autres fonctions de conversion comme Str ou Val mais il vaut mieux utiliser les fonctions normalisées. Par exemple, la fonction Val ne respecte pas les conventions étrangères alors que la fonction CCur reconnaît divers types de séparateurs décimaux, de séparateurs des milliers et diverses options monétaires, selon les paramètres régionaux de votre ordinateur.

Ces fonctions donnent des renseignements sur l'état du système et vous en aurez rarement besoin, car certaines sont vraiment très spécialisées. La fonction VarType peut être intéressante pour bien comprendre le rôle des types de données.

Rappel : un tableau est une variable particulière qui peut contenir plusieurs valeurs ; chaque valeur du tableau s'appelle un élément et on accède à chaque élément par un numéro nommé indice.

De plus amples détails sur la programmation orientée objet sous VB sont disponibles dans le tutoriel de Xavier VLIEGHE.

Si on veut bien programmer, il faut être paranoïaque et prévoir le pire. Les fonctions de gestion d'erreur vous permettent de traiter préventivement les erreurs éventuelles qui peuvent se produire dans votre programme.

La fonction MsgBox est très simple d'utilisation. En revanche, il nous faut dire un mot de InputBox qui est aussi une fonction importante dans le cadre du dialogue homme-machine puisqu'elle permet de récupérer des informations saisies par l'utilisateur.
Il est très important de noter que la valeur renvoyée par InputBox est une variable String ce qui signifie que si vous faites saisir un nombre à un utilisateur, il faudra en principe le convertir, grâce à une fonction de conversion telle que CDbl, CInt ou CLng, en une variable numérique, même si Visual Basic n'est parfois pas très regardant.
La syntaxe de InputBox ressemble à celle de MsgBox :

InputBox(prompt[, title] [, default] [, xpos] [, ypos] [, helpfile, context])

Avec les arguments :

Pour votre gouverne, vous pouvez retenir qu'un twip est un 20^e de point et qu'un point est approximativement un 7^e de pouce qui, comme chacun le sait, mesure 2,54 centimètres. Visual Basic utilise les twips en interne pour la résolution de l'affichage et certains paramètres de fonctions doivent être exprimés dans cette mesure. Il n'y a pas malheureusement de correspondance directe entre les twips et les pixels, car les twips dépendent de la taille de la police qui peut varier d'un système à l'autre.