NAME

cxInputPortNames - get a list of the input port names

C SPECIFICATION

#include <cx/PortAccess.h>

char **cxInputPortNames()

FORTRAN SPECIFICATION

subroutine cxinputportnames( n, namelist, lengths )
integer n
character*(*) namelist(n)
integer lengths(n)

PARAMETERS

n
The input length of the namelist and lengths arrays.
namelist
The output array of port names.
lengths
The output array of port name lengths.

DESCRIPTION

The C routine cxInputPortNames returns a pointer to a list of character strings containing the names of the module's input ports. This list is represented as an array of character pointers to the names and is terminated by a NULL pointer.

The storage used to hold this information is allocated and owned by the module control wrapper. Subsequent calls to this routine will overwrite the current contents. Therefore, the module programmer should never attempt to deallocated this storage.

The Fortran subroutine cxInputPortNames accepts an array of character variables and fills them with the names of the module's input ports. At most n entries in the array are filled, even if there are more ports. Each port name is null-padded to fill the entry of namelist. The corresponding entry in the lengths array is assigned the true length of the port name, which may exceed the length of the character variable, in which case the caller should try again to get the full port name.

The namelist array must have length at least cxInputPortCount, and each variable should be declared long enough to hold the longest port name (plus one for the null termination). Port names that do not fit in a character variable are truncated. The truncated name will not be recognized by other API routines, so on receiving such a name it is best to call cxInputPortNames with a larger character variable array.

The namelist and lengths storage must be allocated by the user.

To determine independently the number of input ports, use cxInputPortCount.

SEE ALSO

cxInputPortCount(3E)
Last modified: Mon Nov 18 13:50:08 GMT 1996
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1996