4.1 En sortie :

Les tableaux ne sont pas échangeables simplement entre les deux applications (VBA ignore la construction sous forme de pointeurs du C). Pour pouvoir obtenir un résultat sous forme de tableau, il faut utiliser un objet spécifique de C++, COleSafeArray. Vous pouvez vous reporter à la documentation C++ pour en apprendre plus sur cette fonction. Rien ne parle mieux ici qu'un exemple !

La procédure c_passe_tableau prends un entier long i en paramètre, et renvoi un tableau 10*10 dont les cases sont remplies ici par i*(numéro de colonne).
Voici le code C :

VARIANT _stdcall c_passe_tableau(long i){
//Exemple de passage de tableau en sortie de fonction
COleSafeArray saRet ;
//Crée un objet COleSafeArray qui permet de placer un tableau dans un Variant
DWORD numElements[] = {10, 10} ; //Taille du tableau 10x10

//Création du safe-array
saRet.Create(VT_R8, 2, numElements) ;
//VT_R8 = données numériques sur 8 octets, dimension 2, taille = numElements (10*10)

//Initialisation avec des valeurs
long index[2] ;
//Tableau à deux éléments contenant pour l'un i et l'autre j pour pointer sur Aij
for(index[0]=0 ; index[0]<10 ; index[0]++) {
for(index[1]=0 ; index[1]<10 ; index[1]++) {
double val = index[1]*i ;
saRet.PutElement(index, val) ;
//Place la valeur pointée par val, ie val, dans la case repérée par index[0],index[1]
}
}

//Retourne le safe-array encapsulé dans le VARIANT
return saRet.Detach() ;
}

En VBA, on aura d'une part la déclaration :

Private Declare Function c_passe_tableau Lib "Manuel.dll" (ByVal i As Long) As Variant

Et la fonction appelante :

Function EXEMPLE() As Double
Dim donj As Variant
Dim k As Long
k = 5
donj = c_passe_tableau(k)
EXEMPLE = donj(1, 4)
End Function

Qui renvoie le contenu de la case (1,4).

4.2 En entrée :

La procédure est légèrement différente, mais utilise le même objet C++ ColeSafeArray et aussi un VARIANT du côté VBA. Le programme suivant calcul le test de Cramer Von Mise pour une loi uniforme :

double _stdcall c_cramer_uniforme(COleVariant Objet, long Elem){
//Cramer Von Mise pour la loi uniforme, prend le tableau et sa taille
COleSafeArray Arrey ; //cf. ci-dessus
double val=0, y = 0,a ;
long index[1] ;
Arrey.Attach(Objet) ;
a = Elem ;
if (a==0) exit(0) ;
for (index[0]=0 ;index[0]{
Arrey.GetElement(index,val) ;
y = y + ((index[0] + 0.5)/a - val)*((index[0] + 0.5)/a - val) ;
//Calcul du facteur
}
y = y + 1/(12 *a) ;
//Fait la somme
return y ;
}

Sous VBA, on a la déclaration :

Private Declare Function c_cramer_uniforme Lib "c :.dll" (ByVal plage As Variant, ByVal taille As Long) As Double

Puis l'appel :

Function CRAMER_UNIFORME2(plage As Range) As Double
'Méthode C++
Dim i, NBL As Integer
Dim z() As Double
Dim c As Range
NBL = plage.Rows.Count
If plage.Columns.Count <> 1 Then Exit Function 'Si plus d'une colonne, sort de la procédure
ReDim z(NBL) As Double
i = 0
For Each c In plage 'Parcourt la plage
z(i) = c.Value 'Affecte au tableau
i = i + 1
Next c
CRAMER_UNIFORME2 = c_cramer_uniforme(z, NBL) 'Appel de la DLL
End Function

5.1 Sous VBA :

Comme expliqué plus haut, VBA est un langage interprété, et a donc comme principal défaut sa lenteur d'exécution et comme principal avantage sa souplesse. En effet, notamment en terme de débogage, les possibilités offertes sont très nombreuses. Voici quelques points méritant d'être cités :

• La commande "Option Explicit" au début du code peut être utilisée pour obliger le programmeur à déclarer par un Dim ("Dim A As Double" par exemple) toutes les variables utilis ées. On évite ainsi des erreurs d'orthographe dans le nom de variable du type " tzmp " au lieu de " temp " dont les conséquences peuvent être très graves.
• Par défaut, les tableaux en VBA déclarés par "Dim t() As Double" et dimensionné par "Redim t(100)" sont indexés à partir de 0, comme en C. Pour d'évidentes raisons de compatibilité on gardera ce mode d'indexation, même si la commande "Option 1" permet de parcourir à partir de 1.
• Le débogage d'une macro se fait très simplement en pressant F8 tandis que le curseur se trouve dans la macro. Pour une fonction, on aura intérêt à créer une macro appelant la fonction en question, et de deboger la macro et donc la fonction.
• Le choix entre macro et fonction est généralement simple. Les macro ne seront utilisées que lorsqu'une sortie multiple est indispensable, c'est à dire que plusieurs cases doivent être modifiées en sortie. C'est le cas de la génération de suites aléatoires.
• On utilisera au maximum les fonctions intégrées sous Excel, car celles-ci sont généralement optimisées (comme pour le tri par exemple).
• Il sera plus intéressant de parcourir des cellules grâce à une commande du type "For Each Cellule in Plage" (avec Cellule étant un objet Range et Plage la plage de données consid érées) que d'utiliser une vraie boucle du type "For i = 1 to N". On fera notamment le choix de la première méthode pour l'affectation des valeurs dans un tableau.
• Dans le cadre d'une fonction, les cellules de la feuille ne sont pas modifiables (sauf celle qui prend le résultat de la fonction et qui contient en fait l'appel).
• Une méthode d'affectation directe de tableau à plage existe pour les macros. Il s'agit de la commande Plage.Value = t, où t est le tableau. Les plages sont remplies en fonction de leur dimension de haut en bas et de gauche à droite. Cette procédure est vraiment optimisée. La réciproque n'existe apparemment pas.

