The MODULEIN subroutine calls an external routine that returns a numerical value.

The arguments to the MODULEIN function are as follows:

control

is a character matrix that contains a control string.

modname

is a character matrix that contains the name of the external routine to be called.

matrix

matrices with parameters to be passed to the external routine.

The MODULEIN routine executes a routine modname that resides in an external shared library with the specified arguments, and returns a character value. The description of this function is identical that for to the MODULEI call, except that the MODULEIN function returns a scalar numeric value from the external routine.

See the MODULEI call for a full description of the function and its arguments.

This example invokes the changi routine from the TRYMOD.DLL module on a Windows platform. Use the following attribute table.

routine changi module=trymod returns=long;
arg 1 input num format=ib4. byvalue;
arg 2 update num format=ib4.;

The following statements call the changi function:

proc iml;
   x1=J(4,5,0);
   do i=1 to 4;
      do j=1 to 5;
         x1[i,j]=i*10+j+3;
      end;
   end;
   y1=x1;
   x2=x1;
   y2=y1;
   rc=modulein("*i","changi",6,x2);