MLGetAvailableLinkProtocolNames (C 関数)
MLGetAvailableLinkProtocolNamesはWSGetAvailableLinkProtocolNamesに置き換えられた.
int MLGetAvailableLinkProtocolNames( MLENV env , char *** p , int * l )
MathLink環境 env からインストールリンクプロトコールの名前を含む文字列のリストを得て,文字列を p に,そして名前のリストの長さを l に保存する.
詳細

- MathLinkは現在SharedMemory,TCPIP,IntraProcess,Pipes,FileMap,TCPのリンクプロトコール名をサポートする.
- すべてのリンクプロトコールがすべてのプラットフォームで利用できるとは限らない.
-
プラットフォーム プロトコール Linux SharedMemory, TCPIP, Intraprocess, Pipes, TCP Windows SharedMemory, TCPIP, IntraProcess, FileMap, TCP OS X SharedMemory, TCPIP, IntraProcess, Pipes, TCP - MLGetAvailableLinkProtocolNames()は,メモリを割り当てて,MLReleaseLinkProtocolNames()を呼び出すことによって解放しなければならないプロトコール名のリストを保存する.MLGetAvailableLinkProtocolNames()がエラーを返す場合は,p の内容についてMLReleaseLinkProtocolNames()を呼び出してはならない.
- MLGetAvailableLinkProtocolNames()は,成功した場合には0を,失敗した場合には非零のエラーコードを返す.
- MLGetAvailableLinkProtocolNames()は,MathLinkヘッダファイルmathlink.hで宣言される.
例題
例 (1)
#include "mathlink.h"
int main()
{
MLENV env;
char **protocolNames;
int length;
int apiResult;
env = MLInitialize((MLEnvironmentParameter)0);
if(env == (MLENV)0)
{ /* Unable to create MathLink environment */ }
apiResult = MLGetAvailableLinkProtocolNames(env, &protocolNames, &length);
if(apiResult != 0)
{ /* Unable to retrieve link protocol names */ }
/* ... */
MLReleaseLinkProtocolNames(env, protocolNames, length);
MLDeinitialize(env);
}