_RetVal( ) (Rutina de biblioteca API)

Devuelve cualquier tipo de datos de Visual FoxPro, salvo Memo.

void _RetVal(Value FAR *val)
Value FAR *val;            /* Pointer to value structure. */

Observaciones

_RetVal( ) pasa una estructura de valores completa de Visual FoxPro. Debe llamar a _RetVal( ) para devolver una cadena que contiene caracteres nulos incrustados.

Para obtener más información acerca de cómo crear una biblioteca API e integrarla con Visual FoxPro, vea Acceso a la API de Visual FoxPro.

Ejemplo

El ejemplo siguiente utiliza _RetVal( ) para devolver el parámetro de tipo carácter convertido en mayúsculas.

Código Visual FoxPro

SET LIBRARY TO RETVAL  
? XUPPER("upper")  && returns "UPPER"

Código C

#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
};

Vea también

_RetChar( ) (Rutina de biblioteca API) | _RetCurrency( ) (Rutina de biblioteca API) | _RetDateStr( ) (Rutina de biblioteca API) | _RetDateTimeStr( ) (Rutina de biblioteca API) | _RetFloat( ) (Rutina de biblioteca API) | _RetInt( ) (Rutina de biblioteca API) | _RetLogical( ) (Rutina de biblioteca API)