Returns a specified number of bytes from a file opened with a low-level function.
- Specifies the file handle number for the file from which FREAD(В ) returns data. You can obtain nFileHandle from the return value of successful FOPEN(В ) or FCREATE(В ) statements.
- nByte s
- Specifies the number of bytes returned by FREAD( ) with a limit of 65,535 bytes. FREAD(В ) returns data starting from the current file pointer position and continues until it returns nBytes bytes or until it encounters the end of the file.
The following example uses FREAD(В ) to display the contents of a file. If the file is empty, a message is displayed. Before using this example, you must create a sample text file called Test.txt.
Local gnFileHandle,nSize,cString gnFileHandle = FOPEN("test.txt") * Seek to end of file to determine number of bytes in the file. nSize = FSEEK(gnFileHandle, 0, 2) && Move pointer to EOF IF nSize <= 0 * If file is empty, display an error message. WAIT WINDOW "This file is empty!" NOWAIT ELSE * If file is not empty, store the file's contents in memory * and display the text in the main Visual FoxPro window. = FSEEK(gnFileHandle, 0, 0) && Move pointer to BOF cString = FREAD(gnFileHandle, nSize) ? cString ENDIF = FCLOSE(gnFileHandle) && Close the file