_StrCpy( ) (Rutina de biblioteca API)
Copia una cadena terminada en nulo desde src a dest.
void _StrCpy(char FAR *dest, char FAR *src)
char FAR *dest; /* Destination location. */
char FAR *src; /* Source location. */
Observaciones
_StrCpy( ) no admite movimientos superpuestos. Los movimientos superpuestos son necesarios cuando src y dest tienen algunos bytes en común. Si se necesitan movimientos superpuestos, utilice _MemMove( ).
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 se pasa como una matriz de Visual FoxPro de tipo Character. A continuación, reemplaza el segundo elemento mediante _Store( ).
Antes de llamar a MYFUNC( ), el código de ejemplo de Visual FoxPro crea una matriz y la inicializa como tipo Character. MYFUNC( ) pasa esta matriz por referencia.
Código Visual FoxPro
SET LIBRARY TO STRCPY
? STRCPY("Hello", " world") && returns "Hello world"
Código C
#include <pro_ext.h>
FAR Example(ParamBlk FAR *parm)
{
#define p0 (parm->p[0].val)
#define p1 (parm->p[1].val)
if (!_SetHandSize(p0.ev_handle, p0.ev_length + p1.ev_length))
_Error(182); // "Insufficient memory"
_HLock(p0.ev_handle);
_HLock(p1.ev_handle);
((char FAR *) _HandToPtr(p1.ev_handle))[p1.ev_length] = '\0';
_StrCpy((char FAR *) _HandToPtr(p0.ev_handle) + p0.ev_length,
_HandToPtr(p1.ev_handle));
_RetChar(_HandToPtr(p0.ev_handle));
_HUnLock(p0.ev_handle);
_HUnLock(p1.ev_handle);
}
FoxInfo myFoxInfo[] = {
{"STRCPY", (FPFI) Example, 2, "C,C"},
};
FoxTable _FoxTable = {
(FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
};
Vea también
_StrCmp( ) (Rutina de biblioteca API) | _StrLen( ) (Rutina de biblioteca API) | Rutinas de manipulación de cadenas | _PutStr( ) (Rutina de biblioteca API) | _WPutStr( ) (Rutina de biblioteca API)