Use the new event handler macros

[wxWidgets.git] / docs / latex / wx / inputstr.tex

diff --git a/docs/latex/wx/inputstr.tex b/docs/latex/wx/inputstr.tex
index daf42acc31ca724ccd4088f6af8441414bb03231..7f48f40df427f422a07c4c8572b5382f82f24ff4 100644 (file)
--- a/docs/latex/wx/inputstr.tex
+++ b/docs/latex/wx/inputstr.tex
@@ -18,43 +18,69 @@ wxInputStream is an abstract base class which may not be used directly.
 % -----------
 % ctor & dtor
 % -----------
 % -----------
 % ctor & dtor
 % -----------

-\membersection{wxInputStream::wxInputStream}
+\membersection{wxInputStream::wxInputStream}\label{wxinputstreamctor}

 
 \func{}{wxInputStream}{\void}
 
 Creates a dummy input stream.
 
 
 \func{}{wxInputStream}{\void}
 
 Creates a dummy input stream.
 

-\membersection{wxInputStream::\destruct{wxInputStream}}
+\membersection{wxInputStream::\destruct{wxInputStream}}\label{wxinputstreamdtor}

 
 \func{}{\destruct{wxInputStream}}{\void}
 
 Destructor.
 
 
 \func{}{\destruct{wxInputStream}}{\void}
 
 Destructor.
 

-\membersection{wxInputStream::GetC}
+\membersection{wxInputStream::CanRead}\label{wxinputstreamcanread}
+
+\constfunc{bool}{CanRead}{\void}
+
+Returns true if some data is available in the stream right now, so that
+calling \helpref{Read()}{wxinputstreamread} wouldn't block.
+
+\membersection{wxInputStream::GetC}\label{wxinputstreamgetc}

 
 \func{char}{GetC}{\void}
 
 
 \func{char}{GetC}{\void}
 

-Returns the first character in the input queue and removes it.
+Returns the first character in the input queue and removes it, 
+blocking until it appears if necessary.
+
+\wxheading{Note}
+
+If EOF, return value is undefined and LastRead() will return 0 and not 1.

 
 \membersection{wxInputStream::Eof}\label{wxinputstreameof}
 
 
 \membersection{wxInputStream::Eof}\label{wxinputstreameof}
 

-\constfunc{wxInputStream}{Eof}{\void}
+\constfunc{bool}{Eof}{\void}

 
 Returns true if the end of stream has been reached.
 
 
 Returns true if the end of stream has been reached.
 

+\wxheading{Note}
+
+For some streams Eof() will not return true until an
+attempt has been made to read past the end of the stream.
+\helpref{LastRead()}{wxinputstreamlastread}
+should be called after each read to check that
+a non-zero number of bytes have been read.
+

 \membersection{wxInputStream::LastRead}\label{wxinputstreamlastread}
 
 \constfunc{size\_t}{LastRead}{\void}
 
 Returns the last number of bytes read.
 
 \membersection{wxInputStream::LastRead}\label{wxinputstreamlastread}
 
 \constfunc{size\_t}{LastRead}{\void}
 
 Returns the last number of bytes read.
 

-\membersection{wxInputStream::Peek}
+\membersection{wxInputStream::Peek}\label{wxinputstreampeek}

 
 \func{char}{Peek}{\void}
 
 Returns the first character in the input queue without removing it.
 
 
 \func{char}{Peek}{\void}
 
 Returns the first character in the input queue without removing it.
 

-\membersection{wxInputStream::Read}
+\wxheading{Note}
+
+Blocks until something appears in the stream if necessary, if nothing
+ever does (i.e. EOF) LastRead() will return 0 (and the return value is
+undefined), otherwise LastRead() returns 1.
+
+\membersection{wxInputStream::Read}\label{wxinputstreamread}

 
 \func{wxInputStream\&}{Read}{\param{void *}{buffer}, \param{size\_t}{ size}}
 
 
 \func{wxInputStream\&}{Read}{\param{void *}{buffer}, \param{size\_t}{ size}}
 


@@ -85,7 +111,17 @@ any states of the stream right away.
 
 Changes the stream current position.
 
 
 Changes the stream current position.
 

-\membersection{wxInputStream::TellI}
+\wxheading{Parameters}
+
+\docparam{pos}{Offset to seek to.}
+
+\docparam{mode}{One of {\bf wxFromStart}, {\bf wxFromEnd}, {\bf wxFromCurrent}.}
+
+\wxheading{Return value}
+
+The new stream position or wxInvalidOffset on error.
+
+\membersection{wxInputStream::TellI}\label{wxinputstreamtelli}

 
 \constfunc{off\_t}{TellI}{\void}
 
 
 \constfunc{off\_t}{TellI}{\void}