Faster Deselect

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

diff --git a/docs/latex/wx/strmbase.tex b/docs/latex/wx/strmbase.tex
index 7876d607b59a8d373a77314a8d2b725c16e8e06b..23d8b3defaf1058cf48c27fbfcb9fbe498c4516d 100644 (file)
--- a/docs/latex/wx/strmbase.tex
+++ b/docs/latex/wx/strmbase.tex
@@ -3,6 +3,9 @@
 % -----------------------------------------------------------------------------
 \section{\class{wxStreamBase}}\label{wxstreambase}
 
 % -----------------------------------------------------------------------------
 \section{\class{wxStreamBase}}\label{wxstreambase}
 

+This class is the base class of most stream related classes in wxWidgets. It must
+not be used directly.
+

 \wxheading{Derived from}
 
 None
 \wxheading{Derived from}
 
 None


@@ -24,71 +27,78 @@ None
 % ctor & dtor
 % -----------
 
 % ctor & dtor
 % -----------
 

-\membersection{wxStreamBase::wxStreamBase}
+\membersection{wxStreamBase::wxStreamBase}\label{wxstreambasector}

 
 \func{}{wxStreamBase}{\void}
 
 Creates a dummy stream object. It doesn't do anything.
 
 
 \func{}{wxStreamBase}{\void}
 
 Creates a dummy stream object. It doesn't do anything.
 

-\membersection{wxStreamBase::\destruct{wxStreamBase}}
+\membersection{wxStreamBase::\destruct{wxStreamBase}}\label{wxstreambasedtor}

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

-\membersection{wxStreamBase::LastError}\label{wxstreambaselasterror}
+\membersection{wxStreamBase::IsOk}\label{wxstreambaseisok}
+
+\constfunc{wxStreamError}{IsOk}{\void}
+
+Returns true if no error occurred on the stream.
+
+\wxheading{See also}

 
 

-\constfunc{wxStreamError}{LastError}{\void}
+\helpref{GetLastError}{wxstreambasegetlasterror}
+
+\membersection{wxStreamBase::GetLastError}\label{wxstreambasegetlasterror}
+
+\constfunc{wxStreamError}{GetLastError}{\void}

 
 This function returns the last error.
 
 This function returns the last error.

+

 \twocolwidtha{5cm}
 \begin{twocollist}\itemsep=0pt
 \twocolwidtha{5cm}
 \begin{twocollist}\itemsep=0pt

-\twocolitem{{\bf wxStream\_NOERROR}}{No error occured.}
-\twocolitem{{\bf wxStream\_EOF}}{An End-Of-File occured.}
-\twocolitem{{\bf wxStream\_WRITE\_ERR}}{A generic error occured on the last write call.}
-\twocolitem{{\bf wxStream\_READ\_ERR}}{A generic error occured on the last read call.}
+\twocolitem{{\bf wxSTREAM\_NO\_ERROR}}{No error occurred.}
+\twocolitem{{\bf wxSTREAM\_EOF}}{An End-Of-File occurred.}
+\twocolitem{{\bf wxSTREAM\_WRITE\_ERROR}}{A generic error occurred on the last write call.}
+\twocolitem{{\bf wxSTREAM\_READ\_ERROR}}{A generic error occurred on the last read call.}

 \end{twocollist}
 
 \membersection{wxStreamBase::OnSysRead}\label{wxstreambaseonsysread}
 
 \func{size\_t}{OnSysRead}{\param{void*}{ buffer}, \param{size\_t}{ bufsize}}
 
 \end{twocollist}
 
 \membersection{wxStreamBase::OnSysRead}\label{wxstreambaseonsysread}
 
 \func{size\_t}{OnSysRead}{\param{void*}{ buffer}, \param{size\_t}{ bufsize}}
 

-Internal function. It is called when the stream buffer needs a buffer of the
+Internal function. It is called when the stream wants to read data of the

 specified size. It should return the size that was actually read.
 
 specified size. It should return the size that was actually read.
 

-\membersection{wxStreamBase::OnSysSeek}
+\membersection{wxStreamBase::OnSysSeek}\label{wxstreambaseonsysseek}

 
 \func{off\_t}{OnSysSeek}{\param{off\_t}{ pos}, \param{wxSeekMode}{ mode}}
 
 
 \func{off\_t}{OnSysSeek}{\param{off\_t}{ pos}, \param{wxSeekMode}{ mode}}
 

-Internal function. It is called when the stream buffer needs to change the
-current position in the stream. See \helpref{wxStreamBuffer::Seek}{wxstreambufferseek}
+Internal function. It is called when the stream needs to change the
+current position.

 
 

-\membersection{wxStreamBase::OnSysTell}
+\membersection{wxStreamBase::OnSysTell}\label{wxstreambaseonsystell}

 
 \constfunc{off\_t}{OnSysTell}{\void}
 
 
 \constfunc{off\_t}{OnSysTell}{\void}
 

-Internal function. Is is called when the stream buffer needs to know the
-real position in the stream.
+Internal function. Is is called when the stream needs to know the
+real position.

 
 

-\membersection{wxStreamBase::OnSysWrite}
+\membersection{wxStreamBase::OnSysWrite}\label{wxstreambaseonsyswrite}

 
 \func{size\_t}{OnSysWrite}{\param{void *}{buffer}, \param{size\_t}{ bufsize}}
 
 See \helpref{OnSysRead}{wxstreambaseonsysread}.
 
 
 \func{size\_t}{OnSysWrite}{\param{void *}{buffer}, \param{size\_t}{ bufsize}}
 
 See \helpref{OnSysRead}{wxstreambaseonsysread}.
 

-\membersection{wxStreamBase::StreamSize}
+\membersection{wxStreamBase::GetSize}\label{wxstreambasegetsize}

 
 

-\constfunc{size\_t}{StreamSize}{\void}
+\constfunc{size\_t}{GetSize}{\void}

 
 This function returns the size of the stream. For example, for a file it is the size of
 
 This function returns the size of the stream. For example, for a file it is the size of

-the file).
+the file.

 
 \wxheading{Warning}
 
 There are streams which do not have size by definition, such as socket streams.
 
 \wxheading{Warning}
 
 There are streams which do not have size by definition, such as socket streams.

-In that cases, StreamSize returns an invalid size represented by
-
-\begin{verbatim}
-~(size_t)0
-\end{verbatim}
+In that cases, GetSize returns $0$ so you should always test its return value.