GIO Reference Manual | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
#include <gio/gio.h> GBufferedOutputStream; GOutputStream* g_buffered_output_stream_new (GOutputStream *base_stream); GOutputStream* g_buffered_output_stream_new_sized (GOutputStream *base_stream, gsize size); gsize g_buffered_output_stream_get_buffer_size (GBufferedOutputStream *stream); void g_buffered_output_stream_set_buffer_size (GBufferedOutputStream *stream, gsize size); gboolean g_buffered_output_stream_get_auto_grow (GBufferedOutputStream *stream); void g_buffered_output_stream_set_auto_grow (GBufferedOutputStream *stream, gboolean auto_grow);
Buffered output stream implements GFilterOutputStream and provides for buffered writes.
By default, GBufferedOutputStream's buffer size is set at 4 kilobytes.
To create a buffered output stream, use g_buffered_output_stream_new()
,
or g_buffered_output_stream_new_sized()
to specify the buffer's size
at construction.
To get the size of a buffer within a buffered input stream, use
g_buffered_output_stream_get_buffer_size()
. To change the size of a
buffered output stream's buffer, use
g_buffered_output_stream_set_buffer_size()
. Note that the buffer's
size cannot be reduced below the size of the data within the buffer.
typedef struct _GBufferedOutputStream GBufferedOutputStream;
An implementation of GFilterOutputStream with a sized buffer.
GOutputStream* g_buffered_output_stream_new (GOutputStream *base_stream);
Creates a new buffered output stream for a base stream.
|
a GOutputStream. |
Returns : |
a GOutputStream for the given base_stream .
|
GOutputStream* g_buffered_output_stream_new_sized (GOutputStream *base_stream, gsize size);
Creates a new buffered output stream with a given buffer size.
|
a GOutputStream. |
|
a gsize. |
Returns : |
a GOutputStream with an internal buffer set to size .
|
gsize g_buffered_output_stream_get_buffer_size (GBufferedOutputStream *stream);
Gets the size of the buffer in the stream
.
|
a GBufferedOutputStream. |
Returns : |
the current size of the buffer. |
void g_buffered_output_stream_set_buffer_size (GBufferedOutputStream *stream, gsize size);
Sets the size of the internal buffer to size
.
|
a GBufferedOutputStream. |
|
a gsize. |
gboolean g_buffered_output_stream_get_auto_grow (GBufferedOutputStream *stream);
Checks if the buffer automatically grows as data is added.
|
a GBufferedOutputStream. |
Returns : |
TRUE if the stream 's buffer automatically grows,
FALSE otherwise.
|
void g_buffered_output_stream_set_auto_grow (GBufferedOutputStream *stream, gboolean auto_grow);
Sets whether or not the stream
's buffer should automatically grow.
If auto_grow
is true, then each write will just make the buffer
larger, and you must manually flush the buffer to actually write out
the data to the underlying stream.
|
a GBufferedOutputStream. |
|
a gboolean. |