X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/fa482912e420a40e9f2e55a0f5407562826dd15e..74c481d11721fb42343c6b79996478a2ebacde3a:/docs/latex/wx/outptstr.tex diff --git a/docs/latex/wx/outptstr.tex b/docs/latex/wx/outptstr.tex index 0eb87f886e..b808b05054 100644 --- a/docs/latex/wx/outptstr.tex +++ b/docs/latex/wx/outptstr.tex @@ -18,23 +18,29 @@ wxOutputStream is an abstract base class which may not be used directly. % ----------- % ctor & dtor % ----------- + \membersection{wxOutputStream::wxOutputStream} \func{}{wxOutputStream}{\void} Creates a dummy wxOutputStream object. + \membersection{wxOutputStream::\destruct{wxOutputStream}} \func{}{\destruct{wxOutputStream}}{\void} Destructor. -\membersection{wxOutputStream::LastWrite} + +\membersection{wxOutputStream::LastWrite}\label{wxoutputstreamlastwrite} \constfunc{size\_t}{LastWrite}{\void} -Returns the number of bytes written during the last Write(). +Returns the number of bytes written during the last +\helpref{Write()}{wxoutputstreamwrite}. It may return $0$ even if there is no +error on the stream if it is only temporarily impossible to write to it. + \membersection{wxOutputStream::PutC} @@ -43,24 +49,41 @@ Returns the number of bytes written during the last Write(). Puts the specified character in the output queue and increments the stream position. -\membersection{wxOutputStream::SeekO} -\func{off\_t}{SeekO}{\param{off\_t}{ pos}, \param{wxSeekMode}{ mode}} +\membersection{wxOutputStream::SeekO}\label{wxoutputstreamseeko} + +\func{off\_t}{SeekO}{\param{off\_t}{ pos}, \param{wxSeekMode}{ mode = wxFromStart}} Changes the stream current position. +\wxheading{Parameters} + +\docparam{pos}{Offset to seek to.} + +\docparam{mode}{One of {\bf wxFromStart}, {\bf wxFromEnd}, {\bf wxFromCurrent}.} + +\wxheading{Return value} + +The new stream position or wxInvalidOffset on error. + + \membersection{wxOutputStream::TellO} \constfunc{off\_t}{TellO}{\void} Returns the current stream position. -\membersection{wxOutputStream::Write} + +\membersection{wxOutputStream::Write}\label{wxoutputstreamwrite} \func{wxOutputStream\&}{Write}{\param{const void *}{buffer}, \param{size\_t}{ size}} -Writes the specified amount of bytes using the data of {\it buffer}. -{\it WARNING!} The buffer absolutely needs to have at least the specified size. +Writes up to the specified amount of bytes using the data of {\it buffer}. Note +that not all data can always be written so you must check the number of bytes +really written to the stream using \helpref{LastWrite()}{wxoutputstreamlastwrite} +when this function returns. In some cases (for example a write end of a pipe +which is currently full) it is even possible that there is no errors and zero +bytes have been written. This function returns a reference on the current object, so the user can test any states of the stream right away.