![]() |
![]() |
![]() |
Camel Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
struct CamelStream; ssize_t camel_stream_read (CamelStream *stream, char *buffer, size_t n); ssize_t camel_stream_write (CamelStream *stream, const char *buffer, size_t n); int camel_stream_flush (CamelStream *stream); int camel_stream_close (CamelStream *stream); gboolean camel_stream_eos (CamelStream *stream); int camel_stream_reset (CamelStream *stream); ssize_t camel_stream_write_string (CamelStream *stream, const char *string); ssize_t camel_stream_printf (CamelStream *stream, const char *fmt, ...); ssize_t camel_stream_vprintf (CamelStream *stream, const char *fmt, va_list ap); ssize_t camel_stream_write_to_stream (CamelStream *stream, CamelStream *output_stream);
ssize_t camel_stream_read (CamelStream *stream, char *buffer, size_t n);
Attempts to read up to len
bytes from stream
into buf
.
|
a CamelStream object. |
|
output buffer |
|
max number of bytes to read. |
Returns : |
the number of bytes actually read, or -1 on error and set
errno.
|
ssize_t camel_stream_write (CamelStream *stream, const char *buffer, size_t n);
Attempts to write up to n
bytes of buffer
into stream
.
|
a CamelStream object |
|
buffer to write. |
|
number of bytes to write |
Returns : |
the number of bytes written to the stream, or -1 on error
along with setting errno.
|
int camel_stream_flush (CamelStream *stream);
Flushes any buffered data to the stream's backing store. Only meaningful for writable streams.
|
a CamelStream object |
Returns : |
%0 on success or -1 on fail along with setting errno.
|
int camel_stream_close (CamelStream *stream);
Closes the stream.
|
a CamelStream object |
Returns : |
%0 on success or -1 on error.
|
gboolean camel_stream_eos (CamelStream *stream);
Tests if there are bytes left to read on the stream
object.
|
a CamelStream object |
Returns : |
%TRUE on EOS or FALSE otherwise.
|
int camel_stream_reset (CamelStream *stream);
Resets the stream. That is, put it in a state where it can be read from the beginning again. Not all streams in Camel are seekable, but they must all be resettable.
|
a CamelStream object |
Returns : |
%0 on success or -1 on error along with setting errno.
|
ssize_t camel_stream_write_string (CamelStream *stream, const char *string);
Writes the string to the stream.
|
a CamelStream object |
|
a string |
Returns : |
the number of characters written or -1 on error.
|
ssize_t camel_stream_printf (CamelStream *stream, const char *fmt, ...);
Write formatted output to a stream.
|
a CamelStream object |
|
a printf-style format string |
|
|
Returns : |
the number of characters written or -1 on error.
|
ssize_t camel_stream_vprintf (CamelStream *stream, const char *fmt, va_list ap);
|
|
|
|
|
|
Returns : |
ssize_t camel_stream_write_to_stream (CamelStream *stream, CamelStream *output_stream);
Write all of a stream (until eos) into another stream, in a blocking fashion.
|
source CamelStream object |
|
destination CamelStream object |
Returns : |
%-1 on error, or the number of bytes succesfully copied across streams. |