_FCHSize( ) API Library Routine
Sets the size on disk of the specified file to the specified length.
int _FCHSize(FCHAN chan, long length)
FCHAN chan; /* File to change. */
long length; /* New length for the file in bytes. */
Remarks
The specified length may extend or truncate the file. _FCHSize( ) returns 0 if it's successful in changing the length of the file, or – 1 if it fails.
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 creates a file Temp.txt and sets its size to 8196 bytes using _FCHSize( ).
Visual FoxPro Code
SET LIBRARY TO FCHSIZE
DIR temp.txt
C Code
#include <pro_ext.h>
FAR Example(ParamBlk FAR *parm)
{
FCHAN fchan = _FCreate("temp.txt", FC_NORMAL);
_FCHSize(fchan, 8196);
_FClose(fchan);
}
FoxInfo myFoxInfo[] = {
{"FCHSIZE", (FPFI) Example, CALLONLOAD, ""},
};
FoxTable _FoxTable = {
(FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
};
See Also
_FGets( ) API Library Routine |_FPuts( ) API Library Routine | _FWrite( ) API Library Routine