]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/strmmem.tex
Some work on GTK focus handling and events.
[wxWidgets.git] / docs / latex / wx / strmmem.tex
index 194478288e9e47e24f0cb18119c998cc5a3304e0..920ad7b36e3b181bd62181e33374f0fddbcfaee0 100644 (file)
@@ -7,20 +7,13 @@
 
 \helpref{wxInputStream}{wxinputstream}
 
-\wxheading{See also}
-
-\helpref{wxStreamBuffer}{wxstreamBuffer}
+\wxheading{Include files}
 
-\wxheading{Remark}
+<wx/mstream.h>
 
-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
@@ -32,11 +25,12 @@ You can create a similar stream by this way:
 \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. that it will not delete in its destructor.
 
 \membersection{wxMemoryInputStream::\destruct{wxMemoryInputStream}}
 
-\func{}{\destruct{wxFileInputStream}}{\void}
+\func{}{\destruct{wxMemoryInputStream}}{\void}
 
 Destructor.
 
@@ -49,36 +43,13 @@ Destructor.
 
 \helpref{wxOutputStream}{wxoutputstream}
 
-\wxheading{See also}
-
-\helpref{wxStreamBuffer}{wxstreamBuffer}
-
-\wxheading{Remark}
-
-You can create a similar stream by this way:
+\wxheading{Include files}
 
-\begin{verbatim}
-  wxStreamBuffer *sb = new wxStreamBuffer(wxStreamBuffer::write);
-  wxOutputStream *input = new wxOutputStream(sb);
+<wx/mstream.h>
 
-  // If there are data
-    sb->SetBufferIO(data, data\_end);
-  // Else
-    sb->Fixed(FALSE);
-\end{verbatim}
-
-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
@@ -89,8 +60,8 @@ This way is also useful to create read/write memory stream:
 
 \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}
 
@@ -103,3 +74,16 @@ stream.
 
 Destructor.
 
+\membersection{wxMemoryOutputStream::CopyTo}
+
+\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.
+