git.saurik.com Git - wxWidgets.git/blame_incremental

... / ...

Commit	Line	Data
	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