glibmm: Glib::ByteArray Class Reference

ByteArray - Arrays of bytes. More...

#include <glibmm/bytearray.h>

Public Types

using SlotCompare = sigc::slot< int(const guint8*, const guint8*)>
 A Slot type to compare two elements in the array. More...

 

Public Member Functions

void reference () const
 Increment the reference count for this object. More...

 
void unreference () const
 Decrement the reference count for this object. More...

 
GByteArray* gobj ()
 Provides access to the underlying C instance. More...

 
const GByteArray* gobj () const
 Provides access to the underlying C instance. More...

 
GByteArray* gobj_copy () const
 Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More...

 
 ByteArray ()=delete
 
 ByteArray (const ByteArray&)=delete
 
ByteArrayoperator= (const ByteArray&)=delete
 
Glib::RefPtr< ByteArrayappend (const guint8* data, guint len)
 Adds the given bytes to the end of the ByteArray. More...

 
Glib::RefPtr< ByteArrayprepend (const guint8* data, guint len)
 Adds the given data to the start of the ByteArray. More...

 
guint size () const
 Gets the size of the byte array. More...

 
guint8* get_data ()
 Gets the data of the byte array. More...

 
const guint8* get_data () const
 Gets the data of the byte array. More...

 
Glib::RefPtr< ByteArrayremove_index (guint index)
 Removes the byte at the given index from a ByteArray. More...

 
Glib::RefPtr< ByteArrayremove_index_fast (guint index)
 Removes the byte at the given index from a ByteArray. More...

 
Glib::RefPtr< ByteArrayremove_range (guint index, guint length)
 Removes the given number of bytes starting at the given index from a ByteArray. More...

 
void sort (const SlotCompare& slot)
 Like g_byte_array_sort(), but the comparison function takes an extra user data argument. More...

 
Glib::RefPtr< ByteArrayset_size (guint length)
 Sets the size of the ByteArray, expanding it if necessary. More...

 

Static Public Member Functions

static GType get_type ()
 Get the GType for this class, for use with the underlying GObject type system. More...

 
static Glib::RefPtr< ByteArraycreate ()
 Creates a new ByteArray with a reference count of 1. More...

 

Protected Member Functions

void operator delete (void*, std::size_t)
 

Related Functions

(Note that these are not member functions.)

Glib::RefPtr< Glib::ByteArraywrap (GByteArray* object, bool take_copy=false)
 A Glib::wrap() method for this object. More...

 

Detailed Description

ByteArray - Arrays of bytes.

ByteArray is a mutable array of bytes, to provide arrays of bytes which grow automatically as elements are added.

To create a new ByteArray use create(). To add elements to a ByteArray, use append(), and prepend().

To set the size of a ByteArray, use set_size().

Since glibmm 2.36:

Member Typedef Documentation

using Glib::ByteArray::SlotCompare = sigc::slot<int(const guint8*, const guint8*)>

A Slot type to compare two elements in the array.

The slot should return -1 if the first value is less than the second, 0 if they are equal and 1 if the first value is greater than the second.

Slot Prototype:

int compare(const guint8* first, const guint8* second);

Constructor & Destructor Documentation

Glib::ByteArray::ByteArray ( )
delete
Glib::ByteArray::ByteArray ( const ByteArray )
delete

Member Function Documentation

Glib::RefPtr<ByteArray> Glib::ByteArray::append ( const guint8 *  data,
guint  len 
)

Adds the given bytes to the end of the ByteArray.

The array will grow in size automatically if necessary.

Parameters
dataThe byte data to be added.
lenThe number of bytes to add.
Returns
The ByteArray.
static Glib::RefPtr<ByteArray> Glib::ByteArray::create ( )
static

Creates a new ByteArray with a reference count of 1.

Returns
The new ByteArray.
guint8* Glib::ByteArray::get_data ( )

Gets the data of the byte array.

Returns
The data.
Since glibmm 2.36:
const guint8* Glib::ByteArray::get_data ( ) const

Gets the data of the byte array.

Returns
The data.
Since glibmm 2.36:
static GType Glib::ByteArray::get_type ( )
static

Get the GType for this class, for use with the underlying GObject type system.

GByteArray* Glib::ByteArray::gobj ( )

Provides access to the underlying C instance.

const GByteArray* Glib::ByteArray::gobj ( ) const

Provides access to the underlying C instance.

GByteArray* Glib::ByteArray::gobj_copy ( ) const

Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.

void Glib::ByteArray::operator delete ( void *  ,
std::size_t   
)
protected
ByteArray& Glib::ByteArray::operator= ( const ByteArray )
delete
Glib::RefPtr<ByteArray> Glib::ByteArray::prepend ( const guint8 *  data,
guint  len 
)

Adds the given data to the start of the ByteArray.

The array will grow in size automatically if necessary.

Parameters
dataThe byte data to be added.
lenThe number of bytes to add.
Returns
The ByteArray.
void Glib::ByteArray::reference ( ) const

Increment the reference count for this object.

You should never need to do this manually - use the object via a RefPtr instead.

Glib::RefPtr<ByteArray> Glib::ByteArray::remove_index ( guint  index)

Removes the byte at the given index from a ByteArray.

The following bytes are moved down one place.

Parameters
indexThe index of the byte to remove.
Returns
The ByteArray.
Glib::RefPtr<ByteArray> Glib::ByteArray::remove_index_fast ( guint  index)

Removes the byte at the given index from a ByteArray.

The last element in the array is used to fill in the space, so this function does not preserve the order of the ByteArray. But it is faster than g_byte_array_remove_index().

Parameters
indexThe index of the byte to remove.
Returns
The ByteArray.
Glib::RefPtr<ByteArray> Glib::ByteArray::remove_range ( guint  index,
guint  length 
)

Removes the given number of bytes starting at the given index from a ByteArray.

The following elements are moved to close the gap.

Since glibmm 2.4:
Parameters
indexThe index of the first byte to remove.
lengthThe number of bytes to remove.
Returns
The ByteArray.
Glib::RefPtr<ByteArray> Glib::ByteArray::set_size ( guint  length)

Sets the size of the ByteArray, expanding it if necessary.

Parameters
lengthThe new size of the ByteArray.
Returns
The ByteArray.
guint Glib::ByteArray::size ( ) const

Gets the size of the byte array.

Returns
The size.
Since glibmm 2.36:
void Glib::ByteArray::sort ( const SlotCompare slot)

Like g_byte_array_sort(), but the comparison function takes an extra user data argument.

Parameters
slotComparison function.
void Glib::ByteArray::unreference ( ) const

Decrement the reference count for this object.

You should never need to do this manually - use the object via a RefPtr instead.

Friends And Related Function Documentation

Glib::RefPtr< Glib::ByteArray > wrap ( GByteArray *  object,
bool  take_copy = false 
)
related

A Glib::wrap() method for this object.

Parameters
objectThe C instance.
take_copyFalse if the result should take ownership of the C instance. True if it should take a new copy or ref.
Returns
A C++ instance that wraps this C instance.