Appeler Fortran depuis C++¶
Apprendre Fortran · API GaspardOS complète depuis Fortran
La toolchain GaspardOS x64 fournit GCC 4.6.4, les compilateurs C++ et
Fortran ainsi que les bibliothèques statiques libstdc++ et libgfortran.
Cette page montre comment appeler une routine de calcul Fortran depuis un
programme C++98, avec une interface C commune aux deux langages.
Interface et types¶
Déclarer la routine Fortran avec bind(C, name="...") et sa déclaration
C++ avec extern "C" pour fixer le nom du symbole et éviter le décorateur
de noms C++. Utiliser les types de iso_c_binding :
| Fortran | C++ | Passage |
|---|---|---|
integer(c_int), value |
int |
Valeur |
real(c_double), value |
double |
Valeur |
real(c_double) |
double* |
Adresse d'un scalaire |
real(c_double) :: x(*) |
double* |
Adresse du premier élément |
Sans value, un scalaire interopérable est passé par adresse. intent(in)
et intent(inout) précisent l'utilisation des données ; ils ne changent
pas le mode de passage.
Exemple complet¶
Enregistrer ce code dans scale.f90. Il multiplie chaque élément par
un coefficient ; le tableau appartient au programme C++.
subroutine scale_values(n, factor, values) bind(C, name="scale_values")
use iso_c_binding, only: c_int, c_double
implicit none
integer(c_int), value, intent(in) :: n
real(c_double), value, intent(in) :: factor
real(c_double), intent(inout) :: values(*)
integer(c_int) :: i
do i = 1, n
values(i) = factor * values(i)
end do
end subroutine scale_values
Enregistrer le programme appelant dans main.cpp :
#include <cstdio>
extern "C" void scale_values(int n, double factor, double* values);
int main()
{
double values[] = {1.0, 2.0, 3.0};
scale_values(3, 2.0, values);
std::printf("%.1f %.1f %.1f\n", values[0], values[1], values[2]);
return 0;
}
Sortie attendue sous GaspardOS : 2.0 4.0 6.0.
Compiler depuis Windows / MSYS2¶
Après construction de la toolchain et de ses bibliothèques, depuis la racine du dépôt dans MSYS2 MINGW64, avec les deux fichiers à la racine :
export PATH="$PWD/build-x64-install/bin:$PATH"
x86_64-gaspardos-gfortran -Wall -Wextra -c scale.f90 -o scale.o
x86_64-gaspardos-g++ -std=gnu++98 -Wall -Wextra -c main.cpp -o main.o
x86_64-gaspardos-g++ main.o scale.o -lgfortran -lm -o cpp_fortran.elf
Le pilote C++ ajoute sa bibliothèque standard ; -lgfortran ajoute le
runtime Fortran et -lm les fonctions mathématiques. Placer les objets
avant les bibliothèques pour la liaison statique. Les deux compilateurs
doivent viser la même cible et utiliser le même SDK. Le résultat est un
ELF64 GaspardOS à copier sur le système cible, pas un exécutable Windows.
Tableaux et limites¶
- C++ commence normalement les indices à zéro ; dans cet exemple,
values(1)en Fortran désignevalues[0]en C++. - Fortran stocke les matrices par colonnes. Pour un tableau Fortran
a(rows, cols), l'élémenta(i, j)correspond au tampon C++ à l'indice(i - 1) + rows * (j - 1). - Fournir un tampon contigu contenant au moins
néléments valides et conserver sa durée de vie pendant l'appel. La routine ne vérifie pas sa taille. - Avec GCC 4.6.4, utiliser des tableaux de taille explicite ou
(*)pour cette interface C ; les tableaux à forme implicite(:)et les argumentsallocatablene conviennent pas à cette interface. - Ne pas passer directement
std::string,std::vector, des objets C++, des exceptions ou des chaînes Fortran à longueur implicite à travers cette frontière. Exposer des scalaires, des tampons et des tailles explicites.
Le port désactive OpenMP, les threads, les bibliothèques partagées et
libquadmath. Cet exemple utilise uniquement un calcul numérique ; les
entrées/sorties Fortran dépendent en plus du runtime et des services newlib
disponibles sur la cible.