_RetVal( ) API Library Routine Example
The following example uses _RetVal( ) to return its Character-type parameter converted to uppercase.
SET LIBRARY TO RETVAL
? XUPPER("upper") && returns "UPPER"
#include "pro_ext.h"
void NullTerminate(Value FAR *cVal)
{
if (!_SetHandSize(cVal->ev_handle, cVal->ev_length + 1)) {
_Error(182); // "Insufficient memory"
}
((char FAR *) _HandToPtr(cVal->ev_handle))[cVal->ev_length] = '\0';
}
FAR Example(ParamBlk FAR *parm)
{
char FAR *pString;
int i;
NullTerminate(&parm->p[0].val);
pString = _HandToPtr(parm->p[0].val.ev_handle);
for (i = 0; i < parm->p[0].val.ev_length; i++)
{
if ('a' <= *pString && *pString <= 'z')
{
*pString += ('A' - 'a');
}
pString++;
}
_RetVal(&parm->p[0].val);
}
FoxInfo myFoxInfo[] = {
{"XUPPER", (FPFI) Example, 1, "C"},
};
FoxTable _FoxTable = {
(FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
};