X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/a84e46f23169fc203099c23643219d1a8b562b50..65baafba0e8cd74f2264b7e2f7625ff5bea84864:/docs/latex/wx/inputstr.tex diff --git a/docs/latex/wx/inputstr.tex b/docs/latex/wx/inputstr.tex index 05f45a1884..7f48f40df4 100644 --- a/docs/latex/wx/inputstr.tex +++ b/docs/latex/wx/inputstr.tex @@ -18,19 +18,26 @@ wxInputStream is an abstract base class which may not be used directly. % ----------- % ctor & dtor % ----------- -\membersection{wxInputStream::wxInputStream} +\membersection{wxInputStream::wxInputStream}\label{wxinputstreamctor} \func{}{wxInputStream}{\void} Creates a dummy input stream. -\membersection{wxInputStream::\destruct{wxInputStream}} +\membersection{wxInputStream::\destruct{wxInputStream}}\label{wxinputstreamdtor} \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} @@ -43,14 +50,17 @@ If EOF, return value is undefined and LastRead() will return 0 and not 1. \membersection{wxInputStream::Eof}\label{wxinputstreameof} -\constfunc{wxInputStream}{Eof}{\void} +\constfunc{bool}{Eof}{\void} Returns true if the end of stream has been reached. \wxheading{Note} -This cannot be really implemented for all streams and CanRead() is more -reliable than Eof(). +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} @@ -58,7 +68,7 @@ reliable than Eof(). Returns the last number of bytes read. -\membersection{wxInputStream::Peek} +\membersection{wxInputStream::Peek}\label{wxinputstreampeek} \func{char}{Peek}{\void} @@ -70,7 +80,7 @@ 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} +\membersection{wxInputStream::Read}\label{wxinputstreamread} \func{wxInputStream\&}{Read}{\param{void *}{buffer}, \param{size\_t}{ size}} @@ -111,7 +121,7 @@ Changes the stream current position. The new stream position or wxInvalidOffset on error. -\membersection{wxInputStream::TellI} +\membersection{wxInputStream::TellI}\label{wxinputstreamtelli} \constfunc{off\_t}{TellI}{\void}