added wxMemoryFSHandler docs

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

diff --git a/docs/latex/wx/strmbase.tex b/docs/latex/wx/strmbase.tex
index cfd0d3bfdded070db7e3bd964e21353c4bce7923..1bcd9ec56b900c96dc45954a97e596c77260d057 100644 (file)
--- a/docs/latex/wx/strmbase.tex
+++ b/docs/latex/wx/strmbase.tex
@@ -3,10 +3,17 @@
 % -----------------------------------------------------------------------------
 \section{\class{wxStreamBase}}\label{wxstreambase}
 
 % -----------------------------------------------------------------------------
 \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
 
 \wxheading{Derived from}
 
 None
 

+\wxheading{Include files}
+
+<wx/stream.h>
+

 \wxheading{See also}
 
 \helpref{wxStreamBuffer}{wxstreambuffer}
 \wxheading{See also}
 
 \helpref{wxStreamBuffer}{wxstreambuffer}


@@ -24,7 +31,7 @@ None
 
 \func{}{wxStreamBase}{\void}
 
 
 \func{}{wxStreamBase}{\void}
 

-Creates a dummy stream object.
+Creates a dummy stream object. It doesn't do anything.

 
 \membersection{wxStreamBase::\destruct{wxStreamBase}}
 
 
 \membersection{wxStreamBase::\destruct{wxStreamBase}}
 


@@ -37,109 +44,54 @@ Destructor.
 \constfunc{wxStreamError}{LastError}{\void}
 
 This function returns the last error.
 \constfunc{wxStreamError}{LastError}{\void}
 
 This function returns the last error.

-It is of the form:
-\twocolwidtha{7cm}%
+\twocolwidtha{5cm}

 \begin{twocollist}\itemsep=0pt
 \begin{twocollist}\itemsep=0pt

-\twocolitem{{\bf wxStream_NOERROR}}{No error occured.}
-\twocolitem{{\bf wxStream_EOF}}{An End Of File exception occured.}
-\twocolitem{{\bf wxStream_WRITE_ERR}{Error during the last write call.}
-\twocolitem{{\bf wxStream_READ_ERR}{Error during the last read call.}
-\end{twocollist}%
-
-\membersection{wxStreamBase::StreamSize}
-\constfunc{size_t}{StreamSize}{\void}
-
-This function returns the size of the stream. For example, for a file it is the size of
-the file). Warning! There are streams which do not have size by definition, such as a socket.
+\twocolitem{{\bf wxSTREAM\_NO\_ERROR}}{No error occured.}
+\twocolitem{{\bf wxSTREAM\_EOF}}{An End-Of-File occured.}
+\twocolitem{{\bf wxSTREAM\_WRITE\_ERROR}}{A generic error occured on the last write call.}
+\twocolitem{{\bf wxSTREAM\_READ\_ERROR}}{A generic error occured on the last read call.}
+\end{twocollist}

 
 \membersection{wxStreamBase::OnSysRead}\label{wxstreambaseonsysread}
 
 
 \membersection{wxStreamBase::OnSysRead}\label{wxstreambaseonsysread}
 

-\func{size_t}{OnSysRead}{\param{void*}{ buffer}, \param{size_t}{ bufsize}}
+\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::OnSysWrite}
-
-\func{size_t}{OnSysWrite}{\param{void *}{buffer}, \param{size_t}{ bufsize}}
-
-See \helpref{OnSysRead}{wxstreambaseonsysread}.
-

 \membersection{wxStreamBase::OnSysSeek}
 
 \membersection{wxStreamBase::OnSysSeek}
 

-\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}
 

-\constfunc{off_t}{OnSysTell}{\void}
-
-Internal function. Is is called when the stream buffer needs to know the
-current position in the stream.
-
-% -----------------------------------------------------------------------------
-% wxInputStream
-% -----------------------------------------------------------------------------
-\section{\class{wxInputStream}}\label{wxinputstream}
-
-\wxheading{Derived from}
-
-\helpref{wxStreamBase}{wxstreambase}
-
-\wxheading{See also}
-
-\helpref{wxStreamBuffer}{wxstreambuffer}
+\constfunc{off\_t}{OnSysTell}{\void}

 
 

-% -----------------------------------------------------------------------------
-% Members
-% -----------------------------------------------------------------------------
-\latexignore{\rtfignore{\wxheading{Members}}} 
+Internal function. Is is called when the stream needs to know the
+real position.

 
 

-% -----------
-% ctor & dtor
-% -----------
-
-\membersection{wxInputStream::wxInputStream}
-\func{}{wxInputStream}{\void}
-
-Initializes a dummy input stream.
-
-\func{}{wxInputStream}{\param{wxStreamBuffer *}{sbuf}}
-
-Initializes an input stream linked to the specified stream buffer.
-
-\membersection{wxInputStream::\destruct{wxInputStream}}
-\func{}{\destruct{wxInputStream}{\void}
+\membersection{wxStreamBase::OnSysWrite}

 
 

-Destructor.
+\func{size\_t}{OnSysWrite}{\param{void *}{buffer}, \param{size\_t}{ bufsize}}

 
 

-% -------
-% IO call
-% -------
+See \helpref{OnSysRead}{wxstreambaseonsysread}.

 
 

-\membersection{wxInputStream::Peek}
-\func{char}{Peek}{\void}
+\membersection{wxStreamBase::GetSize}\label{wxstreambasegetsize}

 
 

-\membersection{wxInputStream::GetC}
-\func{char}{GetC}{\void}
+\constfunc{size\_t}{GetSize}{\void}

 
 

-\membersection{wxInputStream::Read}
-\func{wxInputStream&}{Read}{\param{void *}{buffer}, \param{size_t}{ size}}
-\func{wxInputStream&}{Read}{\param{wxOutputStream&}{ stream_out}}
+This function returns the size of the stream. For example, for a file it is the size of
+the file).

 
 

-\membersection{wxInputStream::SeekI}
-\func{off_t}{SeekI}{\param{off_t}{ pos}, \param{wxSeekMode}{ mode = wxFromStart}}
+\wxheading{Warning}

 
 

-\membersection{wxInputStream::TellI}
-\constfunc{off_t}{TellI}{\void}
+There are streams which do not have size by definition, such as socket streams.
+In that cases, GetSize returns an invalid size represented by

 
 

-% -----
-% State
-% -----
-\membersection{wxInputStream::InputStreamBuffer}
-\func{wxStreamBuffer *}{InputStreamBuffer}{\void}
+\begin{verbatim}
+~(size_t)0
+\end{verbatim}

 
 

-\membersection{wxInputStream::LastRead}
-\func{size_t}{LastRead}{\void}