![]() |
![]() |
![]() |
Camel Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
struct CamelStreamMem; CamelStream * camel_stream_mem_new (void); CamelStream * camel_stream_mem_new_with_byte_array (GByteArray *buffer); CamelStream * camel_stream_mem_new_with_buffer (const char *buffer, size_t len); void camel_stream_mem_set_secure (CamelStreamMem *mem); void camel_stream_mem_set_byte_array (CamelStreamMem *mem, GByteArray *buffer); void camel_stream_mem_set_buffer (CamelStreamMem *mem, const char *buffer, size_t len);
struct CamelStreamMem { CamelSeekableStream parent_object; unsigned int owner:1; /* do we own the buffer? */ unsigned int secure:1; /* do we clear the buffer on finalise (if we own it) */ GByteArray *buffer; };
CamelStream * camel_stream_mem_new (void);
Create a new CamelStreamMem object.
Returns : |
a new CamelStreamMem |
CamelStream * camel_stream_mem_new_with_byte_array (GByteArray *buffer);
Create a new CamelStreamMem using buffer
as the stream data.
Note: The newly created CamelStreamMem will destroy buffer
when destroyed.
|
a GByteArray to use as the stream data |
Returns : |
a new CamelStreamMem |
CamelStream * camel_stream_mem_new_with_buffer (const char *buffer, size_t len);
Create a new memory stream using buffer
as the stream data.
Note: buffer
will be copied into an internal GByteArray structure
for use as the stream backing. This may have resource implications
you may wish to consider.
|
a memory buffer to use as the stream data |
|
length of buffer
|
Returns : |
a new CamelStreamMem |
void camel_stream_mem_set_secure (CamelStreamMem *mem);
Mark the memory stream as secure. At the very least this means the data in the buffer will be cleared when the buffer is finalised. This only applies to buffers owned by the stream.
|
a CamelStreamMem object |
void camel_stream_mem_set_byte_array (CamelStreamMem *mem, GByteArray *buffer);
Set buffer
to be the backing data to the existing CamelStreamMem, mem
.
Note: mem
will not take ownership of buffer
and so will need to
be freed separately from mem
.
|
a CamelStreamMem object |
|
a GByteArray |
void camel_stream_mem_set_buffer (CamelStreamMem *mem, const char *buffer, size_t len);
Set buffer
to be the backing data to the existing CamelStreamMem, mem
.
Note: buffer
will be copied into an internal GByteArray structure
and so may have resource implications to consider.
|
a CamelStreamMem object |
|
a memory buffer |
|
length of buffer
|