Skip to content

Appeler Fortran depuis C++

English

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ésigne values[0] en C++.
  • Fortran stocke les matrices par colonnes. Pour un tableau Fortran a(rows, cols), l'élément a(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 arguments allocatable ne 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.