X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/39b91ecabeb35ad879412df1bcd1cec9ea97a20a..72db8894790c0fc32a8a57e9e2f750e8f95222b1:/docs/latex/wx/inputstr.tex diff --git a/docs/latex/wx/inputstr.tex b/docs/latex/wx/inputstr.tex index 9edd5d824a..9c3d8adec6 100644 --- a/docs/latex/wx/inputstr.tex +++ b/docs/latex/wx/inputstr.tex @@ -3,6 +3,8 @@ % ----------------------------------------------------------------------------- \section{\class{wxInputStream}}\label{wxinputstream} +wxInputStream is an abstract base class which may not be used directly. + \wxheading{Derived from} \helpref{wxStreamBase}{wxstreambase} @@ -11,6 +13,8 @@ +\latexignore{\rtfignore{\wxheading{Members}}} + % ----------- % ctor & dtor % ----------- @@ -32,6 +36,12 @@ Destructor. Returns the first character in the input queue and removes it. +\membersection{wxInputStream::Eof}\label{wxinputstreameof} + +\constfunc{wxInputStream}{Eof}{\void} + +Returns TRUE if the end of stream has been reached. + \membersection{wxInputStream::LastRead}\label{wxinputstreamlastread} \constfunc{size\_t}{LastRead}{\void} @@ -48,7 +58,7 @@ Returns the first character in the input queue without removing it. \func{wxInputStream\&}{Read}{\param{void *}{buffer}, \param{size\_t}{ size}} -Reads the specified amount of bytes and stores the data in \it{buffer}. +Reads the specified amount of bytes and stores the data in {\it buffer}. \wxheading{Warning} @@ -81,16 +91,21 @@ Changes the stream current position. Returns the current stream position. -\membersection{wxInputStream::Ungetch}\label{wxinputstream_ungetch} +\membersection{wxInputStream::Ungetch}\label{wxinputstreamungetch} \func{size\_t}{Ungetch}{\param{const char*}{ buffer}, \param{size\_t}{ size}} -This function is only useful in \it{read} mode. It is the manager of the "Write-Back" -buffer. This buffer acts like a temporary buffer where datas which has to be +This function is only useful in {\it read} mode. It is the manager of the "Write-Back" +buffer. This buffer acts like a temporary buffer where data which has to be read during the next read IO call are put. This is useful when you get a big block of data which you didn't want to read: you can replace them at the top of the input queue by this way. +Be very careful about this call in connection with calling SeekI() on the same +stream. Any call to SeekI() will invalidate any previous call to this method +(otherwise you could SeekI() to one position, "unread" a few bytes there, SeekI() +to another position and data would be either lost or corrupted). + \wxheading{Return value} Returns the amount of bytes saved in the Write-Back buffer.