docs/latex/wx/strmfile.tex

   1 % -----------------------------------------------------------------------------
   2 % wxFileInputStream
   3 % -----------------------------------------------------------------------------
   4 \section{\class{wxFileInputStream}}\label{wxfileinputstream}
   5
   6 This class represents data read in from a file. There are actually
   7 two such groups of classes: this one is based on \helpref{wxFile}{wxfile}
   8 whereas \helpref{wxFFileInputStream}{wxffileinputstream} is based in
   9 the \helpref{wxFFile}{wxffile} class.
  10
  11 Note that \helpref{wxFile}{wxfile} and \helpref{wxFFile}{wxffile} differ
  12 in one aspect, namely when to report that the end of the file has been
  13 reached. This is documented in \helpref{wxFile::Eof}{wxfileeof} and
  14 \helpref{wxFFile::Eof}{wxffileeof} and the behaviour of the stream
  15 classes reflects this difference, i.e. wxFileInputStream will report
  16 wxSTREAM\_EOF after having read the last byte whereas wxFFileInputStream
  17 will report wxSTREAM\_EOF after trying to read {\it past} the last byte.
  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
  62 % -----------------------------------------------------------------------------
  63 % wxFileOutputStream
  64 % -----------------------------------------------------------------------------
  65 \section{\class{wxFileOutputStream}}\label{wxfileoutputstream}
  66
  67 This class represents data written to a file. There are actually
  68 two such groups of classes: this one is based on \helpref{wxFile}{wxfile}
  69 whereas \helpref{wxFFileInputStream}{wxffileinputstream} is based in
  70 the \helpref{wxFFile}{wxffile} class.
  71
  72 Note that \helpref{wxFile}{wxfile} and \helpref{wxFFile}{wxffile} differ
  73 in one aspect, namely when to report that the end of the file has been
  74 reached. This is documented in \helpref{wxFile::Eof}{wxfileeof} and
  75 \helpref{wxFFile::Eof}{wxffileeof} and the behaviour of the stream
  76 classes reflects this difference, i.e. wxFileInputStream will report
  77 wxSTREAM\_EOF after having read the last byte whereas wxFFileInputStream
  78 will report wxSTREAM\_EOF after trying to read {\it past} the last byte.
  79
  80 \wxheading{Derived from}
  81
  82 \helpref{wxOutputStream}{wxoutputstream}
  83
  84 \wxheading{Include files}
  85
  86 <wx/wfstream.h>
  87
  88 \wxheading{See also}
  89
  90 \helpref{wxBufferedOutputStream}{wxbufferedoutputstream}, \helpref{wxFileInputStream}{wxfileinputstream}, \helpref{wxFFileInputStream}{wxffileinputstream}
  91
  92 % ----------
  93 % Members
  94 % ----------
  95 \latexignore{\rtfignore{\wxheading{Members}}}
  96
  97 \membersection{wxFileOutputStream::wxFileOutputStream}
  98
  99 \func{}{wxFileOutputStream}{\param{const wxString\&}{ ofileName}}
 100
 101 Creates a new file with {\it ofilename} name and initializes the stream in
 102 write-only mode.
 103
 104 \func{}{wxFileOutputStream}{\param{wxFile\&}{ file}}
 105
 106 Initializes a file stream in write-only mode using the file I/O object {\it file}.
 107
 108 \func{}{wxFileOutputStream}{\param{int}{ fd}}
 109
 110 Initializes a file stream in write-only mode using the file descriptor {\it fd}.
 111
 112 \membersection{wxFileOutputStream::\destruct{wxFileOutputStream}}
 113
 114 \func{}{\destruct{wxFileOutputStream}}{\void}
 115
 116 Destructor.
 117
 118 \membersection{wxFileOutputStream::Ok}
 119
 120 \constfunc{bool}{Ok}{\void}
 121
 122 Returns TRUE if the stream is initialized and ready.
 123
 124 % -----------------------------------------------------------------------------
 125 % wxFileStream
 126 % -----------------------------------------------------------------------------
 127 \section{\class{wxFileStream}}
 128
 129 \wxheading{Derived from}
 130
 131 \helpref{wxFileOutputStream}{wxfileoutputstream}, \helpref{wxFileInputStream}{wxfileinputstream}
 132
 133 \wxheading{Include files}
 134
 135 <wx/wfstream.h>
 136
 137 \wxheading{See also}
 138
 139 \helpref{wxStreamBuffer}{wxstreambuffer}
 140
 141 \latexignore{\rtfignore{\wxheading{Members}}}
 142
 143 \membersection{wxFileStream::wxFileStream}
 144
 145 \func{}{wxFileStream}{\param{const wxString\&}{ iofileName}}
 146
 147 Initializes a new file stream in read-write mode using the specified
 148 {\it iofilename} name.
 149
 150
 151 % -----------------------------------------------------------------------------
 152 % wxFFileInputStream
 153 % -----------------------------------------------------------------------------
 154 \section{\class{wxFFileInputStream}}\label{wxffileinputstream}
 155
 156 This class represents data read in from a file. There are actually
 157 two such groups of classes: this one is based on \helpref{wxFFile}{wxffile}
 158 whereas \helpref{wxFileInputStream}{wxfileinputstream} is based in
 159 the \helpref{wxFile}{wxfile} class.
 160
 161 Note that \helpref{wxFile}{wxfile} and \helpref{wxFFile}{wxffile} differ
 162 in one aspect, namely when to report that the end of the file has been
 163 reached. This is documented in \helpref{wxFile::Eof}{wxfileeof} and
 164 \helpref{wxFFile::Eof}{wxffileeof} and the behaviour of the stream
 165 classes reflects this difference, i.e. wxFileInputStream will report
 166 wxSTREAM\_EOF after having read the last byte whereas wxFFileInputStream
 167 will report wxSTREAM\_EOF after trying to read {\it past} the last byte.
 168
 169 \wxheading{Derived from}
 170
 171 \helpref{wxInputStream}{wxinputstream}
 172
 173 \wxheading{Include files}
 174
 175 <wx/wfstream.h>
 176
 177 \wxheading{See also}
 178
 179 \helpref{wxBufferedInputStream}{wxbufferedinputstream}, \helpref{wxFFileOutputStream}{wxffileoutputstream}, \helpref{wxFileOutputStream}{wxfileoutputstream}
 180
 181 % ----------
 182 % Members
 183 % ----------
 184 \latexignore{\rtfignore{\wxheading{Members}}}
 185
 186 \membersection{wxFFileInputStream::wxFFileInputStream}
 187
 188 \func{}{wxFFileInputStream}{\param{const wxString\&}{ ifileName}}
 189
 190 Opens the specified file using its {\it ifilename} name in read-only mode.
 191
 192 \func{}{wxFFileInputStream}{\param{wxFFile\&}{ file}}
 193
 194 Initializes a file stream in read-only mode using the file I/O object {\it file}.
 195
 196 \func{}{wxFFileInputStream}{\param{FILE *}{ fp}}
 197
 198 Initializes a file stream in read-only mode using the specified file pointer {\it fp}.
 199
 200 \membersection{wxFFileInputStream::\destruct{wxFFileInputStream}}
 201
 202 \func{}{\destruct{wxFFileInputStream}}{\void}
 203
 204 Destructor.
 205
 206 \membersection{wxFFileInputStream::Ok}
 207
 208 \constfunc{bool}{Ok}{\void}
 209
 210 Returns TRUE if the stream is initialized and ready.
 211
 212 % -----------------------------------------------------------------------------
 213 % wxFFileOutputStream
 214 % -----------------------------------------------------------------------------
 215 \section{\class{wxFFileOutputStream}}\label{wxffileoutputstream}
 216
 217 This class represents data written to a file. There are actually
 218 two such groups of classes: this one is based on \helpref{wxFFile}{wxffile}
 219 whereas \helpref{wxFileInputStream}{wxffileinputstream} is based in
 220 the \helpref{wxFile}{wxfile} class.
 221
 222 Note that \helpref{wxFile}{wxfile} and \helpref{wxFFile}{wxffile} differ
 223 in one aspect, namely when to report that the end of the file has been
 224 reached. This is documented in \helpref{wxFile::Eof}{wxfileeof} and
 225 \helpref{wxFFile::Eof}{wxffileeof} and the behaviour of the stream
 226 classes reflects this difference, i.e. wxFileInputStream will report
 227 wxSTREAM\_EOF after having read the last byte whereas wxFFileInputStream
 228 will report wxSTREAM\_EOF after trying to read {\it past} the last byte.
 229
 230 \wxheading{Derived from}
 231
 232 \helpref{wxOutputStream}{wxoutputstream}
 233
 234 \wxheading{Include files}
 235
 236 <wx/wfstream.h>
 237
 238 \wxheading{See also}
 239
 240 \helpref{wxBufferedOutputStream}{wxbufferedoutputstream}, \helpref{wxFFileInputStream}{wxffileinputstream}, \helpref{wxFileInputStream}{wxfileinputstream}
 241
 242 % ----------
 243 % Members
 244 % ----------
 245 \latexignore{\rtfignore{\wxheading{Members}}}
 246
 247 \membersection{wxFFileOutputStream::wxFFileOutputStream}
 248
 249 \func{}{wxFFileOutputStream}{\param{const wxString\&}{ ofileName}}
 250
 251 Creates a new file with {\it ofilename} name and initializes the stream in
 252 write-only mode.
 253
 254 \func{}{wxFFileOutputStream}{\param{wxFFile\&}{ file}}
 255
 256 Initializes a file stream in write-only mode using the file I/O object {\it file}.
 257
 258 \func{}{wxFFileOutputStream}{\param{FILE *}{ fp}}
 259
 260 Initializes a file stream in write-only mode using the file descriptor {\it fp}.
 261
 262 \membersection{wxFFileOutputStream::\destruct{wxFFileOutputStream}}
 263
 264 \func{}{\destruct{wxFFileOutputStream}}{\void}
 265
 266 Destructor.
 267
 268 \membersection{wxFFileOutputStream::Ok}
 269
 270 \constfunc{bool}{Ok}{\void}
 271
 272 Returns TRUE if the stream is initialized and ready.
 273
 274 % -----------------------------------------------------------------------------
 275 % wxFFileStream
 276 % -----------------------------------------------------------------------------
 277 \section{\class{wxFFileStream}}
 278
 279 \wxheading{Derived from}
 280
 281 \helpref{wxFFileOutputStream}{wxffileoutputstream}, \helpref{wxFFileInputStream}{wxffileinputstream}
 282
 283 \wxheading{Include files}
 284
 285 <wx/wfstream.h>
 286
 287 \wxheading{See also}
 288
 289 \helpref{wxStreamBuffer}{wxstreambuffer}
 290
 291 \latexignore{\rtfignore{\wxheading{Members}}}
 292
 293 \membersection{wxFFileStream::wxFFileStream}
 294
 295 \func{}{wxFFileStream}{\param{const wxString\&}{ iofileName}}
 296
 297 Initializes a new file stream in read-write mode using the specified
 298 {\it iofilename} name.
 299
 300