DefineExternal - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


ExternalCalling

  

DefineExternal

  

create a link to an external function

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

DefineExternal( fn, extlib )

DefineExternal( fn, extlib, cright )

Parameters

fn

-

string or name; denotes the name of the wrapper function to link

extlib

-

string or name; denotes the name of the external library containing the wrapper function

cright

-

(optional) string; denotes the copyright placed on the returned Maple procedure.

Description

• 

The DefineExternal(fn, extlib) command calls define_external with the MAPLE option and saves the result in a remember table.  The procedure used to prepare the invocation of the external routine fn is returned, optionally with the specified copyright statement cright.

  

Note: Saving the result of DefineExternal in a remember table is essential for the efficient operation of the external linking. Without it, the external communications must be set up every time an external routine is entered.

Examples

withExternalCalling:

extlibExternalLibraryNamemstring

extliblibmstring.so

(1)

extcallDefineExternalmstring_uppercase,extlib

extcallprocoptioncall_external,define_externalmstring_uppercase,MAPLE,LIB=libmstring.so;call_external0,140327475850880,true,false,false,argsend proc

(2)

extcallDefineExternalmstring_uppercase,extlib,Copyright (c) 2001, ...

extcallprocoptioncall_external,define_externalmstring_uppercase,MAPLE,LIB=libmstring.so,COPYRIGHT=Copyright (c) 2001, ...,copyright=Copyright (c) 2001, ...;call_external0,140327475850880,true,false,false,argsend proc

(3)

See Also

CustomWrapper

define_external

external_calling

ExternalCalling

ExternalCalling[ExternalLibraryName]