]>
Commit | Line | Data |
---|---|---|
1 | \section{\class{wxFileInputStream}}\label{wxfileinputstream} | |
2 | ||
3 | This class represents data read in from a file. There are actually | |
4 | two such groups of classes: this one is based on \helpref{wxFile}{wxfile} | |
5 | whereas \helpref{wxFFileInputStream}{wxffileinputstream} is based in | |
6 | the \helpref{wxFFile}{wxffile} class. | |
7 | ||
8 | Note that \helpref{wxFile}{wxfile} and \helpref{wxFFile}{wxffile} differ | |
9 | in one aspect, namely when to report that the end of the file has been | |
10 | reached. This is documented in \helpref{wxFile::Eof}{wxfileeof} and | |
11 | \helpref{wxFFile::Eof}{wxffileeof} and the behaviour of the stream | |
12 | classes reflects this difference, i.e. wxFileInputStream will report | |
13 | wxSTREAM\_EOF after having read the last byte whereas wxFFileInputStream | |
14 | will report wxSTREAM\_EOF after trying to read {\it past} the last byte. | |
15 | Related to EOF behavior, note that \helpref{SeekI()}{wxinputstreamseeki} | |
16 | can seek beyond the end of the stream (file) and will thus not return | |
17 | {\it wxInvalidOffset} for that. | |
18 | ||
19 | \wxheading{Derived from} | |
20 | ||
21 | \helpref{wxInputStream}{wxinputstream} | |
22 | ||
23 | \wxheading{Include files} | |
24 | ||
25 | <wx/wfstream.h> | |
26 | ||
27 | \wxheading{See also} | |
28 | ||
29 | \helpref{wxBufferedInputStream}{wxbufferedinputstream}, \helpref{wxFileOutputStream}{wxfileoutputstream}, \helpref{wxFFileOutputStream}{wxffileoutputstream} | |
30 | ||
31 | % ---------- | |
32 | % Members | |
33 | % ---------- | |
34 | \latexignore{\rtfignore{\wxheading{Members}}} | |
35 | ||
36 | \membersection{wxFileInputStream::wxFileInputStream} | |
37 | ||
38 | \func{}{wxFileInputStream}{\param{const wxString\&}{ ifileName}} | |
39 | ||
40 | Opens the specified file using its {\it ifilename} name in read-only mode. | |
41 | ||
42 | \func{}{wxFileInputStream}{\param{wxFile\&}{ file}} | |
43 | ||
44 | Initializes a file stream in read-only mode using the file I/O object {\it file}. | |
45 | ||
46 | \func{}{wxFileInputStream}{\param{int}{ fd}} | |
47 | ||
48 | Initializes a file stream in read-only mode using the specified file descriptor. | |
49 | ||
50 | \membersection{wxFileInputStream::\destruct{wxFileInputStream}} | |
51 | ||
52 | \func{}{\destruct{wxFileInputStream}}{\void} | |
53 | ||
54 | Destructor. | |
55 | ||
56 | \membersection{wxFileInputStream::Ok} | |
57 | ||
58 | \constfunc{bool}{Ok}{\void} | |
59 | ||
60 | Returns true if the stream is initialized and ready. | |
61 |