5.2 Sous C++ :

• Un des points les plus délicats en C/C++ est la gestion des tableaux. Etant donné la consommation mémoire de certaines fonctions, notamment celles de test sur les pseudo-aléatoires, il faut veiller à bien allouer et désallouer les ressources. L'allocation se fait par la commande new, sur une variable déjà définie. Rien ne différencie au premier abord un pointeur sur une case mémoire d'un tableau, si ce n'est l'allocation mémoire. La taille du tableau pourra être fixée de manière dynamique, en fonction des variables définies à ce moment.
• Les opérations sont liées aux types de données intervenant dans le calcul. Ainsi, selon le type entier ou non de A et B, C=A/B donnera pour C le quotient entier ou bien le quotient réel. On devra parfois, si l'on veut obtenir le quotient réel de deux variables définies comme entières, forcer la conversion en réel, par exemple en multipliant A/B par 1.0, soit C=1.0*A/B.
• L'option _stdcall dans la déclaration de la fonction est indispensable pour que cette fonction soit visible pour le VBA.
• Trois niveaux de procédures ont été implémentés pour les générateurs. Le premier niveau est celui d'un élément seul, le deuxième est celui des vecteurs et le dernier celui des matrices.
• La fonction Rand() du C++ renvoie un entier de 0 à RAND_MAX (constante du langage). Donc, pour obtenir un réel entre 0 et 1 (1 exclu) on utilisera rand()/(RAND_MAX+1.0).
• Pour des raisons de précisions, le type de donner _int64 a été utilisé. Les entiers sont alors représentés sur 64 bits, ce qui permet de faire fonctionner correctement les formules de récurrences des gros générateurs LCG. Une alternative pourrait être de prendre des réels avec grosses précisions, mais des erreurs d'approximations pourrait alors être commises.
• Bien évidemment, on aura intérêt à calculer le maximum de paramètres à l'extérieur de la boucle. Si le programme en perd de la clarté, dans le cadre de simulations, les contraintes de temps rendent ces séparations indispensables.
• Des Long peuvent être utilisé comme booléen (0=False, 1=True), car ce type n'est pas géré.

6.1 Mise en place de l'aide ?

• Ouvrir Word et Help Workshop (ver. 4.3 ou ultérieures)
• Sous H.W. créé un nouveau Projet et sauvegarder le dans un répertoire sous, par exemple, le nom manuel (.hpj, extension par défaut)
• Les options par défaut sont appliquées.
• Sous Word, créé un nouveau fichier, vide, et sauvegarder le sous le format RTF, par exemple manuel.rtf. Ce fichier contiendra le texte de l'aide, garder le ouvert.
• Dans HW, cliquer sur Files, puis Add et sélectionner le fichier RTF créé précédemment (manuel.rtf).
• Dans HW, créer un nouveau fichier, du type Contents. Donner lui un nom (par exemple, manuel.cnt) et un titre, puis sauvegarder le (vide).
• Revenir à la fenêtre du Projet sous HW. Faire Options, Files, et dans la case Contents File donner le fichier créé. Vous pouvez maintenant sauvegarder le fichier Projet, sans le fermer. Les trois fichiers ont été créés et liés, il suffit maintenant de les remplir.

6.2 Le Texte :

• Dans le fichier RTF, chaque topic est séparé par un saut manuel de page. Le texte sera reproduit dans l'aide avec le même format (police, couleur) que dans le fichier RTF. Vous pouvez donc donner au texte l'apparence que vous voulez.
• Vous pouvez par exemple créer un premier topic appelé Introduction. Rentrer le texte, avec le titre, comme si vous rédigiez directement la page d'aide. Une fois terminée, le topic doit être référencé.
• Pour cela, il faut lui donner un Id, un titre et éventuellement des Keywords. Le système général est d'utiliser une note en bas de page, dont le caractère de renvoi indiquera le type de référence et dont le texte de la note elle-même donnera le contenu. Pour indiquer le Id du topic, dans le document RTF, devant le titre, faire Insertion/Note puis rentrer dans la case du caractère de renvoi le signe #. Dans la note en bas de page qui s'ouvre, taper les quelques caractères qui identifieront le topic. La même procédure est à suivre pour rentrer le titre en référence (en plus de l'avoir écrit dans le texte lui-même), si ce n'est qu'au lieu du caractère #, on utilisera $. Enfin, les Keywords concernant le topic sont à rentrer de la même manière, avec le caractère K au lieu du #. On les rentrera sur une même ligne, séparés par des points virgules en veillant à ce que Word ne rajoute pas de caractère " vide " avant le point virgule (ce qu'il fera par défaut).

6.3 Les liens :

• Une fois le fichier RTF sauvegardé, avec par exemple le topic Introduction, dont l'ID est "intro" le titre "Introduction" et les keywords "Démarrage ;Présentation", on peut passer au linkage.
• Liens dans le sommaire : Le fichier sommaire (cnt) décrit le sommaire qui sera présenté lors de la consultation de l'aide. On donnera donc à ce sommaire l'allure que l'on désire (avec les "headers" que l'on voudra), la seule contrainte étant de lier chaque Topic créé dans le sommaire à un topic existant dans le fichier RTF. Par exemple, on pourra avec la commande Add Below rajouter un header "Général", puis ensuite ajouter un topic "Introduction" avec comme topic Id "intro" (comme défini ci-dessus).
• A l'intérieur du fichier RTF, on peut créer des liens vers un autre topic. Deux méthodes coexistent pour l'appel, l'une ouvrant le topic appelé à la place du précédent, l'autre ouvrant une fenêtre Pop-up. Le lien est composé de deux parties, le texte du lien (en vert souligné) et l'ID du topic cible. Dans le cas d'une fenêtre pop-up, le texte sera formaté en Souligné, dans le cas normal en Double Souligné (Format Police Soulignement =>double). Puis, collé sans espace au texte, on écrira l'Id du topic cible en format Masqué. Par exemple : On pourra consulter l'Introductionintro (intro doit être ici écrit en masqué, mais bien évidemment, pour des raisons de lisibilité, on l'a écrit en Empreinte).
• Les Keywords apparaissant dans le fichier RTF seront automatiquement incorporés à l'index, et si plusieurs occurrences existent, une liste de choix avec le nom des topics concernés comme définis dans le fichier RTF apparaîtra.
• Pour lier à partir d'une application, un Id numérique est nécessaire. Par exemple, dans Excel, sous VBA, il est possible dans l'explorateur d'objet de définir pour le projet un fichier d'aide et pour chaque fonction un id numérique appelé contexte. Pour que l'appel se fasse, il faut dans le projet définir des correspondances. Pour cela, il suffit de cliquer le bouton Map (dans le projet sous HW), et de faire correspondre à chaque topic un id numérique.
• Pour lancer la compilation, ne pas oublier de sauvegarder tous les fichiers avant (ce n'est pas automatique sous HW).