X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/294e9a7aa00c23de9aad973b3998071b81159aee..07b87e8d9b49b46bbe71d414feb35db2be278586:/docs/latex/wx/strmbase.tex diff --git a/docs/latex/wx/strmbase.tex b/docs/latex/wx/strmbase.tex index 7876d607b5..4daa4ceb09 100644 --- a/docs/latex/wx/strmbase.tex +++ b/docs/latex/wx/strmbase.tex @@ -3,6 +3,9 @@ % ----------------------------------------------------------------------------- \section{\class{wxStreamBase}}\label{wxstreambase} +This class is the base class of most stream related classes in wxWindows. It must +not be used directly. + \wxheading{Derived from} None @@ -36,39 +39,50 @@ Creates a dummy stream object. It doesn't do anything. 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. + \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}} -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. \membersection{wxStreamBase::OnSysSeek} \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} \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} @@ -76,19 +90,15 @@ real position in the stream. 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 -the file). +the file. \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.