Difference between revisions of "Parinfa()"

Latest revision as of 12:45, 30 March 2009

PURPOSE

Check data type of any array elements

SYNONYM

api_par_infa()

SYNOPSIS

#include "dbapi.h"
 
int	_parinfa(order [,index])
 
<input parameters>
int	order;		/* Placement in the array in the parameter list	*/
int	index;		/* Array element index					*/
 
<output parameters>
none

DESCRIPTION

The function returns a value specifying the data type of an array element and is used for parameter checking. Array elements can be of varying data types in Recital and must be checked before using. The order specifies the actual placement in the parameter list. The index value is used to specify the required element number in the specified array. If the index value is 0, then the total number of elements in the array will be returned.

The _parinfa() function returns a value from the following table.

EXAMPLE

The following example returns the number of character elements in the array passed as the first parameter.

Example Recital program:

Declare m_array[2]
m_array[1]="RECITAL"
m_array[2]="7.1"
m_num_char=numchar(m_array)

Example 'C' function:

#include "dbapi.h"
 
dbapi_numchar()
{
    int	num;
    int	i;
 
    if (_parinfo(1) == API_ATYPE) {
       for (i = 1; i <= _parinfa(1, 0); ++i) {
       if (_parinfa(1,i) == API_CTYPE) {
       }
       }
    } else {
       num = -1;
    }
 
    _retni( num );
}

SEE ALSO

_parinfo(), ALENGTH(), ISARRAY(), ARRAY_ALEN(), ARRAY_DEFINE(), ARRAY_LOOKUP(), ARRAY_UPDATE(), MEMVAR_DEFINE(), MEMVAR_LOOKUP(), MEMVAR_UPDATE()