js editor
Web development
Returns any Visual FoxPro data type, except Memo.
void _RetVal(Value FAR *val) Value FAR *val; /* Pointer to value structure. */ |
Remarks
_RetVal(В ) passes a complete Visual FoxPro Value structure. You must call _RetVal(В ) to return a string that contains embedded null characters.
For more information on how to create an API library and integrate it with Visual FoxPro, see Accessing the Visual FoxPro API.
Example
The following example uses _RetVal(В ) to return its Character-type parameter converted to uppercase.
Visual FoxPro Code
| В |  Copy Code |
|---|---|
SET LIBRARY TO RETVAL
? XUPPER("upper") && returns "UPPER" | |
C Code
| В | Copy Code |
|---|---|
#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
}; | |