projects / wxWidgets.git / blame
| Commit | Line | Data |
|---|---|---|
| e2a6f233 JS |
1 | % ----------------------------------------------------------------------------- |
| 2 | % wxInputStream | |
| 3 | % ----------------------------------------------------------------------------- | |
| 4 | \section{\class{wxInputStream}}\label{wxinputstream} | |
| 5 | ||
| 6 | \wxheading{Derived from} | |
| 7 | ||
| 8 | \helpref{wxStreamBase}{wxstreambase} | |
| 9 | ||
| 10 | \wxheading{See also} | |
| 11 | ||
| 12 | \helpref{wxStreamBuffer}{wxstreambuffer} | |
| 13 | ||
| 14 | % ----------- | |
| 15 | % ctor & dtor | |
| 16 | % ----------- | |
| 17 | \membersection{wxInputStream::wxInputStream} | |
| 18 | ||
| 19 | \func{}{wxInputStream}{\void} | |
| 20 | ||
| 21 | Creates a dummy input stream. | |
| 22 | ||
| 23 | \func{}{wxInputStream}{\param{wxStreamBuffer *}{sbuf}} | |
| 24 | ||
| 25 | Creates an input stream using the specified stream buffer \it{sbuf}. This | |
| 26 | stream buffer can point to another stream. | |
| 27 | ||
| 28 | \membersection{wxInputStream::\destruct{wxInputStream}} | |
| 29 | ||
| 30 | \func{}{\destruct{wxInputStream}}{\void} | |
| 31 | ||
| 32 | Destructor. | |
| 33 | ||
| 34 | % ----------- | |
| 35 | % IO function | |
| 36 | % ----------- | |
| 37 | \membersection{wxInputStream::Peek} | |
| 38 | ||
| 39 | \func{char}{Peek}{\void} | |
| 40 | ||
| 41 | Returns the first character in the input queue without removing it. | |
| 42 | ||
| 43 | \membersection{wxInputStream::GetC} | |
| 44 | ||
| 45 | \func{char}{GetC}{\void} | |
| 46 | ||
| 47 | Returns the first character in the input queue and removes it. | |
| 48 | ||
| 49 | \membersection{wxInputStream::Read} | |
| 50 | ||
| 51 | \func{wxInputStream\&}{Read}{\param{void *}{buffer}, \param{size_t}{ size}} | |
| 52 | ||
| 53 | Reads the specified amount of bytes and stores the data in \it{buffer}. | |
| 54 | ||
| da3aea64 GL |
55 | \wxheading{Warning} |
| 56 | ||
| 57 | The buffer absolutely needs to have at least the specified size. | |
| 58 | ||
| 59 | \wxheading{Return value} | |
| e2a6f233 JS |
60 | |
| 61 | This function returns a reference on the current object, so the user can test | |
| 62 | any states of the stream right away. | |
| 63 | ||
| 64 | \func{wxInputStream\&}{Read}{\param{wxOutputStream\&}{ stream_out}} | |
| 65 | ||
| 66 | Reads data from the input queue and stores it in the specified output stream. | |
| 67 | The data is read until an error is raised by one of the two streams. | |
| 68 | ||
| da3aea64 GL |
69 | \wxheading{Return value} |
| 70 | ||
| 71 | This function returns a reference on the current object, so the user can test | |
| 72 | any states of the stream right away. | |
| 73 | ||
| e2a6f233 JS |
74 | % ------------------ |
| 75 | % Position functions | |
| 76 | % ------------------ | |
| 77 | \membersection{wxInputStream::SeekI} | |
| 78 | ||
| 79 | \func{off_t}{SeekI}{\param{off_t}{ pos}, \param{wxSeekMode}{ mode = wxFromStart}} | |
| 80 | ||
| 81 | Changes the stream current position. | |
| 82 | ||
| 83 | \membersection{wxInputStream::TellI} | |
| 84 | ||
| 85 | \constfunc{off_t}{TellI}{\void} | |
| 86 | ||
| 87 | Returns the current stream position. | |
| 88 | ||
| 89 | % --------------- | |
| 90 | % State functions | |
| 91 | % --------------- | |
| 92 | \membersection{wxInputStream::InputStreamBuffer} | |
| 93 | ||
| 94 | \func{wxStreamBuffer*}{InputStreamBuffer}{\void} | |
| 95 | ||
| 96 | Returns the stream buffer associated with the input stream. | |
| 97 | ||
| 98 | \membersection{wxInputStream::LastRead} | |
| 99 | ||
| 100 | \constfunc{size_t}{LastRead}{\void} | |
| 101 | ||
| 102 | Returns the last number of bytes read. | |
| 103 |