[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
FT_FUSE()
Open or close a text file for use by the FT_F* functions
------------------------------------------------------------------------------
Syntax
FT_FUSE( [ <cFile> ] [, <nMode> ] ) -> nHandle | 0
Arguments
<cFile> is the text file you want to open. If not specified,
the file currently open, if any, will be closed.
<nMode> is the open mode for the file. Please refer to the
discussion of open modes under FOPEN() in the Clipper manual
and FILEIO.CH for a list of allowable open modes. If not
specified, the file will be opened with a mode of
FO_READ + FO_SHARED (64).
Returns
If <cFile> is passed and the file is opened successfully, an
integer containing the text file's workarea. If the file cannot be
opened, -1 will be returned. In this case, check the return value
of ft_fError() for the cause of the error.
If FT_FUSE() is called without any arguments, it will close the
text file in the current "text area" and return 0.
If a read error occurs ft_fError() will contain the error code.
Description
The FT_F*() file functions are for reading text files, that is,
files where each line (record) is delimited by a CRLF pair.
Each file is opened in its own "workarea", similar to the concept
use by dbf files. As provided, a maximum of 10 files (in 10
workareas) can be opened (assuming there are sufficient file
handles available). That number may be increased by modifying
the #define TEXT_WORKAREAS in the C source code and recompiling.
Examples
#include "fileio.ch"
// open a text file for reading
ft_fUse( "text.txt" )
// open a text file for reading and writing
ft_fUse( "text.txt", FO_READWRITE + FO_SHARED )
// close file
ft_fUse()
Source: FTTEXT.C
Author: Brice de Ganahl and Steve Larsen
See Also:
FT_FUSE()
FT_FSELECT()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson