docs/latex/wx/strmbase.tex

   1 % -----------------------------------------------------------------------------
   2 % wxStreamBase
   3 % -----------------------------------------------------------------------------
   4 \section{\class{wxStreamBase}}\label{wxstreambase}
   5
   6 This class is the base class of most stream related classes in wxWindows. It must
   7 not be used directly.
   8
   9 \wxheading{Derived from}
  10
  11 None
  12
  13 \wxheading{Include files}
  14
  15 <wx/stream.h>
  16
  17 \wxheading{See also}
  18
  19 \helpref{wxStreamBuffer}{wxstreambuffer}
  20
  21 % -----------------------------------------------------------------------------
  22 % Members
  23 % -----------------------------------------------------------------------------
  24 \latexignore{\rtfignore{\wxheading{Members}}}
  25
  26 % -----------
  27 % ctor & dtor
  28 % -----------
  29
  30 \membersection{wxStreamBase::wxStreamBase}
  31
  32 \func{}{wxStreamBase}{\void}
  33
  34 Creates a dummy stream object. It doesn't do anything.
  35
  36 \membersection{wxStreamBase::\destruct{wxStreamBase}}
  37
  38 \func{}{\destruct{wxStreamBase}}{\void}
  39
  40 Destructor.
  41
  42 \membersection{wxStreamBase::IsOk}\label{wxstreambaseisok}
  43
  44 \constfunc{wxStreamError}{IsOk}{\void}
  45
  46 Returns TRUE if no error occured on the stream.
  47
  48 \wxheading{See also}
  49
  50 \helpref{LastError}{wxstreambaselasterror}
  51
  52 \membersection{wxStreamBase::LastError}\label{wxstreambaselasterror}
  53
  54 \constfunc{wxStreamError}{LastError}{\void}
  55
  56 This function returns the last error.
  57 \twocolwidtha{5cm}
  58 \begin{twocollist}\itemsep=0pt
  59 \twocolitem{{\bf wxSTREAM\_NO\_ERROR}}{No error occured.}
  60 \twocolitem{{\bf wxSTREAM\_EOF}}{An End-Of-File occured.}
  61 \twocolitem{{\bf wxSTREAM\_WRITE\_ERROR}}{A generic error occured on the last write call.}
  62 \twocolitem{{\bf wxSTREAM\_READ\_ERROR}}{A generic error occured on the last read call.}
  63 \end{twocollist}
  64
  65 \membersection{wxStreamBase::OnSysRead}\label{wxstreambaseonsysread}
  66
  67 \func{size\_t}{OnSysRead}{\param{void*}{ buffer}, \param{size\_t}{ bufsize}}
  68
  69 Internal function. It is called when the stream wants to read data of the
  70 specified size. It should return the size that was actually read.
  71
  72 \membersection{wxStreamBase::OnSysSeek}
  73
  74 \func{off\_t}{OnSysSeek}{\param{off\_t}{ pos}, \param{wxSeekMode}{ mode}}
  75
  76 Internal function. It is called when the stream needs to change the
  77 current position.
  78
  79 \membersection{wxStreamBase::OnSysTell}
  80
  81 \constfunc{off\_t}{OnSysTell}{\void}
  82
  83 Internal function. Is is called when the stream needs to know the
  84 real position.
  85
  86 \membersection{wxStreamBase::OnSysWrite}
  87
  88 \func{size\_t}{OnSysWrite}{\param{void *}{buffer}, \param{size\_t}{ bufsize}}
  89
  90 See \helpref{OnSysRead}{wxstreambaseonsysread}.
  91
  92 \membersection{wxStreamBase::GetSize}\label{wxstreambasegetsize}
  93
  94 \constfunc{size\_t}{GetSize}{\void}
  95
  96 This function returns the size of the stream. For example, for a file it is the size of
  97 the file.
  98
  99 \wxheading{Warning}
 100
 101 There are streams which do not have size by definition, such as socket streams.
 102 In that cases, GetSize returns an invalid size represented by
 103
 104 \begin{verbatim}
 105 ~(size_t)0
 106 \end{verbatim}
 107