ExternalCalling
DefineExternal
create a link to an external function
Calling Sequence
Parameters
Description
Examples
DefineExternal( fn, extlib )
DefineExternal( fn, extlib, cright )
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.
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.
with⁡ExternalCalling:
extlib≔ExternalLibraryName⁡mstring
extlib≔libmstring.so
extcall≔DefineExternal⁡mstring_uppercase,extlib
extcall ≔ procoptioncall_external,define_external⁡mstring_uppercase,MAPLE,LIB=libmstring.so;call_external⁡0,140327475850880,true,false,false,argsend proc
extcall≔DefineExternal⁡mstring_uppercase,extlib,Copyright (c) 2001, ...
extcall ≔ procoptioncall_external,define_external⁡mstring_uppercase,MAPLE,LIB=libmstring.so,COPYRIGHT=Copyright (c) 2001, ...,copyright=Copyright (c) 2001, ...;call_external⁡0,140327475850880,true,false,false,argsend proc
See Also
CustomWrapper
define_external
external_calling
ExternalCalling[ExternalLibraryName]
Download Help Document