X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/954b8ae60391d18b87a604e7919c87c0c6ae208b..c266eff98c5e44012647f54f38a1e29ecabd8759:/docs/latex/wx/strmmem.tex diff --git a/docs/latex/wx/strmmem.tex b/docs/latex/wx/strmmem.tex index f22a4bdaa0..ec70a884fb 100644 --- a/docs/latex/wx/strmmem.tex +++ b/docs/latex/wx/strmmem.tex @@ -5,45 +5,62 @@ \wxheading{Derived from} -\helpref{wxInputStream}{wxinputstream} +\helpref{wxInputStream}{wxinputstream}\\ +\helpref{wxStreamBase}{wxstreambase} \wxheading{Include files} -\wxheading{See also} - -\helpref{wxStreamBuffer}{wxstreamBuffer} +\wxheading{Library} -\wxheading{Remark} +\helpref{wxBase}{librarieslist} -You can create a similar stream by this way: - -\begin{verbatim} - wxStreamBuffer *sb = new wxStreamBuffer(wxStreamBuffer::read); - wxInputStream *input = new wxInputStream(sb); +\wxheading{See also} - sb->SetBufferIO(data, data\_end); -\end{verbatim} +\helpref{wxStreamBuffer}{wxstreambuffer}, \helpref{wxMemoryOutputStream}{wxmemoutputstream} % ---------- % Members % ---------- \latexignore{\rtfignore{\wxheading{Members}}} -\membersection{wxMemoryInputStream::wxMemoryInputStream} +\membersection{wxMemoryInputStream::wxMemoryInputStream}\label{wxmemoryinputstreamctor} \func{}{wxMemoryInputStream}{\param{const char *}{ data}, \param{size\_t}{ len}} Initializes a new read-only memory stream which will use the specified buffer -\it{data} of length \it{len}. +{\it data} of length {\it len}. The stream does not take ownership of the +buffer, i.e. the buffer will not be deleted in its destructor. + +\func{}{wxMemoryInputStream}{\param{const wxMemoryOutputStream&}{ stream}} + +Creates a new read-only memory stream, initializing it with the +data from the given output stream \arg{stream}. + +\func{}{wxMemoryInputStream}{\param{wxInputStream\&}{ stream}, \param{wxFileOffset}{ len = wxInvalidOffset}} -\membersection{wxMemoryInputStream::\destruct{wxMemoryInputStream}} +Creates a new read-only memory stream, initializing it with the +data from the given input stream \arg{stream}. -\func{}{\destruct{wxFileInputStream}}{\void} +The \arg{len} argument specifies the amount of data to read from +the \arg{stream}. Setting it to {\it wxInvalidOffset} means that +the \arg{stream} is to be read entirely (i.e. till the EOF is reached). + + +\membersection{wxMemoryInputStream::\destruct{wxMemoryInputStream}}\label{wxmemoryinputstreamdtor} + +\func{}{\destruct{wxMemoryInputStream}}{\void} Destructor. +\membersection{wxMemoryInputStream::GetInputStreamBuffer}\label{wxmemoryinputstreamgetistrmbuf} + +\constfunc{wxStreamBuffer *}{GetInputStreamBuffer}{\void} + +Returns the pointer to the stream object used as an internal buffer +for that stream. + % ----------------------------------------------------------------------------- % wxMemoryOutputStream % ----------------------------------------------------------------------------- @@ -51,63 +68,61 @@ Destructor. \wxheading{Derived from} -\helpref{wxOutputStream}{wxoutputstream} +\helpref{wxOutputStream}{wxoutputstream}\\ +\helpref{wxStreamBase}{wxstreambase} \wxheading{Include files} -\wxheading{See also} - -\helpref{wxStreamBuffer}{wxstreamBuffer} - -\wxheading{Remark} - -You can create a similar stream by this way: - -\begin{verbatim} - wxStreamBuffer *sb = new wxStreamBuffer(wxStreamBuffer::write); - wxOutputStream *input = new wxOutputStream(sb); +\wxheading{Library} - // If there are data - sb->SetBufferIO(data, data\_end); - // Else - sb->Fixed(FALSE); -\end{verbatim} +\helpref{wxBase}{librarieslist} -This way is also useful to create read/write memory stream: - -\begin{verbatim} - wxStreamBuffer *sb = new wxStreamBuffer(wxStreamBuffer::read\_write); - wxOutputStream *output = new wxOutputStream(sb); - wxInputStream *input = new wxInputStream(sb); +\wxheading{See also} - // If there are data - sb->SetBufferIO(data, data\_end); - // Else - sb->Fixed(FALSE); -\end{verbatim} +\helpref{wxStreamBuffer}{wxstreambuffer} % ---------- % Members % ---------- \latexignore{\rtfignore{\wxheading{Members}}} -\membersection{wxMemoryOutputStream::wxMemoryOutputStream} +\membersection{wxMemoryOutputStream::wxMemoryOutputStream}\label{wxmemoryoutputstreamctor} \func{}{wxMemoryOutputStream}{\param{char *}{ data = NULL}, \param{size\_t}{ length = 0}} -If \it{data} is NULL, then it will initialize a new empty buffer which will -grow when it needs. +If {\it data} is NULL, then it will initialize a new empty buffer which will +grow if required. \wxheading{Warning} If the buffer is created, it will be destroyed at the destruction of the stream. -\membersection{wxMemoryOutputStream::\destruct{wxMemoryOutputStream}} +\membersection{wxMemoryOutputStream::\destruct{wxMemoryOutputStream}}\label{wxmemoryoutputstreamdtor} \func{}{\destruct{wxMemoryOutputStream}}{\void} Destructor. +\membersection{wxMemoryOutputStream::CopyTo}\label{wxmemoryoutputstreamcopyto} + +\constfunc{size\_t}{CopyTo}{\param{char *}{buffer}, \param{size\_t }{len}} + +CopyTo allowed you to transfer data from the internal buffer of +wxMemoryOutputStream to an external buffer. {\it len} specifies the size of +the buffer. + +\wxheading{Returned value} + +CopyTo returns the number of bytes copied to the buffer. Generally it is either +len or the size of the stream buffer. + +\membersection{wxMemoryOutputStream::GetOutputStreamBuffer}\label{wxmemoryoutputstreamgetostrmbuf} + +\constfunc{wxStreamBuffer *}{GetOutputStreamBuffer}{\void} + +Returns the pointer to the stream object used as an internal buffer +for that stream. +