When the WRAPPER option is used with define_external, a C file is created, compiled and linked into Maple.  This new library, called a wrapper library, contains the code necessary to translate Maple data types into data types recognized by C programs.

A C compiler is required to use this feature.  See COMPILE_OPTIONS for a description of the various settings available for configuring Maple to automatically compile the generated wrappers.

In addition to the data structures supported by wrapperless external call, generated wrappers support procedures (callbacks), structures, and unions.

A structure is a non-homogeneous collection of members, corresponding to a struct in C.

STRUCT( member1::descriptor1, ..., memberN::descriptorN, options);

A union is similar to a structure, except that all the members start at the same memory address, hence only one member of the union is valid at any given time.

UNION( member1::descriptor1, ..., memberN::descriptorN, options);

Each member::descriptor pair describes one member of the structure or union.  The descriptor is any of the basic external types recognized by define_external.

The options are used to specify what kind of data type the wrapper should expect for conversion purposes.  Valid options are TABLE and LIST.  Only one of these options can be specified, and once the wrapper has been generated only the declared type is accepted.  When tables are used, the member names correspond to table indices.  When lists are used, the member ordering is used to determine which element is accessed.  Lists are considered read-only.

A Maple procedure can be passed as an argument to an external function.

PROC( arg1::descriptor1, ..., argN::descriptorN, RETURN::descriptor, options);

$\mathrm{newton}≔\mathrm{define\_external}\left('\mathrm{newton}'\,'f'::\mathrm{PROC}\left('x'::\mathrm{float}\left[8\right]\,'\mathrm{RETURN}'::\mathrm{float}\left[8\right]\right)\,'\mathrm{fprime}'::\mathrm{PROC}\left('x'::\mathrm{float}\left[8\right]\,'\mathrm{RETURN}'::\mathrm{float}\left[8\right]\right)\,'\mathrm{guess}'::\mathrm{float}\left[8\right]\,'\mathrm{tolerance}'::\mathrm{float}\left[8\right]\,'\mathrm{RETURN}'::\mathrm{float}\left[8\right]\,'\mathrm{WRAPPER}'\,\mathrm{LIB}=''c:/shared/newton.dll''\right)\:$

$f≔x^4+2x^3-14x^2+2x+1$

$f≔x^4+2x^3-14x^2+2x+1$

$\mathrm{fprime}≔\mathrm{diff}\left(f\,x\right)$

$\mathrm{fprime}≔4x^3+6x^2-28x+2$

$f≔\mathrm{unapply}\left(f\,x\right)$

$f≔x\mapsto x^4+2\cdot x^3-14\cdot x^2+2\cdot x+1$

$\mathrm{fprime}≔\mathrm{unapply}\left(\mathrm{fprime}\,x\right)$

$\mathrm{fprime}≔x\mapsto 4\cdot x^3+6\cdot x^2-28\cdot x+2$

$r≔\mathrm{newton}\left(f\,\mathrm{fprime}\,1\,1.\times {10}^{\mathrm{-9}}\right)$

$r≔0.362199992775959822$

$f\left(r\right)$

$\mathrm{-1.0}\times {10}^{\mathrm{-9}}$