Einführung

Die hier aufgelisteten Funktionen sind im MathLink Developer's Kit enthalten.

Diese Funktionen werden in der Datei mathlink.h deklariert, die normalerweise mit dem Quellcode jedes MathLink-kompatiblen Programmes ausgeliefert wird.

Die Funktionsdeklarationen werden Standard-C-Prototypen enthalten, es sei denn, es wird #define MLPROTOTYPES 0 vor #include "mathlink.h" spezifiziert.

Die folgenden Spezialtypen werden in mathlink.h definiert:

MLINK: ein MathLink-Link-Objekt (analog zu LinkObject in Mathematica)

MLMARK: eine Marke in einem MathLink-Strom

MLENV: MathLink-Bibliotheksumgebung

Die folgenden Konstanten werden eingerichtet, wenn eine MathLink-Schablonendatei verarbeitet wird:

MLINK stdlink: der Standard-Link, der ein mit MathLink-Schablonen erstelltes Programm mit Mathematica verbindet

MLENV stdenv: die Standard-MathLink-Umgebung in einem mit MathLink-Schablonen konstruierten Programm

Alle hier beschriebenen Funktionen sind in C geschriebene Funktionen. Sie können von anderen Programmiersprachen aus mit geeigneten Hüllen aufgerufen werden.

Die Funktionen haben folgende allgemeine Eigenschaften:

Jene, die int zurückgeben, liefern einen Wert ungleich Null, wenn sie erfolgreich sind, ansonsten geben sie 0 zurück und haben keine Wirkung.

In einem Programm, das mit MathLink-Schablonen erstellt wurde, heißt der Link zu Mathematica stdlink.

Funktionen, die Daten auf einem Link ablegen, geben von sich aus keinen Speicher frei, der zum Abspeichern der Daten verwendet wurde.

Funktionen, die Daten aus einem Link holen, dürfen Speicher zum Ablegen der Daten reservieren.

Funktionen, die Daten aus einem Link holen, kehren so lange nicht zurück, bis die erforderlichen Daten verfügbar werden. Eine Funktion, der MathLink die Kontrolle während des Wartens übergibt, kann registriert werden.