Cコンパイラ	C++コンパイラ
	"Linux"	gcc (GCC) 4.4.6 20110731 (Red Hat 4.4.6-3)	g++ (GCC) 4.4.6 20110731 (Red Hat 4.4.6-3)
	"Linux-x86-64"	gcc (GCC) 4.4.6 20110731 (Red Hat 4.4.6-3)	g++ (GCC) 4.4.6 20110731 (Red Hat 4.4.6-3)

推奨されるインストール

CompilerAdditionsのインストール

WSTPExamplesのインストール

WSTPフレームワークコンポーネント

CompilerAdditionsディレクトリ

wstp.h

libWSTP32i4.a/libWSTP64i4.a

libWSTP32i4.so/libWSTP64i4.so

wsprep

wscc

WSTPExamplesディレクトリ

PrebuiltExamplesフォルダ

WSTPのテンプレートファイルを使う

wsprep  addtwo.tm  -o addtwotm.c

addtwotm.c  :  addtwo.tm
    wsprep  addtwo.tm  -o addtwotm.c

WSTPプログラムを構築する

make addtwo

Makefileを使う

# This makefile can be used to build all or some of the sample
# programs. To build all of them, use the command
# 'make all'. To build one, say addtwo, use the command
# 'make addtwo'.

WSTPLINKDIR = /usr/local/Wolfram/Mathematica/10.0/SystemFiles/Links/WSTP/DeveloperKit
SYS = Linux  # Set this value with the result of evaluating $SystemID
CADDSDIR = ${WSTPLINKDIR}/${SYS}/CompilerAdditions

INCDIR = ${CADDSDIR}
LIBDIR = ${CADDSDIR}

EXTRALIBS = -lm -lpthread -lrt -lstdc++ -ldl -libuuid # Set these with appropriate libs for your system.
WSTPLIB = WSTP32i4 # Set this to WSTP64i4 if using a 64-bit system

WSPREP = ${CADDSDIR}/wsprep

all : addtwo bitops counter factor factor2 factor3 quotient reverse sumalist

addtwo : addtwotm.o addtwo.o
    ${CC} -I${INCDIR} addtwotm.o addtwo.o -L${LIBDIR} -l${WSTPLIB} ${EXTRALIBS} -o $@

bitops : bitopstm.o bitops.o
    ${CC} -I${INCDIR} bitopstm.o bitops.o -L${LIBDIR} -l${WSTPLIB} ${EXTRALIBS} -o $@

counter : countertm.o
    ${CC} -I${INCDIR} countertm.o -L${LIBDIR} -l${WSTPLIB} ${EXTRALIBS} -o $@

factor : factor.o
    ${CC} -I${INCDIR} factor.o -L${LIBDIR} -l${WSTPLIB} ${EXTRALIBS} -o $@

factor2 : factor2.o
    ${CC} -I${INCDIR} factor2.o -L${LIBDIR} -l${WSTPLIB} ${EXTRALIBS} -o $@

factor3 : factor3.o
    ${CC} -I${INCDIR} factor3.o -L${LIBDIR} -l${WSTPLIB} ${EXTRALIBS} -o $@

quotient : quotient.o
    ${CC} -I${INCDIR} quotient.o -L${LIBDIR} -l${WSTPLIB} ${EXTRALIBS} -o $@

reverse : reversetm.o
    ${CC} -I${INCDIR} reversetm.o -L${LIBDIR} -l${WSTPLIB} ${EXTRALIBS} -o $@

sumalist : sumalisttm.o sumalist.o
    ${CC} -I${INCDIR} sumalisttm.o sumalist.o -L${LIBDIR} -l${WSTPLIB} ${EXTRALIBS} -o $@

.c.o :
    ${CC} -c -I${INCDIR} $<

addtwotm.c : addtwo.tm
    ${WSPREP} $? -o $@

bitopstm.c : bitops.tm
    ${WSPREP} $? -o $@

countertm.c : counter.tm
    ${WSPREP} $? -o $@

reversetm.c : reverse.tm
    ${WSPREP} $? -o $@

sumalisttm.c : sumalist.tm
    ${WSPREP} $? -o $@

以下の表を使うと，使用中のシステム上でWSTPプログラムの接続に必要な追加のライブラリが判別できる．

wsccを使う

wscc addtwo.tm addtwo.c -o addtwo

Wolfram言語カーネルからすでに構築された例題を実行する

:Begin:
:Function:       addtwo
:Pattern:        AddTwo[i_Integer, j_Integer]
:Arguments:      { i, j }
:ArgumentTypes:  { Integer, Integer }
:ReturnType:     Integer
:End:

:Evaluate: AddTwo::usage = "AddTwo[x, y] gives the sum of two machine integers x and y."

int addtwo( int i, int j)
{
    return i+j;
}

int main(int argc; char* argv[])
{
    return WSMain(argc, argv);
}

すでに構築された例題内からWolfram言語カーネルを起動する

factor -linkmode launch -linkname 'math -wstp'

Integer to factor:

Integer to factor: 123456789
3 ^ 2
3607 ^ 1
3803 ^ 1

サポートされるリンクプロトコル

• プログラムが動作するまでコンパイラの最適化をオフにする．これによりコンパイラはより速く，デバッグはより簡単になる．その上最適化ツールが壊れている可能性や，問題の原因になっている可能性もある．最適化されたコードはスタックを使い，コードのバグを表示するか隠すかという点で最適化されていないコードとは違うように登録される．例えば，局所変数のポインタを返すというよくある間違いは，スタックおよび登録の使用によって問題を引き起すことも起こさないこともある．

• WSTPライブラリ関数からの戻り値をチェックするか，プログラムのキーポイントでWSError()を呼び出すかする．WSTPは通常，何が悪かったのかを知らせることができる．

• ファイルwstp.h，libWSTP32i4.a，libWSTP32i4.so（64ビットプラットフォームではlibWSTP64i4.*）はマッチした集合である．WSTPの前リリースを使っていた場合は，アプリケーションを構築する場合にコンポーネントを混同しないように注意する必要がある．

• 使用中のCコンパイラがプロトタイプをサポートするかどうかをチェックする．サポートしない場合，コードを変更したりプロジェクトの構築方法を変えたりする必要がある．これについては「WSTPプログラムを構築する」のセクションで説明してある．

• プログラムをlibstdc++と接続したことを確かめる．このような依存関係がないと，接続段階でバイナリの構築に失敗する．